Site checkin for project Apache James: Jenkins Tools
diff --git a/404.html b/404.html
index 3b992f4..9e59fe9 100644
--- a/404.html
+++ b/404.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Page Not Found :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="/_/css/site.css">
</head>
<body class="status-404">
@@ -67,22 +67,11 @@
<div class="nav-panel-explore is-active" data-panel="explore">
<ul class="components">
<li class="component">
- <div class="title"><a href="/james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="/james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
<div class="title"><a href="/james-project/3.8.1/index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-latest">
<a href="/james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="/james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
diff --git a/james-distributed-app/3.8.0/_images/BlobStore.png b/james-distributed-app/3.8.0/_images/BlobStore.png
deleted file mode 100644
index d964d2a..0000000
--- a/james-distributed-app/3.8.0/_images/BlobStore.png
+++ /dev/null
Binary files differ
diff --git a/james-distributed-app/3.8.0/_images/IMAP_board.png b/james-distributed-app/3.8.0/_images/IMAP_board.png
deleted file mode 100644
index 2c3e935..0000000
--- a/james-distributed-app/3.8.0/_images/IMAP_board.png
+++ /dev/null
Binary files differ
diff --git a/james-distributed-app/3.8.0/_images/JMAP_board.png b/james-distributed-app/3.8.0/_images/JMAP_board.png
deleted file mode 100644
index e97b021..0000000
--- a/james-distributed-app/3.8.0/_images/JMAP_board.png
+++ /dev/null
Binary files differ
diff --git a/james-distributed-app/3.8.0/_images/JVM_board.png b/james-distributed-app/3.8.0/_images/JVM_board.png
deleted file mode 100644
index 45f9463..0000000
--- a/james-distributed-app/3.8.0/_images/JVM_board.png
+++ /dev/null
Binary files differ
diff --git a/james-distributed-app/3.8.0/_images/MATCHER.png b/james-distributed-app/3.8.0/_images/MATCHER.png
deleted file mode 100644
index 4730e94..0000000
--- a/james-distributed-app/3.8.0/_images/MATCHER.png
+++ /dev/null
Binary files differ
diff --git a/james-distributed-app/3.8.0/_images/apache-james-lens.png b/james-distributed-app/3.8.0/_images/apache-james-lens.png
deleted file mode 100644
index e97507c..0000000
--- a/james-distributed-app/3.8.0/_images/apache-james-lens.png
+++ /dev/null
Binary files differ
diff --git a/james-distributed-app/3.8.0/_images/cassandra_stress_test_result_1.png b/james-distributed-app/3.8.0/_images/cassandra_stress_test_result_1.png
deleted file mode 100644
index b4ab9fa..0000000
--- a/james-distributed-app/3.8.0/_images/cassandra_stress_test_result_1.png
+++ /dev/null
Binary files differ
diff --git a/james-distributed-app/3.8.0/_images/cassandra_stress_test_result_2.png b/james-distributed-app/3.8.0/_images/cassandra_stress_test_result_2.png
deleted file mode 100644
index 189f602..0000000
--- a/james-distributed-app/3.8.0/_images/cassandra_stress_test_result_2.png
+++ /dev/null
Binary files differ
diff --git a/james-distributed-app/3.8.0/_images/james-hexagons-extensions.png b/james-distributed-app/3.8.0/_images/james-hexagons-extensions.png
deleted file mode 100644
index 6e228e2..0000000
--- a/james-distributed-app/3.8.0/_images/james-hexagons-extensions.png
+++ /dev/null
Binary files differ
diff --git a/james-distributed-app/3.8.0/_images/james-imap-base-performance.png b/james-distributed-app/3.8.0/_images/james-imap-base-performance.png
deleted file mode 100644
index 1caa11d..0000000
--- a/james-distributed-app/3.8.0/_images/james-imap-base-performance.png
+++ /dev/null
Binary files differ
diff --git a/james-distributed-app/3.8.0/_images/preload-dashboards.png b/james-distributed-app/3.8.0/_images/preload-dashboards.png
deleted file mode 100644
index 8ecc77f..0000000
--- a/james-distributed-app/3.8.0/_images/preload-dashboards.png
+++ /dev/null
Binary files differ
diff --git a/james-distributed-app/3.8.0/_images/remote-delivery-error-handling.png b/james-distributed-app/3.8.0/_images/remote-delivery-error-handling.png
deleted file mode 100644
index 7e0665a..0000000
--- a/james-distributed-app/3.8.0/_images/remote-delivery-error-handling.png
+++ /dev/null
Binary files differ
diff --git a/james-distributed-app/3.8.0/_images/server-components.png b/james-distributed-app/3.8.0/_images/server-components.png
deleted file mode 100644
index 30112d9..0000000
--- a/james-distributed-app/3.8.0/_images/server-components.png
+++ /dev/null
Binary files differ
diff --git a/james-distributed-app/3.8.0/_images/specialized-instances.png b/james-distributed-app/3.8.0/_images/specialized-instances.png
deleted file mode 100644
index 687cefe..0000000
--- a/james-distributed-app/3.8.0/_images/specialized-instances.png
+++ /dev/null
Binary files differ
diff --git a/james-distributed-app/3.8.0/_images/storage.png b/james-distributed-app/3.8.0/_images/storage.png
deleted file mode 100644
index d52322a..0000000
--- a/james-distributed-app/3.8.0/_images/storage.png
+++ /dev/null
Binary files differ
diff --git a/james-distributed-app/3.8.0/_images/webAdmin.png b/james-distributed-app/3.8.0/_images/webAdmin.png
deleted file mode 100644
index a0b88a9..0000000
--- a/james-distributed-app/3.8.0/_images/webAdmin.png
+++ /dev/null
Binary files differ
diff --git a/james-distributed-app/3.8.0/architecture/consistency-model.html b/james-distributed-app/3.8.0/architecture/consistency-model.html
deleted file mode 100644
index b492490..0000000
--- a/james-distributed-app/3.8.0/architecture/consistency-model.html
+++ /dev/null
@@ -1,592 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Consistency Model :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Architecture</a></li>
- <li><a href="consistency-model.html">Consistency Model</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/architecture/consistency-model.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Consistency Model</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This page presents the consistency model used by the Distributed Server and
-points to the tools built around it.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_data_replication"><a class="anchor" href="#_data_replication"></a>Data Replication</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The Distributed Server relies on different storage technologies, all having their own
-consistency models.</p>
-</div>
-<div class="paragraph">
-<p>These data stores replicate data in order to enforce some level of availability. We call
-this process replication. By consistency, we mean the ability for all replica to hold the
-same data. By availability, we mean the ability for a replica to answer a request.</p>
-</div>
-<div class="paragraph">
-<p>In distributed systems, <a href="https://en.wikipedia.org/wiki/CAP_theorem">according to the CAP theorem</a>,
-as we will necessarily encounter network partitions, then trade-offs need to be made between
-consistency and availability.</p>
-</div>
-<div class="paragraph">
-<p>This section details this trade-off for data stores used by the Distributed Server.</p>
-</div>
-<div class="sect2">
-<h3 id="_cassandra_consistency_model"><a class="anchor" href="#_cassandra_consistency_model"></a>Cassandra consistency model</h3>
-<div class="paragraph">
-<p><a href="https://cassandra.apache.org/">Cassandra</a> is an
-<a href="https://en.wikipedia.org/wiki/Eventual_consistency">eventually consistent</a> data store.
-This means that replica can hold diverging data, but are guaranteed to converge over time.</p>
-</div>
-<div class="paragraph">
-<p>Several mechanisms are built in Cassandra to enforce this convergence, and need to be
-leveraged by <strong>Distributed Server Administrator</strong>. Namely
-<a href="https://docs.datastax.com/en/dse/5.1/dse-admin/datastax_enterprise/tools/nodetool/toolsRepair.html">nodetool repair</a>,
-<a href="https://cassandra.apache.org/doc/latest/operating/hints.html">Hinted hand-off</a> and
-<a href="https://cassandra.apache.org/doc/latest/operating/read_repair.html">Read repair</a>.</p>
-</div>
-<div class="paragraph">
-<p>The Distributed Server tries to mitigate inconsistencies by relying on
-<a href="https://docs.datastax.com/en/archived/cassandra/3.0/cassandra/dml/dmlConfigConsistency.html">QUORUM</a> read and write levels.
-This means that a majority of replica are needed for read and write operations to be performed.</p>
-</div>
-<div class="paragraph">
-<p>Critical business operations, like UID allocation, rely on strong consistency mechanisms brought by
-<a href="https://www.datastax.com/blog/2013/07/lightweight-transactions-cassandra-20">lightweight transaction</a>.</p>
-</div>
-<div class="sect3">
-<h4 id="_about_multi_data_center_setups"><a class="anchor" href="#_about_multi_data_center_setups"></a>About multi data-center setups</h4>
-<div class="paragraph">
-<p>As strong consistency is required for some operation, especially regarding IMAP monotic UID and MODSEQ generation,
-and as lightweight transactions are slow across data centers, running James with a
-<a href="https://docs.datastax.com/en/ddac/doc/datastax_enterprise/production/DDACmultiDCperWorkloadType.html">multi data-center</a>
-Cassandra setup is discouraged.</p>
-</div>
-<div class="paragraph">
-<p>However, <a href="../configure/cassandra.html" class="xref page">this page</a> enables setting alternative read level,
-which could be acceptable regarding limited requirements. <code>LOCAL_QUORUM</code> coupled with <code>LOCAL_SERIAL</code>
-is likely the only scalable setup. Some options were added to turn off SERIAL consistency usage for message
-and mailbox management. However, the use of Lightweight Transaction cannot be disabled for UIDs and ModSeqs.</p>
-</div>
-<div class="paragraph">
-<p>Running the Distributed Server IMAP server in a multi datacenter setup will likely result either in data loss,
-or very slow operations - as we rely on monotic UID generation, without strong consistency, UIDs could be allocated
-several times.</p>
-</div>
-<div class="paragraph">
-<p>We did wire a multi-DC friendly distributed, POP3 only server that leverages acceptable performance while staying
-consistent. This is achieved by having a reduced feature set - supporting only the POP3 server and using messageIds as
-identifiers (generated without synchronisation using TimeUUIDs). You can find this application
-<a href="https://github.com/apache/james-project/tree/master/server/apps/distributed-pop3-app">on GitHub</a>. In the future,
-JMAP support could be added, but requires followup developments as some components critically depends on UIDs
-(for instance the search).</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_opensearch_consistency_model"><a class="anchor" href="#_opensearch_consistency_model"></a>OpenSearch consistency model</h3>
-<div class="paragraph">
-<p>OpenSearch relies on <a href="https://www.elastic.co/blog/a-new-era-for-cluster-coordination-in-elasticsearch">strong consistency</a>
-with home grown algorithm.</p>
-</div>
-<div class="paragraph">
-<p>The 6.x release line, that the distributed server is using is known to be slow to recover from failures.</p>
-</div>
-<div class="paragraph">
-<p>Be aware that data is asynchronously indexed in OpenSearch, changes will be eventually visible.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_rabbitmq_consistency_model"><a class="anchor" href="#_rabbitmq_consistency_model"></a>RabbitMQ consistency model</h3>
-<div class="paragraph">
-<p>The Distributed Server relies out of the box on a single RabbitMQ server, thus consistency concerns
-are not (yet) applicable. Availability concerns are applicable.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_denormalization"><a class="anchor" href="#_denormalization"></a>Denormalization</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>In Cassandra, data needs to be structured to match the read patterns. To support several conflicting
-read patterns, the data needs to be duplicated into different structures. This process is called
-denormalization.</p>
-</div>
-<div class="paragraph">
-<p>While data can be consistent at the table level, some inconsistencies can sneak in at the applicative
-level across denormalization tables.</p>
-</div>
-<div class="paragraph">
-<p>We write to a "table of truth" first, then duplicate the data to denormalization tables.</p>
-</div>
-<div class="paragraph">
-<p>The Distributed server offers several mechanisms to mitigate these inconsistencies:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Writes to denormalization tables are retried.</p>
-</li>
-<li>
-<p>Some <a href="../operate/guide.html#_solving_cassandra_inconsistencies" class="xref page">SolveInconsistencies tasks</a> are exposed and are able to heal a given denormalization table.
-They reset the "deduplication tables" content to the "table of truth" content.</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/blob/master/src/adr/0042-applicative-read-repairs.md">Read repairs</a>,
-when implemented for a given denormalization, enables auto-healing. When an inconsistency is detected, They reset the
-"deduplication tables" entry to the "table of truth" entry.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_consistency_across_data_stores"><a class="anchor" href="#_consistency_across_data_stores"></a>Consistency across data stores</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The Distributed Server leverages several data stores:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Cassandra is used for metadata storage</p>
-</li>
-<li>
-<p>OpenSearch for search</p>
-</li>
-<li>
-<p>Object Storage for large object storage</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Thus the Distributed Server also offers mechanisms to enforce consistency across data stores.</p>
-</div>
-<div class="sect2">
-<h3 id="_write_path_organisation"><a class="anchor" href="#_write_path_organisation"></a>Write path organisation</h3>
-<div class="paragraph">
-<p>The primary data stores are composed of Cassandra for metadata and Object storage for binary data.</p>
-</div>
-<div class="paragraph">
-<p>To ensure the data referenced in Cassandra is pointing to a valid object in the object store, we write
-the object store payload first, then write the corresponding metadata in Cassandra.</p>
-</div>
-<div class="paragraph">
-<p>Such a procedure avoids metadata pointing to unexisting blobs, however might lead to some unreferenced
-blobs.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_cassandra_opensearch"><a class="anchor" href="#_cassandra_opensearch"></a>Cassandra <⇒ OpenSearch</h3>
-<div class="paragraph">
-<p>After being written to the primary stores (namely Cassandra & Object Storage), email content is
-asynchronously indexed into OpenSearch.</p>
-</div>
-<div class="paragraph">
-<p>This process, called the EventBus, which retries temporary errors, and stores transient errors for
-later admin-triggered retries is described further <a href="../operate/guide.html#_mailbox_event_bus" class="xref page">here</a>.
-His role is to spread load and limit inconsistencies.</p>
-</div>
-<div class="paragraph">
-<p>Furthermore, some <a href="../operate/guide.html#_usual_troubleshooting_procedures" class="xref page">re-indexing tasks</a>
-enables to re-synchronise OpenSearch content with the primary data stores</p>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/architecture/implemented-standards.html b/james-distributed-app/3.8.0/architecture/implemented-standards.html
deleted file mode 100644
index c31ab7f..0000000
--- a/james-distributed-app/3.8.0/architecture/implemented-standards.html
+++ /dev/null
@@ -1,721 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Implemented standards :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Architecture</a></li>
- <li><a href="implemented-standards.html">Implemented standards</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/architecture/implemented-standards.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Implemented standards</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This page details standards implemented by the distributed server.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_message_formats"><a class="anchor" href="#_message_formats"></a>Message formats</h2>
-<div class="sectionbody">
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc5322">RFC-5322</a> Internet Message Format (MIME)</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc2045">RFC-2045</a> Format of Internet Message Bodies</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc3464">RFC-3464</a> An Extensible Message Format for Delivery Status Notifications</p>
-</li>
-<li>
-<p>James allow emmit DSNs from the mailet container.</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc8098">RFC-8098</a> Message Disposition Notification</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_tls_authentication"><a class="anchor" href="#_tls_authentication"></a>TLS & authentication</h2>
-<div class="sectionbody">
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc2595.html">RFC-2595</a> TLS for IMAP, POP3, SMTP (StartTLS)</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc8314.html">RFC-8314</a> Implicit TLS</p>
-</li>
-<li>
-<p><a href="https://www.rfc-editor.org/rfc/rfc4959.html">RFC-4959</a> SASL IR: Initial client response</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc4616">RFC-4616</a> SASL plain authentication</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc8314.html">RFC-7628</a> SASL for OAUTH</p>
-</li>
-<li>
-<p>Implemented for IMAP and SMTP</p>
-</li>
-<li>
-<p>Support for OIDC standard only.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_smtp"><a class="anchor" href="#_smtp"></a>SMTP</h2>
-<div class="sectionbody">
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc5321">RFC-5321</a> SMTP Protocol</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc974">RFC-974</a> MAIL ROUTING AND THE DOMAIN SYSTEM</p>
-</li>
-<li>
-<p><a href="https://www.rfc-editor.org/rfc/rfc3461">RFC-3461</a> Simple Mail Transfer Protocol (SMTP) Service Extension for Delivery Status Notifications (DSNs)</p>
-</li>
-<li>
-<p>Requires extra configuration.</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc1652">RFC-1652</a> SMTP Service Extension for 8bit-MIME transport</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc1830">RFC-1830</a> SMTP Service Extensions for Transmission of Large and Binary MIME Messages</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc1869">RFC-1869</a> SMTP Service Extensions</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc1870">RFC-1870</a> SMTP Service Extension for Message Size Declaration</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc1891">RFC-1891</a> SMTP Service Extension for Delivery Status Notifications</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc1893">RFC-1893</a> Enhanced Mail System Status Codes</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc2034">RFC-2034</a> SMTP Service Extension for Returning Enhanced Error Codes</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc2142">RFC-2142</a> Mailbox Names For Common Services, Roles And Functions</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc2197">RFC-2197</a> SMTP Service Extension for Command Pipelining</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc2554">RFC-2554</a> ESMTP Service Extension for Authentication</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc1893">RFC-1893</a> Enhanced Mail System Status Codes</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_lmtp"><a class="anchor" href="#_lmtp"></a>LMTP</h2>
-<div class="sectionbody">
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://james.apache.org/server/rfclist/lmtp/rfc2033.txt">RFC-2033</a> LMTP Local Mail Transfer Protocol</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_imap"><a class="anchor" href="#_imap"></a>IMAP</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The following IMAP specifications are implemented:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc3501.html">RFC-3501</a> INTERNET MESSAGE ACCESS PROTOCOL - VERSION 4rev1</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc2177.html">RFC-2177</a> IMAP IDLE (mailbox scoped push notifications)</p>
-</li>
-<li>
-<p><a href="https://www.rfc-editor.org/rfc/rfc9208.html">RFC-9208</a> IMAP QUOTA Extension</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc2342.html">RFC-2342</a> IMAP namespace</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc2088.html">RFC-2088</a> IMAP non synchronized literals</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc4315.html">RFC-4315</a> IMAP UIDPLUS</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc5464.html">RFC-5464</a> IMAP Metadata (annotations on mailboxes)</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc4551.html">RFC-4551</a> IMAP Condstore</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc5162.html">RFC-5162</a> IMAP QRESYNC (synchronisation semantic for deleted messages)</p>
-</li>
-<li>
-<p>We don’t store a log of deleted modseq thus clients should rely on known sequences mechanism to optimize exchanges.</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc4978.html">RFC-4978</a> IMAP Compress (optional)</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc5161.html">RFC-5161</a> IMAP ENABLE</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc6851.html">RFC-6851</a> IMAP MOVE command</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc5182.html">RFC-5182</a> IMAP Extension for Referencing the Last SEARCH Result</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc5032.html">RFC-5032</a> IMAP WITHIN (for relative date search semantic)</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc4731.html">RFC-4731</a> IMAP ESEARCH: extentions for IMAP search: new options like min, max, count.</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc3348.html">RFC-3348</a> IMAP Child Mailbox Extension</p>
-</li>
-<li>
-<p><a href="https://www.rfc-editor.org/rfc/rfc8508.html">RFC-8508</a> IMAP Replace Extension</p>
-</li>
-<li>
-<p><a href="https://www.rfc-editor.org/rfc/rfc7889.html">RFC-7889</a> IMAP Extension for APPENDLIMIT</p>
-</li>
-<li>
-<p><a href="https://www.rfc-editor.org/rfc/rfc8474.html">RFC-8474</a> IMAP Extension for Object Identifiers</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc2971.html">RFC-2971</a> IMAP ID Extension</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc8438.html">RFC-8438</a> IMAP Extension for STATUS=SIZE</p>
-</li>
-<li>
-<p><a href="https://www.rfc-editor.org/rfc/rfc5258.html">RFC-5258</a> IMAP LIST Command Extensions</p>
-</li>
-<li>
-<p><a href="https://www.rfc-editor.org/rfc/rfc5819.html">RFC-5819</a> IMAP4 Extension for Returning STATUS Information in Extended LIST</p>
-</li>
-<li>
-<p><a href="https://www.rfc-editor.org/rfc/rfc8440.html">RFC-8440</a> IMAP4 Extension for Returning MYRIGHTS Information in Extended LIST</p>
-</li>
-<li>
-<p><a href="https://www.rfc-editor.org/rfc/rfc8440.html">RFC-6154</a> IMAP LIST Extension for Special-Use Mailboxes</p>
-</li>
-<li>
-<p><a href="https://www.rfc-editor.org/rfc/rfc8514.html">RFC-8514</a> IMAP SAVEDATE Extension</p>
-</li>
-<li>
-<p><a href="https://www.rfc-editor.org/rfc/rfc8514.html">RFC-9394</a> IMAP PARTIAL Extension for Paged SEARCH and FETCH</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Partially implemented specifications:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc4314.html">RFC-4314</a> IMAP ACL</p>
-</li>
-<li>
-<p>ACLs can be created and managed but mailbox not belonging to one account cannot, as of today, be accessed in IMAP.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_jmap"><a class="anchor" href="#_jmap"></a>JMAP</h2>
-<div class="sectionbody">
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc8620">RFC-8620</a> Json Metadata Application Protocol (JMAP)</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc8621">RFC-8621</a> JMAP for emails</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc8887">RFC-8887</a> JMAP over websockets</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc9007.html">RFC-9007</a> Message Delivery Notifications with JMAP.</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc8030.html">RFC-8030</a> Web PUSH: JMAP enable sending push notifications through a push gateway.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p><a href="https://jmap.io/">JMAP</a> is intended to be a new standard for email clients to connect to mail
-stores. It therefore intends to primarily replace IMAP + SMTP submission. It is also designed to be more
-generic. It does not replace MTA-to-MTA SMTP transmission.</p>
-</div>
-<div class="paragraph">
-<p>The <a href="https://github.com/apache/james-project/tree/master/server/protocols/jmap-rfc-8621/doc/specs/spec">annotated documentation</a>
-presents the limits of the JMAP RFC-8621 implementation part of the Apache James project.</p>
-</div>
-<div class="paragraph">
-<p>Some methods / types are not yet implemented, some implementations are naive, and the PUSH is not supported yet.</p>
-</div>
-<div class="paragraph">
-<p>Users are invited to read these limitations before using actively the JMAP RFC-8621 implementation, and should ensure their
-client applications only uses supported operations.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_pop3"><a class="anchor" href="#_pop3"></a>POP3</h2>
-<div class="sectionbody">
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://www.ietf.org/rfc/rfc1939.txt">RFC-1939</a> Post Office Protocol - Version 3</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_managesieve"><a class="anchor" href="#_managesieve"></a>ManageSieve</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Support for manageSieve is experimental.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc5804">RFC-5804</a> A Protocol for Remotely Managing Sieve Scripts</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_sieve"><a class="anchor" href="#_sieve"></a>Sieve</h2>
-<div class="sectionbody">
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc5228">RFC-5228</a> Sieve: An Email Filtering Language</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc5173">RFC-5173</a> Sieve Email Filtering: Body Extension</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc5230">RFC-5230</a> Sieve Email Filtering: Vacation Extension</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/architecture/index.html b/james-distributed-app/3.8.0/architecture/index.html
deleted file mode 100644
index c2ac6f1..0000000
--- a/james-distributed-app/3.8.0/architecture/index.html
+++ /dev/null
@@ -1,975 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Architecture :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item is-current-page" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Architecture</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/architecture/index.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Architecture</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This sections presents the Distributed Server architecture.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_storage"><a class="anchor" href="#_storage"></a>Storage</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>In order to deliver its promises, the Distributed Server leverages the following storage strategies:</p>
-</div>
-<div class="imageblock">
-<div class="content">
-<img src="../_images/storage.png" alt="Storage responsibilities for the Distributed Server">
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>Cassandra</strong> is used for metadata storage. Cassandra is efficient for a very high workload of small queries following
-a known pattern.</p>
-</li>
-<li>
-<p>The <strong>blob store</strong> storage interface is responsible of storing potentially large binary data. For instance
- email bodies, headers or attachments. Different technologies can be used: <strong>Cassandra</strong>, or S3 compatible <strong>Object Storage</strong>
-(S3 or Swift).</p>
-</li>
-<li>
-<p><strong>OpenSearch</strong> component empowers full text search on emails. It also enables querying data with unplanned access
-patterns. OpenSearch throughput do not however match the one of Cassandra thus its use is avoided upon regular workloads.</p>
-</li>
-<li>
-<p><strong>RabbitMQ</strong> enables James nodes of a same cluster to collaborate together. It is used to implement connected protocols,
-notification patterns as well as distributed resilient work queues and mail queue.</p>
-</li>
-<li>
-<p><strong>Tika</strong> (optional) enables text extraction from attachments, thus improving full text search results.</p>
-</li>
-<li>
-<p><strong><a href="https://spamassassin.apache.org/">SpamAssassin</a> or <a href="https://rspamd.com/">Rspamd</a></strong> (optional) can be used for Spam detection and user feedback is supported.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p><a href="consistency-model.html" class="xref page">This page</a> further details Distributed James consistency model.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_protocols"><a class="anchor" href="#_protocols"></a>Protocols</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The following protocols are supported and can be used to interact with the Distributed Server:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>SMTP</strong></p>
-</li>
-<li>
-<p><strong>IMAP</strong></p>
-</li>
-<li>
-<p><a href="../operate/webadmin.html" class="xref page">WebAdmin</a> REST Administration API</p>
-</li>
-<li>
-<p><strong>LMTP</strong></p>
-</li>
-<li>
-<p><strong>POP3</strong></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The following protocols should be considered experimental:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>JMAP</strong> (RFC-8620 &RFC-8621 specifications and known limitations of the James implementation are defined <a href="https://github.com/apache/james-project/tree/master/server/protocols/jmap-rfc-8621/doc">here</a>)</p>
-</li>
-<li>
-<p><strong>ManagedSieve</strong></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The following protocols should be considered deprecated:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>JMAP-draft</strong> (draft specification as defined <a href="https://github.com/apache/james-project/tree/master/server/protocols/jmap-draft/doc">here</a>)</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Read more on <a href="implemented-standards.html" class="xref page">implemented standards</a>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_topology"><a class="anchor" href="#_topology"></a>Topology</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>While it is perfectly possible to deploy homogeneous James instances, with the same configuration and thus the same
-protocols and the same responsibilities one might want to investigate in
-<a href="specialized-instances.html" class="xref page">'Specialized instances'</a>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_components"><a class="anchor" href="#_components"></a>Components</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This section presents the various components of the Distributed server, providing context about
-their interactions, and about their implementations.</p>
-</div>
-<div class="sect2">
-<h3 id="_high_level_view"><a class="anchor" href="#_high_level_view"></a>High level view</h3>
-<div class="paragraph">
-<p>Here is a high level view of the various server components and their interactions:</p>
-</div>
-<div class="imageblock">
-<div class="content">
-<img src="../_images/server-components.png" alt="Server components mobilized for SMTP & IMAP">
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>The SMTP protocol receives a mail, and enqueue it on the MailQueue</p>
-</li>
-<li>
-<p>The MailetContainer will start processing the mail Asynchronously and will take business decisions like storing the
-email locally in a user mailbox. The behaviour of the MailetContainer is highly customizable thanks to the Mailets and
-the Matcher composibility.</p>
-</li>
-<li>
-<p>The Mailbox component is responsible of storing a user’s mails.</p>
-</li>
-<li>
-<p>The user can use the IMAP or the JMAP protocol to retrieve and read his mails.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>These components will be presented more in depth below.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_mail_processing"><a class="anchor" href="#_mail_processing"></a>Mail processing</h3>
-<div class="paragraph">
-<p>Mail processing allows to take asynchronously business decisions on
-received emails.</p>
-</div>
-<div class="paragraph">
-<p>Here are its components:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>The <code>spooler</code> takes mail out of the mailQueue and executes mail
-processing within the <code>mailet container</code>.</p>
-</li>
-<li>
-<p>The <code>mailet container</code> synchronously executes the user defined logic.
-This <code>logic' is written through the use of `mailet</code>, <code>matcher</code> and
-<code>processor</code>.</p>
-</li>
-<li>
-<p>A <code>mailet</code> represents an action: mail modification, envelop
-modification, a side effect, or stop processing.</p>
-</li>
-<li>
-<p>A <code>matcher</code> represents a condition to execute a mailet.</p>
-</li>
-<li>
-<p>A <code>processor</code> is a flow of pair of <code>matcher</code> and <code>mailet</code> executed
-sequentially. The <code>ToProcessor</code> mailet is a <code>goto</code> instruction to start
-executing another <code>processor</code></p>
-</li>
-<li>
-<p>A <code>mail repository</code> allows storage of a mail as part of its
-processing. Standard configuration relies on the following mail
-repository:</p>
-<div class="ulist">
-<ul>
-<li>
-<p><code>cassandra://var/mail/error/</code> : unexpected errors that occurred
-during mail processing. Emails impacted by performance related
-exceptions, or logical bug within James code are typically stored here.
-These mails could be reprocessed once the cause of the error is fixed.
-The <code>Mail.error</code> field can help diagnose the issue. Correlation with
-logs can be achieved via the use of the <code>Mail.name</code> field.</p>
-</li>
-<li>
-<p><code>cassandra://var/mail/address-error/</code> : mail addressed to a
-non-existing recipient of a handled local domain. These mails could be
-reprocessed once the user is created, for instance.</p>
-</li>
-<li>
-<p><code>cassandra://var/mail/relay-denied/</code> : mail for whom relay was
-denied: missing authentication can, for instance, be a cause. In
-addition to prevent disasters upon miss configuration, an email review
-of this mail repository can help refine a host spammer blacklist.</p>
-</li>
-<li>
-<p><code>cassandra://var/mail/rrt-error/</code> : runtime error upon Recipient
-Rewriting occurred. This is typically due to a loop.</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_mail_queue"><a class="anchor" href="#_mail_queue"></a>Mail Queue</h3>
-<div class="paragraph">
-<p>An email queue is a mandatory component of SMTP servers. It is a system
-that creates a queue of emails that are waiting to be processed for
-delivery. Email queuing is a form of Message Queuing – an asynchronous
-service-to-service communication. A message queue is meant to decouple a
-producing process from a consuming one. An email queue decouples email
-reception from email processing. It allows them to communicate without
-being connected. As such, the queued emails wait for processing until
-the recipient is available to receive them. As James is an Email Server,
-it also supports mail queue as well.</p>
-</div>
-<div class="sect3">
-<h4 id="_why_mail_queue_is_necessary"><a class="anchor" href="#_why_mail_queue_is_necessary"></a>Why Mail Queue is necessary</h4>
-<div class="paragraph">
-<p>You might often need to check mail queue to make sure all emails are
-delivered properly. At first, you need to know why email queues get
-clogged. Here are the two core reasons for that:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Exceeded volume of emails</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Some mailbox providers enforce email rate limits on IP addresses. The
-limits are based on the sender reputation. If you exceeded this rate and
-queued too many emails, the delivery speed will decrease.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Spam-related issues</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Another common reason is that your email has been busted by spam
-filters. The filters will let the emails gradually pass to analyze how
-the rest of the recipients react to the message. If there is slow
-progress, it’s okay. Your email campaign is being observed and assessed.
-If it’s stuck, there could be different reasons including the blockage
-of your IP address.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_why_combining_cassandra_rabbitmq_and_object_storage_for_mailqueue"><a class="anchor" href="#_why_combining_cassandra_rabbitmq_and_object_storage_for_mailqueue"></a>Why combining Cassandra, RabbitMQ and Object storage for MailQueue</h4>
-<div class="ulist">
-<ul>
-<li>
-<p>RabbitMQ ensures the messaging function, and avoids polling.</p>
-</li>
-<li>
-<p>Cassandra enables administrative operations such as browsing, deleting
-using a time series which might require fine performance tuning (see
-<a href="http://cassandra.apache.org/doc/latest/operating/index.html">Operating
-Casandra documentation</a>).</p>
-</li>
-<li>
-<p>Object Storage stores potentially large binary payload.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>However the current design do not implement delays. Delays allow to
-define the time a mail have to be living in the mailqueue before being
-dequeued and is used for example for exponential wait delays upon remote
-delivery retries, or</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_mailbox"><a class="anchor" href="#_mailbox"></a>Mailbox</h3>
-<div class="paragraph">
-<p>Storage for emails belonging for users.</p>
-</div>
-<div class="paragraph">
-<p>Metadata are stored in Cassandra while headers, bodies and attachments are stored
-within the <a href="#_blobstore">BlobStore</a>.</p>
-</div>
-<div class="sect3">
-<h4 id="_search_index"><a class="anchor" href="#_search_index"></a>Search index</h4>
-<div class="paragraph">
-<p>Emails are indexed asynchronously in OpenSearch via the <a href="#_event_bus">EventBus</a>
-in order to empower advanced and fast email full text search.</p>
-</div>
-<div class="paragraph">
-<p>Text extraction can be set up using <a href="https://tika.apache.org/">Tika</a>, allowing
-to extract the text from attachment, allowing to search your emails based on the attachment
-textual content. In such case, the OpenSearch indexer will call a Tika server prior
-indexing.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_quotas"><a class="anchor" href="#_quotas"></a>Quotas</h4>
-<div class="paragraph">
-<p>Current Quotas of users are hold in a Cassandra projection. Limitations can be defined via
-user, domain or globally.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_event_bus"><a class="anchor" href="#_event_bus"></a>Event Bus</h4>
-<div class="paragraph">
-<p>Distributed James relies on an event bus system to enrich mailbox capabilities. Each
-operation performed on the mailbox will trigger related events, that can
-be processed asynchronously by potentially any James node on a
-distributed system.</p>
-</div>
-<div class="paragraph">
-<p>Many different kind of events can be triggered during a mailbox
-operation, such as:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>MailboxEvent</code>: event related to an operation regarding a mailbox:</p>
-<div class="ulist">
-<ul>
-<li>
-<p><code>MailboxDeletion</code>: a mailbox has been deleted</p>
-</li>
-<li>
-<p><code>MailboxAdded</code>: a mailbox has been added</p>
-</li>
-<li>
-<p><code>MailboxRenamed</code>: a mailbox has been renamed</p>
-</li>
-<li>
-<p><code>MailboxACLUpdated</code>: a mailbox got its rights and permissions updated</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p><code>MessageEvent</code>: event related to an operation regarding a message:</p>
-<div class="ulist">
-<ul>
-<li>
-<p><code>Added</code>: messages have been added to a mailbox</p>
-</li>
-<li>
-<p><code>Expunged</code>: messages have been expunged from a mailbox</p>
-</li>
-<li>
-<p><code>FlagsUpdated</code>: messages had their flags updated</p>
-</li>
-<li>
-<p><code>MessageMoveEvent</code>: messages have been moved from a mailbox to an
-other</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p><code>QuotaUsageUpdatedEvent</code>: event related to quota update</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Mailbox listeners can register themselves on this event bus system to be
-called when an event is fired, allowing to do different kind of extra
-operations on the system, like:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Current quota calculation</p>
-</li>
-<li>
-<p>Message indexation with OpenSearch</p>
-</li>
-<li>
-<p>Mailbox annotations cleanup</p>
-</li>
-<li>
-<p>Ham/spam reporting to Spam filtering system</p>
-</li>
-<li>
-<p>…</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_deleted_messages_vault"><a class="anchor" href="#_deleted_messages_vault"></a>Deleted Messages Vault</h4>
-<div class="paragraph">
-<p>Deleted Messages Vault is an interesting feature that will help James
-users have a chance to:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>retain users deleted messages for some time.</p>
-</li>
-<li>
-<p>restore & export deleted messages by various criteria.</p>
-</li>
-<li>
-<p>permanently delete some retained messages.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>If the Deleted Messages Vault is enabled when users delete their mails,
-and by that we mean when they try to definitely delete them by emptying
-the trash, James will retain these mails into the Deleted Messages
-Vault, before an email or a mailbox is going to be deleted. And only
-administrators can interact with this component via
-wref:webadmin.adoc#_deleted-messages-vault[WebAdmin] REST APIs].</p>
-</div>
-<div class="paragraph">
-<p>However, mails are not retained forever as you have to configure a
-retention period before using it (with one-year retention by default if
-not defined). It’s also possible to permanently delete a mail if needed.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_data"><a class="anchor" href="#_data"></a>Data</h3>
-<div class="paragraph">
-<p>Storage for domains and users.</p>
-</div>
-<div class="paragraph">
-<p>Domains are persisted in Cassandra.</p>
-</div>
-<div class="paragraph">
-<p>Users can be managed in Cassandra, or via a LDAP (read only).</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_recipient_rewrite_tables"><a class="anchor" href="#_recipient_rewrite_tables"></a>Recipient rewrite tables</h3>
-<div class="paragraph">
-<p>Storage of Recipients Rewriting rules, in Cassandra.</p>
-</div>
-<div class="sect3">
-<h4 id="_mapping_types"><a class="anchor" href="#_mapping_types"></a>Mapping types</h4>
-<div class="paragraph">
-<p>James allows using various mapping types for better expressing the intent of your address rewriting logic:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>Domain mapping</strong>: Rewrites the domain of mail addresses. Use it for technical purposes, user will not
-be allowed to use the source in their FROM address headers. Domain mappings can be managed via the CLI and
-added via <a href="../operate/webadmin.html#_domain_mappings" class="xref page">WebAdmin</a></p>
-</li>
-<li>
-<p><strong>Domain aliases</strong>: Rewrites the domain of mail addresses. Express the idea that both domains can be used
-inter-changeably. User will be allowed to use the source in their FROM address headers. Domain aliases can
-be managed via <a href="../operate/webadmin.html#_get_the_list_of_aliases_for_a_domain" class="xref page">WebAdmin</a></p>
-</li>
-<li>
-<p><strong>Forwards</strong>: Replaces the source address by another one. Vehicles the intent of forwarding incoming mails
-to other users. Listing the forward source in the forward destinations keeps a local copy. User will not be
-allowed to use the source in their FROM address headers. Forward can
-be managed via <a href="../operate/webadmin.html#_address_forwards" class="xref page">WebAdmin</a></p>
-</li>
-<li>
-<p><strong>Groups</strong>: Replaces the source address by another one. Vehicles the intent of a group registration: group
-address will be swapped by group member addresses (Feature poor mailing list). User will not be
-allowed to use the source in their FROM address headers. Groups can
-be managed via <a href="../operate/webadmin.html#_address_group" class="xref page">WebAdmin</a></p>
-</li>
-<li>
-<p><strong>Aliases</strong>: Replaces the source address by another one. Represents user owned mail address, with which
-he can interact as if it was his main mail address. User will be allowed to use the source in their FROM
-address headers. Aliases can be managed via <a href="../operate/webadmin.html#_address_aliases" class="xref page">WebAdmin</a></p>
-</li>
-<li>
-<p><strong>Address mappings</strong>: Replaces the source address by another one. Use for technical purposes, this mapping type do
-not hold specific intent. Prefer using one of the above mapping types…​ User will not be allowed to use the source
-in their FROM address headers. Address mappings can be managed via the CLI or via
-<a href="../operate/webadmin.html#_address_mappings" class="xref page">WebAdmin</a></p>
-</li>
-<li>
-<p><strong>Regex mappings</strong>: Applies the regex on the supplied address. User will not be allowed to use the source
-in their FROM address headers. Regex mappings can be managed via the CLI or via
-<a href="../operate/webadmin.html#_regex_mapping" class="xref page">WebAdmin</a></p>
-</li>
-<li>
-<p><strong>Error</strong>: Throws an error upon processing. User will not be allowed to use the source
-in their FROM address headers. Errors can be managed via the CLI</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_blobstore"><a class="anchor" href="#_blobstore"></a>BlobStore</h3>
-<div class="paragraph">
-<p>Stores potentially large binary data.</p>
-</div>
-<div class="paragraph">
-<p>Mailbox component, Mail Queue component, Deleted Message Vault
-component relies on it.</p>
-</div>
-<div class="paragraph">
-<p>Supported backends include S3 compatible ObjectStorage (<a href="https://wiki.openstack.org/wiki/Swift">Swift</a>, S3 API).</p>
-</div>
-<div class="paragraph">
-<p>Encryption can be configured on top of ObjectStorage.</p>
-</div>
-<div class="paragraph">
-<p>Blobs can currently be deduplicated in order to reduce storage space. This means that two blobs with
-the same content will be stored one once.</p>
-</div>
-<div class="paragraph">
-<p>The downside is that deletion is more complicated, and a garbage collection needs to be run. A first implementation
-based on bloom filters can be used and triggered using the WebAdmin REST API.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_task_manager"><a class="anchor" href="#_task_manager"></a>Task Manager</h3>
-<div class="paragraph">
-<p>Allows to control and schedule long running tasks run by other
-components. Among other it enables scheduling, progress monitoring,
-cancellation of long running tasks.</p>
-</div>
-<div class="paragraph">
-<p>Distributed James leverage a task manager using Event Sourcing and RabbitMQ for messaging.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_event_sourcing"><a class="anchor" href="#_event_sourcing"></a>Event sourcing</h3>
-<div class="paragraph">
-<p><a href="https://martinfowler.com/eaaDev/EventSourcing.html">Event sourcing</a> implementation
-for the Distributed server stores events in Cassandra. It enables components
-to rely on event sourcing technics for taking decisions.</p>
-</div>
-<div class="paragraph">
-<p>A short list of usage are:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Data leak prevention storage</p>
-</li>
-<li>
-<p>JMAP filtering rules storage</p>
-</li>
-<li>
-<p>Validation of the MailQueue configuration</p>
-</li>
-<li>
-<p>Sending email warnings to user close to their quota</p>
-</li>
-<li>
-<p>Implementation of the TaskManager</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/architecture/specialized-instances.html b/james-distributed-app/3.8.0/architecture/specialized-instances.html
deleted file mode 100644
index ea2be77..0000000
--- a/james-distributed-app/3.8.0/architecture/specialized-instances.html
+++ /dev/null
@@ -1,471 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Specialized instances :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Architecture</a></li>
- <li><a href="specialized-instances.html">Specialized instances</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/architecture/specialized-instances.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Specialized instances</h1>
-<div class="paragraph">
-<p>While it is perfectly possible to deploy homogeneous James instances, with the same configuration and thus the same
-protocols and the same responsibilities one might want to investigate in 'Specialized instances'.</p>
-</div>
-<div class="paragraph">
-<p>This deployment topology consists of Distributed James servers with heterogeneous configurations on top of shared
-data-bases. Groups of James servers will thus handle various protocols and have different responsibilities.</p>
-</div>
-<div class="paragraph">
-<p>This approach limits cascading failures across protocols and services. Think of <strong>OutOfMemoryErrors</strong>, Cassandra driver
-queue overuse, CPUs starvation, etc.</p>
-</div>
-<div class="paragraph">
-<p>However, we can’t speak of micro-services here: all James instances runs the same code, James is still a monolith, and
-databases need to be shared across instances.</p>
-</div>
-<div class="imageblock">
-<div class="content">
-<img src="../_images/specialized-instances.png" alt="Example of Specialized instances topology">
-</div>
-</div>
-<div class="paragraph">
-<p>We speak of:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>Front-line servers</strong> serves protocols. James enables to easily turn protocols on and off. Typically, each protocol would
-be isolated in its own group of James instances: james-imap, james-jmap, james-smtp, james-webadmin, etc…​ Refer to
-protocols configuration files to learn more.</p>
-</li>
-<li>
-<p><strong>Back-office servers</strong> handles other services like:</p>
-</li>
-<li>
-<p>Mail processing.</p>
-</li>
-<li>
-<p>Remote delivery.</p>
-</li>
-<li>
-<p>Event processing.</p>
-</li>
-<li>
-<p>Task execution.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Front-line servers will likely not handle back office responsibilities (but be sure to have back-office servers that do!).</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="../configure/mailetcontainer.html" class="xref page">Mail processing can be switched off</a>.</p>
-</li>
-<li>
-<p><a href="../configure/listeners.html" class="xref page">Mailbox event processing can be switched off</a>.</p>
-</li>
-<li>
-<p><a href="../configure/rabbitmq.html" class="xref page">Task execution can be switched off</a>.</p>
-</li>
-<li>
-<p>Remote Delivery service is not started if the RemoteDelivery mailet is not positioned in mailetcontainer.xml.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Of course, the above instances can be collocated at will, to reach some intermediate deployments with fewer
-instances to mitigate costs.</p>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/benchmark/db-benchmark.html b/james-distributed-app/3.8.0/benchmark/db-benchmark.html
deleted file mode 100644
index 6d6a76a..0000000
--- a/james-distributed-app/3.8.0/benchmark/db-benchmark.html
+++ /dev/null
@@ -1,1065 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Database benchmarks :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Performance benchmark</a></li>
- <li><a href="db-benchmark.html">Database benchmarks</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/benchmark/db-benchmark.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Database benchmarks</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This document provides basic performance of Distributed James' databases, benchmark methodologies as a basis for a James administrator who
-can test and evaluate if his Distributed James databases are performing well.</p>
-</div>
-<div class="paragraph">
-<p>It includes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>A sample deployment topology</p>
-</li>
-<li>
-<p>Propose benchmark methodology and base performance for each database. This aims to help operators to quickly identify
-performance issues and compliance of their databases.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_sample_deployment_topology"><a class="anchor" href="#_sample_deployment_topology"></a>Sample deployment topology</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>We deploy a sample topology of Distributed James with these following databases:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Apache Cassandra 4 as main database: 3 nodes, each node has 8 OVH vCores CPU and 30 GB memory limit (OVH b2-30 instance).</p>
-</li>
-<li>
-<p>OpenDistro 1.13.1 as search engine: 3 nodes, each node has 8 OVH vCores CPU and 30 GB memory limit (OVH b2-30 instance).</p>
-</li>
-<li>
-<p>RabbitMQ 3.8.17 as message queue: 3 Kubernetes pods, each pod has 0.6 OVH vCore CPU and 2 GB memory limit.</p>
-</li>
-<li>
-<p>OVH Swift S3 as an object storage</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>With the above system, our email service operates stably with valuable performance.
-For a more details, it can handle a load throughput up to about 1000 JMAP requests per second with 99th percentile latency is 400ms.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_benchmark_methodologies_and_base_performances"><a class="anchor" href="#_benchmark_methodologies_and_base_performances"></a>Benchmark methodologies and base performances</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>We are willing to share the benchmark methodologies and the result to you as a reference to evaluate your Distributed James' performance.
-Other evaluation methods are welcome, as long as your databases exhibit similar or even better performance than ours.
-It is up to your business needs. If your databases shows results that fall far from our baseline performance, there’s a good chance that
-there are problems with your system, and you need to check it out thoroughly.</p>
-</div>
-<div class="sect2">
-<h3 id="_benchmark_cassandra"><a class="anchor" href="#_benchmark_cassandra"></a>Benchmark Cassandra</h3>
-<div class="sect3">
-<h4 id="_benchmark_methodology"><a class="anchor" href="#_benchmark_methodology"></a>Benchmark methodology</h4>
-<div class="sect4">
-<h5 id="_benchmark_tool"><a class="anchor" href="#_benchmark_tool"></a>Benchmark tool</h5>
-<div class="paragraph">
-<p>We use <a href="https://cassandra.apache.org/doc/latest/cassandra/tools/cassandra_stress.html">cassandra-stress tool</a> - an official
-tool of Cassandra for stress loading tests.</p>
-</div>
-<div class="paragraph">
-<p>The cassandra-stress tool is a Java-based stress testing utility for basic benchmarking and load testing a Cassandra cluster.
-Data modeling choices can greatly affect application performance. Significant load testing over several trials is the best method for discovering issues with a particular data model. The cassandra-stress tool is an effective tool for populating a cluster and stress testing CQL tables and queries. Use cassandra-stress to:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Quickly determine how a schema performs.</p>
-</li>
-<li>
-<p>Understand how your database scales.</p>
-</li>
-<li>
-<p>Optimize your data model and settings.</p>
-</li>
-<li>
-<p>Determine production capacity.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>There are several operation types:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>write-only, read-only, and mixed workloads of standard data</p>
-</li>
-<li>
-<p>write-only and read-only workloads for counter columns</p>
-</li>
-<li>
-<p>user configured workloads, running custom queries on custom schemas</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect4">
-<h5 id="_how_to_benchmark"><a class="anchor" href="#_how_to_benchmark"></a>How to benchmark</h5>
-<div class="paragraph">
-<p>Here we are using a simple case to test and compare Cassandra performance between different setup environments.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">keyspace: stresscql
-
-keyspace_definition: |
- CREATE KEYSPACE stresscql WITH replication = {'class': 'SimpleStrategy', 'replication_factor': 3};
-
-table: mixed_workload
-
-table_definition: |
- CREATE TABLE mixed_workload (
- key uuid PRIMARY KEY,
- a blob,
- b blob
- ) WITH COMPACT STORAGE
-
-columnspec:
- - name: a
- size: uniform(1..10000)
- - name: b
- size: uniform(1..100000)
-
-insert:
- partitions: fixed(1)
-
-queries:
- read:
- cql: select * from mixed_workload where key = ?
- fields: samerow</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Create the yaml file as above and copy to a Cassandra node.</p>
-</div>
-<div class="paragraph">
-<p>Insert some sample data:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">cassandra-stress user profile=mixed_workload.yml n=100000 "ops(insert=1)" cl=ONE -mode native cql3 user=<user> password=<password> -node <IP> -rate threads=8 -graph file=./graph_insert.xml title=Benchmark revision=insert_ONE</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Read intensive scenario:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">cassandra-stress user profile=mixed_workload.yml n=100000 "ops(insert=1,read=4)" cl=ONE -mode native cql3 user=<user> password=<password> -node <IP> -rate threads=8 -graph file=./graph_mixed.xml title=Benchmark revision=mixed_ONE</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>In there:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>n=100000: The number of insert batches, not number of individual insert operations.</p>
-</li>
-<li>
-<p>rate threads=8: The number of concurrent threads. If not specified it will start with 4 threads and increase until server reaches a limit.</p>
-</li>
-<li>
-<p>ops(insert=1,read=4): This will execute insert and read queries in the ratio 1:4.</p>
-</li>
-<li>
-<p>graph: Export results to graph in html format.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_sample_benchmark_result"><a class="anchor" href="#_sample_benchmark_result"></a>Sample benchmark result</h4>
-<div class="imageblock">
-<div class="content">
-<img src="../_images/cassandra_stress_test_result_1.png" alt="cassandra stress test result 1">
-</div>
-</div>
-<div class="imageblock">
-<div class="content">
-<img src="../_images/cassandra_stress_test_result_2.png" alt="cassandra stress test result 2">
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_references"><a class="anchor" href="#_references"></a>References</h4>
-<div class="paragraph">
-<p><a href="https://www.datastax.com/blog/improved-cassandra-21-stress-tool-benchmark-any-schema-part-1">Datastax - Cassandra stress tool</a></p>
-</div>
-<div class="paragraph">
-<p><a href="https://www.instaclustr.com/deep-diving-cassandra-stress-part-3-using-yaml-profiles/">Deep Diving cassandra-stress – Part 3 (Using YAML Profiles)</a></p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_benchmark_opensearch"><a class="anchor" href="#_benchmark_opensearch"></a>Benchmark OpenSearch</h3>
-<div class="sect3">
-<h4 id="_benchmark_methodology_2"><a class="anchor" href="#_benchmark_methodology_2"></a>Benchmark methodology</h4>
-<div class="sect4">
-<h5 id="_benchmark_tool_2"><a class="anchor" href="#_benchmark_tool_2"></a>Benchmark tool</h5>
-<div class="paragraph">
-<p>We use <a href="https://github.com/opensearch-project/opensearch-benchmark">opensearch-benchmark</a> - an official OpenSearch benchmarking tool.
-It provides the following features:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Automatically create OpenSearch clusters, stress tests them, and delete them.</p>
-</li>
-<li>
-<p>Manage stress testing data and solutions by OpenSearch version.</p>
-</li>
-<li>
-<p>Present stress testing data in a comprehensive way, allowing you to compare and analyze the data of different stress tests and store the data on a particular OpenSearch instance for secondary analysis.</p>
-</li>
-<li>
-<p>Collect Java Virtual Machine (JVM) details, such as memory and garbage collection (GC) data, to locate performance problems.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect4">
-<h5 id="_how_to_benchmark_2"><a class="anchor" href="#_how_to_benchmark_2"></a>How to benchmark</h5>
-<div class="paragraph">
-<p>To install the <code>opensearch-benchmark</code> tool, you need Python 3.8+ including pip3 first, then run:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">python3 -m pip install opensearch-benchmark</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If you have any trouble or need more detailed instructions, please look in the <a href="https://github.com/opensearch-project/OpenSearch-Benchmark/blob/main/DEVELOPER_GUIDE.md">detailed installation guide</a>.</p>
-</div>
-<div class="paragraph">
-<p>Let’s see which workloads (simulation profiles) that <code>opensearch-benchmark</code> provides: <code><code>opensearch-benchmark list worloads</code></code>.
-For our James use case, we are interested in <code><code>pmc</code></code> workload: <code><code>Full-text benchmark with academic papers from PMC</code></code>.</p>
-</div>
-<div class="paragraph">
-<p>Run the below script to benchmark against your OpenSearch cluster:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">opensearch-benchmark execute_test --pipeline=benchmark-only --workload=[workload-name] --target-host=[ip_node1:port_node1],[ip_node2:port_node2],[ip_node3:port_node3] --client-options="use_ssl:false,verify_certs:false,basic_auth_user:'[user]',basic_auth_password:'[password]'"</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>In there:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>--pipeline=benchmark-only: benchmark against a running cluster</p>
-</li>
-<li>
-<p>workload-name: the workload you want to benchmark</p>
-</li>
-<li>
-<p>ip:port: OpenSearch Node' socket</p>
-</li>
-<li>
-<p>user/password: OpenSearch authentication credentials</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_sample_benchmark_result_2"><a class="anchor" href="#_sample_benchmark_result_2"></a>Sample benchmark result</h4>
-<div class="sect4">
-<h5 id="_pmc_worload"><a class="anchor" href="#_pmc_worload"></a>PMC worload</h5>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">| Metric | Task | Value | Unit |
-|---------------------------------------------------------------:|------------------------------:|------------:|--------:|
-| Min Throughput | index-append | 734.63 | docs/s |
-| Mean Throughput | index-append | 763.16 | docs/s |
-| Median Throughput | index-append | 746.5 | docs/s |
-| Max Throughput | index-append | 833.51 | docs/s |
-| 50th percentile latency | index-append | 4738.57 | ms |
-| 90th percentile latency | index-append | 8129.1 | ms |
-| 99th percentile latency | index-append | 11734.5 | ms |
-| 100th percentile latency | index-append | 14662.9 | ms |
-| 50th percentile service time | index-append | 4738.57 | ms |
-| 90th percentile service time | index-append | 8129.1 | ms |
-| 99th percentile service time | index-append | 11734.5 | ms |
-| 100th percentile service time | index-append | 14662.9 | ms |
-| error rate | index-append | 0 | % |
-| Min Throughput | default | 19.94 | ops/s |
-| Mean Throughput | default | 19.95 | ops/s |
-| Median Throughput | default | 19.95 | ops/s |
-| Max Throughput | default | 19.96 | ops/s |
-| 50th percentile latency | default | 23.1322 | ms |
-| 90th percentile latency | default | 25.4129 | ms |
-| 99th percentile latency | default | 29.1382 | ms |
-| 100th percentile latency | default | 29.4762 | ms |
-| 50th percentile service time | default | 21.4895 | ms |
-| 90th percentile service time | default | 23.589 | ms |
-| 99th percentile service time | default | 26.6134 | ms |
-| 100th percentile service time | default | 27.9068 | ms |
-| error rate | default | 0 | % |
-| Min Throughput | term | 19.93 | ops/s |
-| Mean Throughput | term | 19.94 | ops/s |
-| Median Throughput | term | 19.94 | ops/s |
-| Max Throughput | term | 19.95 | ops/s |
-| 50th percentile latency | term | 31.0684 | ms |
-| 90th percentile latency | term | 34.1419 | ms |
-| 99th percentile latency | term | 74.7904 | ms |
-| 100th percentile latency | term | 103.663 | ms |
-| 50th percentile service time | term | 29.6775 | ms |
-| 90th percentile service time | term | 32.4288 | ms |
-| 99th percentile service time | term | 36.013 | ms |
-| 100th percentile service time | term | 102.193 | ms |
-| error rate | term | 0 | % |
-| Min Throughput | phrase | 19.94 | ops/s |
-| Mean Throughput | phrase | 19.95 | ops/s |
-| Median Throughput | phrase | 19.95 | ops/s |
-| Max Throughput | phrase | 19.95 | ops/s |
-| 50th percentile latency | phrase | 23.0255 | ms |
-| 90th percentile latency | phrase | 26.1607 | ms |
-| 99th percentile latency | phrase | 31.2094 | ms |
-| 100th percentile latency | phrase | 45.5012 | ms |
-| 50th percentile service time | phrase | 21.5109 | ms |
-| 90th percentile service time | phrase | 24.4144 | ms |
-| 99th percentile service time | phrase | 26.1865 | ms |
-| 100th percentile service time | phrase | 43.5122 | ms |
-| error rate | phrase | 0 | % |
-
-----------------------------------
-[INFO] SUCCESS (took 1772 seconds)
-----------------------------------</code></pre>
-</div>
-</div>
-</div>
-<div class="sect4">
-<h5 id="_pmc_custom_workload"><a class="anchor" href="#_pmc_custom_workload"></a>PMC custom workload</h5>
-<div class="paragraph">
-<p>We customized the PMC workload by increasing search throughput target to figure out our OpenSearch cluster limit.</p>
-</div>
-<div class="paragraph">
-<p>The result is that with 25-30 request/s we have a 99th percentile latency of 1s.</p>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_references_2"><a class="anchor" href="#_references_2"></a>References</h4>
-<div class="paragraph">
-<p>The <code>opensearch-benchmark</code> tool seems to be a fork of the official benchmark tool <a href="https://github.com/elastic/rally">EsRally</a> of Elasticsearch.
-The <code>opensearch-benchmark</code> tool is not adopted widely yet, so we believe some EsRally references could help as well:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://www.alibabacloud.com/blog/esrally-official-stress-testing-tool-for-elasticsearch_597102">esrally: Official Stress Testing Tool for Elasticsearch</a></p>
-</li>
-<li>
-<p><a href="https://esrally.readthedocs.io/en/latest/adding_tracks.html">Create a custom EsRally track</a></p>
-</li>
-<li>
-<p><a href="https://discuss.elastic.co/t/why-the-percentile-latency-is-several-times-more-than-service-time/69630">Why the percentile latency is several times more than service time</a></p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_benchmark_rabbitmq"><a class="anchor" href="#_benchmark_rabbitmq"></a>Benchmark RabbitMQ</h3>
-<div class="sect3">
-<h4 id="_benchmark_methodology_3"><a class="anchor" href="#_benchmark_methodology_3"></a>Benchmark methodology</h4>
-<div class="sect4">
-<h5 id="_benchmark_tool_3"><a class="anchor" href="#_benchmark_tool_3"></a>Benchmark tool</h5>
-<div class="paragraph">
-<p>We use <a href="https://github.com/rabbitmq/rabbitmq-perf-test">rabbitmq-perf-test</a> tool.</p>
-</div>
-</div>
-<div class="sect4">
-<h5 id="_how_to_benchmark_3"><a class="anchor" href="#_how_to_benchmark_3"></a>How to benchmark</h5>
-<div class="paragraph">
-<p>Using PerfTestMulti for more friendly:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Provide input scenario from a single file</p>
-</li>
-<li>
-<p>Provide output result as a single file. Can be visualized result file by the chart (graph WebUI)</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Run a command like below:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">bin/runjava com.rabbitmq.perf.PerfTestMulti [scenario-file] [result-file]</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>In order to visualize result, coping [result-file] to <code><code>/html/examples/[result-file]</code></code>.
-Start webserver to view graph by the command:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">bin/runjava com.rabbitmq.perf.WebServer</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Then browse: <a href="http://localhost:8080/examples/sample.html" class="bare">http://localhost:8080/examples/sample.html</a></p>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_sample_benchmark_result_3"><a class="anchor" href="#_sample_benchmark_result_3"></a>Sample benchmark result</h4>
-<div class="ulist">
-<ul>
-<li>
-<p>Scenario file:</p>
-</li>
-</ul>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">[{'name': 'consume', 'type': 'simple',
-'uri': 'amqp://james:eeN7Auquaeng@localhost:5677',
-'params':
- [{'time-limit': 30, 'producer-count': 2, 'consumer-count': 4}]}]</code></pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Result file:</p>
-</li>
-</ul>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{
- "consume": {
- "send-bytes-rate": 0,
- "recv-msg-rate": 4330.225080385852,
- "avg-latency": 18975254,
- "send-msg-rate": 455161.3183279743,
- "recv-bytes-rate": 0,
- "samples": [{
- "elapsed": 15086,
- "send-bytes-rate": 0,
- "recv-msg-rate": 0,
- "send-msg-rate": 0.06628662335940608,
- "recv-bytes-rate": 0
- },
- {
- "elapsed": 16086,
- "send-bytes-rate": 0,
- "recv-msg-rate": 1579,
- "max-latency": 928296,
- "min-latency": 278765,
- "avg-latency": 725508,
- "send-msg-rate": 388994,
- "recv-bytes-rate": 0
- },
- {
- "elapsed": 48184,
- "send-bytes-rate": 0,
- "recv-msg-rate": 3768.4918347742555,
- "max-latency": 32969370,
- "min-latency": 31852685,
- "avg-latency": 32385432,
- "send-msg-rate": 0,
- "recv-bytes-rate": 0
- },
- {
- "elapsed": 49186,
- "send-bytes-rate": 0,
- "recv-msg-rate": 4416.167664670658,
- "max-latency": 33953465,
- "min-latency": 32854771,
- "avg-latency": 33373113,
- "send-msg-rate": 0,
- "recv-bytes-rate": 0
- }]
- }
-}</code></pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Key result points:</p>
-</li>
-</ul>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<colgroup>
-<col style="width: 33.3333%;">
-<col style="width: 33.3333%;">
-<col style="width: 33.3334%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Metrics</th>
-<th class="tableblock halign-left valign-top">Unit</th>
-<th class="tableblock halign-left valign-top">Result</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Publisher throughput (the sending rate)</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">messages / second</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">3111</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Consumer throughput (the receiving rate)</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">messages / second</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">4404</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_benchmark_s3_storage"><a class="anchor" href="#_benchmark_s3_storage"></a>Benchmark S3 storage</h3>
-<div class="sect3">
-<h4 id="_benchmark_methodology_4"><a class="anchor" href="#_benchmark_methodology_4"></a>Benchmark methodology</h4>
-<div class="sect4">
-<h5 id="_benchmark_tool_4"><a class="anchor" href="#_benchmark_tool_4"></a>Benchmark tool</h5>
-<div class="paragraph">
-<p>We use <a href="https://github.com/dvassallo/s3-benchmark">s3-benchmark</a> tool.</p>
-</div>
-</div>
-<div class="sect4">
-<h5 id="_how_to_benchmark_4"><a class="anchor" href="#_how_to_benchmark_4"></a>How to benchmark</h5>
-<div class="olist arabic">
-<ol class="arabic">
-<li>
-<p>Make sure you set up appropriate S3 credentials with <code>awscli</code>.</p>
-</li>
-<li>
-<p>If you are using a compatible S3 storage of cloud providers like OVH, you would need to configure
-<code>awscli-plugin-endpoint</code>. E.g: <a href="https://docs.ovh.com/au/en/storage/getting_started_with_the_swift_S3_API/">Getting started with the OVH Swift S3 API</a></p>
-</li>
-<li>
-<p>Install <code>s3-benchmark</code> tool and run the command:</p>
-</li>
-</ol>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./s3-benchmark -endpoint=[endpoint] -region=[region] -bucket-name=[bucket-name] -payloads-min=[payload-min] -payloads-max=[payload-max] threads-max=[threads-max]</code></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_sample_benchmark_result_4"><a class="anchor" href="#_sample_benchmark_result_4"></a>Sample benchmark result</h4>
-<div class="paragraph">
-<p>We did S3 performance testing with suitable email objects sizes: 4 KB, 128 KB, 1 MB, 8 MB.</p>
-</div>
-<div class="paragraph">
-<p>Result:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">--- SETUP --------------------------------------------------------------------------------------------------------------------
-
-Uploading 4 KB objects
- 100% |████████████████████████████████████████| [4s:0s]
-Uploading 128 KB objects
- 100% |████████████████████████████████████████| [9s:0s]
-Uploading 1 MB objects
- 100% |████████████████████████████████████████| [8s:0s]
-Uploading 8 MB objects
- 100% |████████████████████████████████████████| [10s:0s]
-
---- BENCHMARK ----------------------------------------------------------------------------------------------------------------
-
-Download performance with 4 KB objects (b2-30)
- +-------------------------------------------------------------------------------------------------+
- | Time to First Byte (ms) | Time to Last Byte (ms) |
-+---------+----------------+------------------------------------------------+------------------------------------------------+
-| Threads | Throughput | avg min p25 p50 p75 p90 p99 max | avg min p25 p50 p75 p90 p99 max |
-+---------+----------------+------------------------------------------------+------------------------------------------------+
-| 8 | 0.6 MB/s | 36 10 17 22 36 57 233 249 | 37 10 17 22 36 57 233 249 |
-| 9 | 0.6 MB/s | 30 10 15 21 33 45 82 234 | 30 10 15 21 33 45 83 235 |
-| 10 | 0.2 MB/s | 55 11 18 22 28 52 248 1075 | 55 11 18 22 28 52 249 1075 |
-| 11 | 0.3 MB/s | 66 11 18 23 45 233 293 683 | 67 11 19 23 45 233 293 683 |
-| 12 | 0.6 MB/s | 35 12 19 22 43 55 67 235 | 35 12 19 22 43 56 67 235 |
-| 13 | 0.2 MB/s | 68 11 19 26 58 79 279 1037 | 68 11 19 26 58 80 279 1037 |
-| 14 | 0.6 MB/s | 43 17 20 24 52 56 230 236 | 43 17 20 25 52 56 230 236 |
-| 15 | 0.2 MB/s | 69 11 16 23 50 66 274 1299 | 69 11 16 24 50 66 274 1299 |
-| 16 | 0.5 MB/s | 52 9 19 31 81 95 228 237 | 53 9 19 31 81 95 229 237 |
-+---------+----------------+------------------------------------------------+------------------------------------------------+
-
-Download performance with 128 KB objects (b2-30)
- +-------------------------------------------------------------------------------------------------+
- | Time to First Byte (ms) | Time to Last Byte (ms) |
-+---------+----------------+------------------------------------------------+------------------------------------------------+
-| Threads | Throughput | avg min p25 p50 p75 p90 p99 max | avg min p25 p50 p75 p90 p99 max |
-+---------+----------------+------------------------------------------------+------------------------------------------------+
-| 8 | 3.3 MB/s | 71 16 22 28 39 66 232 1768 | 73 16 23 29 43 67 233 1769 |
-| 9 | 3.6 MB/s | 74 9 19 23 34 58 239 1646 | 75 10 20 24 37 59 240 1647 |
-| 10 | 2.9 MB/s | 97 16 21 24 48 89 656 2034 | 99 17 21 26 49 92 657 2035 |
-| 11 | 3.0 MB/s | 100 10 21 26 39 64 1049 2029 | 101 11 21 27 40 65 1050 2030 |
-| 12 | 3.0 MB/s | 76 12 19 24 44 56 256 2012 | 77 13 20 25 48 69 258 2013 |
-| 13 | 6.1 MB/s | 73 10 13 20 43 223 505 1026 | 74 10 15 21 43 224 506 1027 |
-| 14 | 5.5 MB/s | 81 11 15 23 51 240 666 1060 | 82 12 16 23 54 241 667 1060 |
-| 15 | 2.7 MB/s | 80 10 19 28 43 59 234 2222 | 84 11 25 34 47 60 236 2224 |
-| 16 | 18.6 MB/s | 58 10 19 26 61 224 248 266 | 61 10 22 29 65 224 249 267 |
-+---------+----------------+------------------------------------------------+------------------------------------------------+
-
-Download performance with 1 MB objects (b2-30)
- +-------------------------------------------------------------------------------------------------+
- | Time to First Byte (ms) | Time to Last Byte (ms) |
-+---------+----------------+------------------------------------------------+------------------------------------------------+
-| Threads | Throughput | avg min p25 p50 p75 p90 p99 max | avg min p25 p50 p75 p90 p99 max |
-+---------+----------------+------------------------------------------------+------------------------------------------------+
-| 8 | 56.4 MB/s | 41 12 26 34 43 57 94 235 | 136 30 69 100 161 284 345 396 |
-| 9 | 55.2 MB/s | 53 19 32 39 50 69 238 247 | 149 26 84 117 164 245 324 655 |
-| 10 | 33.9 MB/s | 74 17 27 37 50 77 456 1060 | 177 29 97 134 205 273 484 1076 |
-| 11 | 57.3 MB/s | 56 26 35 44 57 71 251 298 | 185 40 93 129 216 329 546 871 |
-| 12 | 37.7 MB/s | 66 21 33 43 58 73 102 1024 | 202 24 81 125 205 427 839 1222 |
-| 13 | 57.6 MB/s | 59 24 35 40 58 71 275 289 | 215 40 94 181 288 393 500 674 |
-| 14 | 47.1 MB/s | 73 18 46 56 66 75 475 519 | 229 30 116 221 272 441 603 686 |
-| 15 | 58.2 MB/s | 65 11 40 51 63 75 260 294 | 243 29 132 174 265 485 831 849 |
-| 16 | 23.1 MB/s | 96 14 46 55 62 80 124 2022 | 278 31 124 187 249 634 827 2028 |
-+---------+----------------+------------------------------------------------+------------------------------------------------+
-
-Download performance with 8 MB objects (b2-30)
- +-------------------------------------------------------------------------------------------------+
- | Time to First Byte (ms) | Time to Last Byte (ms) |
-+---------+----------------+------------------------------------------------+------------------------------------------------+
-| Threads | Throughput | avg min p25 p50 p75 p90 p99 max | avg min p25 p50 p75 p90 p99 max |
-+---------+----------------+------------------------------------------------+------------------------------------------------+
-| 8 | 58.4 MB/s | 88 35 65 79 88 96 288 307 | 1063 458 564 759 928 1151 4967 6841 |
-| 9 | 50.4 MB/s | 137 32 52 69 145 286 509 1404 | 1212 160 471 581 1720 2873 3744 4871 |
-| 10 | 58.2 MB/s | 77 46 54 66 77 98 275 285 | 1319 377 432 962 1264 3232 4266 6151 |
-| 11 | 58.4 MB/s | 97 32 63 72 80 91 323 707 | 1429 325 593 722 1648 3020 6172 6370 |
-| 12 | 58.5 MB/s | 108 26 65 81 91 261 301 519 | 1569 472 696 1101 1915 3175 4066 5110 |
-| 13 | 56.1 MB/s | 115 35 69 83 93 125 329 1092 | 1712 458 801 1165 2354 3559 3865 5945 |
-| 14 | 58.6 MB/s | 103 26 70 78 88 112 309 656 | 1807 789 999 1269 1998 3258 5201 6651 |
-| 15 | 58.3 MB/s | 113 31 55 67 79 134 276 1490 | 1947 497 1081 1756 2730 3557 3799 3974 |
-| 16 | 58.0 MB/s | 99 35 67 79 96 146 282 513 | 2091 531 882 1136 2161 6034 6686 6702 |
-+---------+----------------+------------------------------------------------+------------------------------------------------+</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>We believe that the actual OVH Swift S3' throughput should be at least about 100 MB/s. This was not fully achieved due to
-network limitations of the client machine performing the benchmark.</p>
-</div>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/benchmark/index.html b/james-distributed-app/3.8.0/benchmark/index.html
deleted file mode 100644
index 8439a8c..0000000
--- a/james-distributed-app/3.8.0/benchmark/index.html
+++ /dev/null
@@ -1,410 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Performance testing the Distributed server :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item is-current-page" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Performance benchmark</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/benchmark/index.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Performance testing the Distributed server</h1>
-<div class="paragraph">
-<p>The following pages detail how to do performance testing for the Distributed server also its database.</p>
-</div>
-<div class="paragraph">
-<p>Once you have a Distributed James server up and running you then need to ensure it operates correctly and has a decent performance.
-You may need to do performance testings periodically to make sure your James performs well.</p>
-</div>
-<div class="paragraph">
-<p>We introduced <a href="james-benchmark.html" class="xref page">tools and base benchmark result for Distributed James</a> also <a href="db-benchmark.html" class="xref page">James database’s base performance and how to benchmark them</a>
-to cover this topic.</p>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/benchmark/james-benchmark.html b/james-distributed-app/3.8.0/benchmark/james-benchmark.html
deleted file mode 100644
index 367b7c7..0000000
--- a/james-distributed-app/3.8.0/benchmark/james-benchmark.html
+++ /dev/null
@@ -1,603 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server benchmark :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Performance benchmark</a></li>
- <li><a href="james-benchmark.html">James benchmarks</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/benchmark/james-benchmark.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server benchmark</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This document provides benchmark methodology and basic performance of Distributed James as a basis for a James administrator who
-can test and evaluate if his Distributed James is performing well.</p>
-</div>
-<div class="paragraph">
-<p>It includes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>A sample Distributed James deployment topology</p>
-</li>
-<li>
-<p>Propose benchmark methodology</p>
-</li>
-<li>
-<p>Sample performance results</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This aims to help operators quickly identify performance issues.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_sample_deployment_topology"><a class="anchor" href="#_sample_deployment_topology"></a>Sample deployment topology</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>We deploy a sample topology of Distributed James with these following components:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Distributed James: 3 Kubernetes pods, each pod has 2 OVH vCore CPU and 4 GB memory limit.</p>
-</li>
-<li>
-<p>Apache Cassandra 4 as main database: 3 nodes, each node has 8 OVH vCores CPU and 30 GB memory limit (OVH b2-30 instance).</p>
-</li>
-<li>
-<p>OpenDistro 1.13.1 as search engine: 3 nodes, each node has 8 OVH vCores CPU and 30 GB memory limit (OVH b2-30 instance).</p>
-</li>
-<li>
-<p>RabbitMQ 3.8.17 as message queue: 3 Kubernetes pods, each pod has 0.6 OVH vCore CPU and 2 GB memory limit.</p>
-</li>
-<li>
-<p>OVH Swift S3 as an object storage</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_benchmark_methodology_and_base_performance"><a class="anchor" href="#_benchmark_methodology_and_base_performance"></a>Benchmark methodology and base performance</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_provision_testing_data"><a class="anchor" href="#_provision_testing_data"></a>Provision testing data</h3>
-<div class="paragraph">
-<p>Before doing the performance test, you should make sure you have a Distributed James up and running with some provisioned testing
-data so that it is representative of reality.</p>
-</div>
-<div class="paragraph">
-<p>Please follow these steps to provision testing data:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Prepare James with a custom <code>mailetcontainer.xml</code> having Random storing mailet. This help us easily setting a good amount of
-provisioned emails.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Add this under transport processor</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre><mailet match="All" class="RandomStoring"/></pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Modify <a href="https://github.com/apache/james-project/tree/master/server/apps/distributed-app/docs/modules/ROOT/pages/benchmark/provision.sh">provision.sh</a>
-upon your need (number of users, mailboxes, emails to be provisioned).</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Currently, this script provisions 10 users, 15 mailboxes and hundreds of emails for example. Normally to make the performance test representative, you
-should provision thousands of users, thousands of mailboxes and millions of emails.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Add the permission to execute the script:</p>
-</li>
-</ul>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>chmod +x provision.sh</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Install postfix (to get the smtp-source command):</p>
-</li>
-</ul>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>sudo apt-get install postfix</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Run the provision script:</p>
-</li>
-</ul>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>./provision.sh</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>After provisioning once, you should remove the Random storing mailet and move on to performance testing phase.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_provide_performance_testing_method"><a class="anchor" href="#_provide_performance_testing_method"></a>Provide performance testing method</h3>
-<div class="paragraph">
-<p>We introduce the tailored <a href="https://github.com/linagora/james-gatling">James Gatling</a> which bases on <a href="https://gatling.io/">Gatling - Load testing framework</a>
-for performance testing against IMAP/JMAP servers. Other testing method is welcome as long as you feel it is appropriate.</p>
-</div>
-<div class="paragraph">
-<p>Here are steps to do performance testing with James Gatling:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Setup James Gatling with <code>sbt</code> build tool</p>
-</li>
-<li>
-<p>Configure the <code>Configuration.scala</code> to point to your Distributed James IMAP/JMAP server(s). For more configuration details, please read
-<a href="https://github.com/linagora/james-gatling#readme">James Gatling Readme</a>.</p>
-</li>
-<li>
-<p>Run the performance testing simulation:</p>
-</li>
-</ul>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>$ sbt
-> gatling:testOnly SIMULATION_FQDN</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>In there: <code>SIMULATION_FQDN</code> is fully qualified class name of a performance test simulation.</p>
-</div>
-<div class="paragraph">
-<p>We did provide a lot of simulations in <code>org.apache.james.gatling.simulation</code> path. You can have a look and choose the suitable simulation.
-<code>sbt gatling:testOnly org.apache.james.gatling.simulation.imap.PlatformValidationSimulation</code> is a good starting point. Or you can even customize your simulation also!</p>
-</div>
-<div class="paragraph">
-<p>Some symbolic simulations we often use:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>IMAP: <code>org.apache.james.gatling.simulation.imap.PlatformValidationSimulation</code></p>
-</li>
-<li>
-<p>JMAP draft: <code>org.apache.james.gatling.simulation.jmap.draft.PlatformValidationSimulation</code></p>
-</li>
-<li>
-<p>JMAP rfc8621: <code>org.apache.james.gatling.simulation.jmap.rfc8621.PushPlatformValidationSimulation</code></p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_base_performance_result"><a class="anchor" href="#_base_performance_result"></a>Base performance result</h3>
-<div class="paragraph">
-<p>A sample IMAP performance testing result (PlatformValidationSimulation):</p>
-</div>
-<div class="imageblock">
-<div class="content">
-<img src="../_images/james-imap-base-performance.png" alt="james imap base performance">
-</div>
-</div>
-<div class="paragraph">
-<p>If you get a IMAP performance far below this base performance, you should consider investigating for performance issues.</p>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/configure/batchsizes.html b/james-distributed-app/3.8.0/configure/batchsizes.html
deleted file mode 100644
index 721ad7f..0000000
--- a/james-distributed-app/3.8.0/configure/batchsizes.html
+++ /dev/null
@@ -1,451 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — batchsizes.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Core components</li>
- <li><a href="batchsizes.html">batchsizes.properties</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/batchsizes.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — batchsizes.properties</h1>
-<div class="paragraph">
-<p>This files allow to define the amount of data that should be fetched 'at once' when interacting with the mailbox. This is
-needed as IMAP can generate some potentially large requests.</p>
-</div>
-<div class="paragraph">
-<p>Increasing these values tend to fasten individual requests, at the cost of enabling potential higher load.</p>
-</div>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/batchsizes.properties">example</a>
-to get some examples and hints.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. batchsizes.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">fetch.metadata</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional, defaults to 200. How many messages should be read in a batch when using FetchType.MetaData</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">fetch.headers</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional, defaults to 200. How many messages should be read in a batch when using FetchType.Header</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">fetch.body</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional, defaults to 100. How many messages should be read in a batch when using FetchType.Body</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">fetch.full</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional, defaults to 50. How many messages should be read in a batch when using FetchType.Full</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">copy</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional, defaults to 200. How many messages should be copied in a batch.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">move</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional, defaults to 200. How many messages should be moved in a batch.</p></td>
-</tr>
-</tbody>
-</table>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/configure/blobstore.html b/james-distributed-app/3.8.0/configure/blobstore.html
deleted file mode 100644
index dc0211e..0000000
--- a/james-distributed-app/3.8.0/configure/blobstore.html
+++ /dev/null
@@ -1,800 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — blobstore.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Storage dependencies</li>
- <li><a href="blobstore.html">blobstore.properties</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/blobstore.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — blobstore.properties</h1>
-<div class="sect1">
-<h2 id="_blobstore"><a class="anchor" href="#_blobstore"></a>BlobStore</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This file is optional. If omitted, the <strong>cassandra</strong> blob store will be used.</p>
-</div>
-<div class="paragraph">
-<p>BlobStore is the dedicated component to store blobs, non-indexable content.
-James uses the BlobStore for storing blobs which are usually mail contents, attachments, deleted mails…​</p>
-</div>
-<div class="paragraph">
-<p>You can choose the underlying implementation of BlobStore to fit with your James setup.</p>
-</div>
-<div class="paragraph">
-<p>It could be the implementation on top of Cassandra or file storage service S3 compatible like Openstack Swift and AWS S3.</p>
-</div>
-<div class="paragraph">
-<p>Consult <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/blob.properties">blob.properties</a>
-in GIT to get some examples and hints.</p>
-</div>
-<div class="sect2">
-<h3 id="_implementation_choice"><a class="anchor" href="#_implementation_choice"></a>Implementation choice</h3>
-<div class="paragraph">
-<p><strong>implementation</strong> :</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>cassandra: use cassandra based BlobStore</p>
-</li>
-<li>
-<p>objectstorage: use Swift/AWS S3 based BlobStore</p>
-</li>
-<li>
-<p>file: (experimental) use directly the file system. Useful for legacy architecture based on shared ISCI SANs and/or
-distributed file system with no object store available.</p>
-</li>
-</ul>
-</div>
-<div class="admonitionblock warning">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-warning" title="Warning"></i>
-</td>
-<td class="content">
-JAMES-3591 Cassandra is not made to store large binary content, its use will be suboptimal compared to
-Alternatives (namely S3 compatible BlobStores backed by for instance S3, MinIO or Ozone)
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>The generated startup warning log can be deactivated via the <code>cassandra.blob.store.disable.startup.warning</code> environment
-variable being positioned to <code>false</code>.</p>
-</div>
-<div class="paragraph">
-<p><strong>deduplication.enable</strong>: Mandatory. Supported value: true and false.</p>
-</div>
-<div class="paragraph">
-<p>If you choose to enable deduplication, the mails with the same content will be stored only once.</p>
-</div>
-<div class="admonitionblock warning">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-warning" title="Warning"></i>
-</td>
-<td class="content">
-Once this feature is enabled, there is no turning back as turning it off will lead to the deletion of all
-the mails sharing the same content once one is deleted.
-</td>
-</tr>
-</table>
-</div>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-note" title="Note"></i>
-</td>
-<td class="content">
-If you are upgrading from James 3.5 or older, the deduplication was enabled.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>Deduplication requires a garbage collector mechanism to effectively drop blobs. A first implementation
-based on bloom filters can be used and triggered using the WebAdmin REST API. See
-<a href="../operate/webadmin.html#_running_blob_garbage_collection" class="xref page">Running blob garbage collection</a>.</p>
-</div>
-<div class="paragraph">
-<p>In order to avoid concurrency issues upon garbage collection, we slice the blobs in generation, the two more recent
-generations are not garbage collected.</p>
-</div>
-<div class="paragraph">
-<p><strong>deduplication.gc.generation.duration</strong>: Allow controlling the duration of one generation. Longer implies better deduplication
-but deleted blobs will live longer. Duration, defaults on 30 days, the default unit is in days.</p>
-</div>
-<div class="paragraph">
-<p><strong>deduplication.gc.generation.family</strong>: Every time the duration is changed, this integer counter must be incremented to avoid
-conflicts. Defaults to 1.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_encryption_choice"><a class="anchor" href="#_encryption_choice"></a>Encryption choice</h3>
-<div class="paragraph">
-<p>Data can be optionally encrypted with a symmetric key using AES before being stored in the blobStore. As many user relies
-on third party for object storage, a compromised third party will not escalate to a data disclosure. Of course, a
-performance price have to be paid, as encryption takes resources.</p>
-</div>
-<div class="paragraph">
-<p><strong>encryption.aes.enable</strong> : Optional boolean, defaults to false.</p>
-</div>
-<div class="paragraph">
-<p>If AES encryption is enabled, then the following properties MUST be present:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>encryption.aes.password</strong> : String</p>
-</li>
-<li>
-<p><strong>encryption.aes.salt</strong> : Hexadecimal string</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The following properties CAN be supplied:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>encryption.aes.private.key.algorithm</strong> : String, defaulting to PBKDF2WithHmacSHA512. Previously was
-PBKDF2WithHmacSHA1.</p>
-</li>
-</ul>
-</div>
-<div class="admonitionblock warning">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-warning" title="Warning"></i>
-</td>
-<td class="content">
-Once chosen this choice can not be reverted, all the data is either clear or encrypted. Mixed encryption
-is not supported.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>Here is an example of how you can generate the above values (be mindful to customize the byte lengths in order to add
-enough entropy.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre># Password generation
-openssl rand -base64 64
-
-# Salt generation
-generate salt with : openssl rand -hex 16</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_cassandra_blobstore_cache"><a class="anchor" href="#_cassandra_blobstore_cache"></a>Cassandra BlobStore Cache</h3>
-<div class="paragraph">
-<p>A Cassandra cache can be enabled to reduce latency when reading small blobs frequently.
-A dedicated keyspace with a replication factor of one is then used.
-Cache eviction policy is TTL based.
-Only blobs below a given threshold will be stored.
-To be noted that blobs are stored within a single Cassandra row, hence a low threshold should be used.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. blobstore.properties cache related content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cache.enable</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">DEFAULT: false, optional, must be a boolean. Whether the cache should be enabled.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cache.cassandra.ttl</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">DEFAULT: 7 days, optional, must be a duration. Cache eviction policy is TTL based.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cache.sizeThresholdInBytes</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">DEFAULT: 8192, optional, must be a positive integer. Unit: bytes.
-Supported units: bytes, Kib, MiB, GiB, TiB
-Maximum size of stored objects expressed in bytes.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="sect2">
-<h3 id="_object_storage_configuration"><a class="anchor" href="#_object_storage_configuration"></a>Object storage configuration</h3>
-<div class="sect3">
-<h4 id="_aws_s3_configuration"><a class="anchor" href="#_aws_s3_configuration"></a>AWS S3 Configuration</h4>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 2. blobstore.properties S3 related properties</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.s3.endPoint</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">S3 service endpoint</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.s3.region</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">S3 region</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.s3.accessKeyId</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys">S3 access key id</a></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.s3.secretKey</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys">S3 access key secret</a></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.s3.http.concurrency</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Allow setting the number of concurrent HTTP requests allowed by the Netty driver.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.s3.truststore.path</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">optional: Verify the S3 server certificate against this trust store file.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.s3.truststore.type</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">optional: Specify the type of the trust store, e.g. JKS, PKCS12</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.s3.truststore.secret</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">optional: Use this secret/password to access the trust store; default none</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.s3.truststore.algorithm</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">optional: Use this specific trust store algorithm; default SunX509</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.s3.trustall</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">optional: boolean. Defaults to false. Cannot be set to true with other trustore options. Wether James should validate
-S3 endpoint SSL certificates.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.s3.read.timeout</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">optional: HTTP read timeout. duration, default value being second. Leaving it empty relies on S3 driver defaults.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.s3.write.timeout</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">optional: HTTP write timeout. duration, default value being second. Leaving it empty relies on S3 driver defaults.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.s3.connection.timeout</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">optional: HTTP connection timeout. duration, default value being second. Leaving it empty relies on S3 driver defaults.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.s3.in.read.limit</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">optional: Object read in memory will be rejected if they exceed the size limit exposed here. Size, exemple <code>100M</code>.
-Supported units: K, M, G, defaults to B if no unit is specified. If unspecified, big object won’t be prevented
-from being loaded in memory. This settings complements protocol limits.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.s3.upload.retry.maxAttempts</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">optional: Integer. Default is zero. This property specifies the maximum number of retry attempts allowed for failed upload operations.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.s3.upload.retry.backoffDurationMillis</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">optional: Long (Milliseconds). Default is 10 (miliseconds).
-Only takes effect when the "objectstorage.s3.upload.retry.maxAttempts" property is declared.
-This property determines the duration (in milliseconds) to wait between retry attempts for failed upload operations.
-This delay is known as backoff. The jitter factor is 0.5</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="sect3">
-<h4 id="_buckets_configuration"><a class="anchor" href="#_buckets_configuration"></a>Buckets Configuration</h4>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 3. Bucket configuration</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.bucketPrefix</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Bucket is a concept in James and similar to Containers in Swift or Buckets in AWS S3.
-BucketPrefix is the prefix of bucket names in James BlobStore</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.namespace</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">BlobStore default bucket name. Most of blobs storing in BlobStore are inside the default bucket.
-Unless a special case like storing blobs of deleted messages.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_blob_export"><a class="anchor" href="#_blob_export"></a>Blob Export</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Blob Exporting is the mechanism to help James to export a blob from an user to another user.
-It is commonly used to export deleted messages (consult <a href="/server/config-vault">configuring deleted messages vault</a>).
-The deleted messages are transformed into a blob and James will export that blob to the target user.</p>
-</div>
-<div class="paragraph">
-<p>This configuration helps you choose the blob exporting mechanism fit with your James setup and it is only applicable with Guice products.</p>
-</div>
-<div class="paragraph">
-<p>Consult <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/blob.properties">blob.properties</a>
-in GIT to get some examples and hints.</p>
-</div>
-<div class="paragraph">
-<p>Configuration for exporting blob content:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 4. blobstore.properties content</caption>
-<colgroup>
-<col style="width: 100%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">blob.export.implementation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">localFile: Local File Exporting Mechanism (explained below). Default: localFile</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">linshare: LinShare Exporting Mechanism (explained below)</p></td>
-</tr>
-</tbody>
-</table>
-<div class="sect2">
-<h3 id="_local_file_blob_export_configuration"><a class="anchor" href="#_local_file_blob_export_configuration"></a>Local File Blob Export Configuration</h3>
-<div class="paragraph">
-<p>For each request, this mechanism retrieves the content of a blob and save it to a distinct local file, then send an email containing the absolute path of that file to the target mail address.</p>
-</div>
-<div class="paragraph">
-<p>Note: that absolute file path is the file location on James server. Therefore, if there are two or more James servers connected, it should not be considered an option.</p>
-</div>
-<div class="paragraph">
-<p><strong>blob.export.localFile.directory</strong>: The directory URL to store exported blob data in files, and the URL following
-<a href="http://james.apache.org/server/3/apidocs/org/apache/james/filesystem/api/FileSystem.html">James File System scheme</a>.
-Default: <a href="file://var/blobExporting" class="bare">file://var/blobExporting</a></p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_linshare_blob_export_configuration"><a class="anchor" href="#_linshare_blob_export_configuration"></a>LinShare Blob Export Configuration</h3>
-<div class="paragraph">
-<p>Instead of exporting blobs in local file system, using <a href="https://www.linshare.org">LinShare</a>
-helps you upload your blobs and people you have been shared to can access those blobs by accessing to
-LinShare server and download them.</p>
-</div>
-<div class="paragraph">
-<p>This way helps you to share via whole network as long as they can access to LinShare server.</p>
-</div>
-<div class="paragraph">
-<p>To get an example or details explained, visit <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/blob.properties">blob.properties</a></p>
-</div>
-<div class="paragraph">
-<p><strong>blob.export.linshare.url</strong>: The URL to connect to LinShare</p>
-</div>
-<div class="paragraph">
-<p><strong>blob.export.linshare.token</strong>: The authentication token to connect to LinShare</p>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/configure/cassandra.html b/james-distributed-app/3.8.0/configure/cassandra.html
deleted file mode 100644
index f8da339..0000000
--- a/james-distributed-app/3.8.0/configure/cassandra.html
+++ /dev/null
@@ -1,627 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — cassandra.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Storage dependencies</li>
- <li><a href="cassandra.html">cassandra.properties</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/cassandra.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — cassandra.properties</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This configuration file allow setting some configuration properties in conjunction to
-Cassandra driver native configuration.</p>
-</div>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/cassandra.properties">example</a>
-to get some examples and hints.</p>
-</div>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/cassandra-driver.conf">example</a>
-to get some examples and hints for Cassandra driver native configuration.</p>
-</div>
-<div class="paragraph">
-<p>Cassandra native configuration allows configuring SSL, timeouts, logs and metrics as well as execution profiles.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_configuration"><a class="anchor" href="#_configuration"></a>Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Here are generic properties:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. cassandra.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandra.nodes</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">List of some nodes of the cassandra’s cluster in following format host:port or host, if the port is not specified we use 9042</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandra.keyspace.create</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Indicate if the keyspace should be created by James. Optional, default value: <strong>false</strong>
-If set to true James will attempt to create the keyspace when starting up.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandra.keyspace</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Is the name of the keyspace used by James. Optional, default value: <strong>apache_james</strong></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandra.user</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Username used as a credential for contacting Cassandra cluster. Optional, default is absent,
-required if <strong>cassandra.password</strong> is supplied</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandra.password</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Password used as a credential for contacting Cassandra cluster. Optional, default is absent,
-required if <strong>cassandra.user</strong> is supplied</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandra.replication.factor</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Is the replication factor used upon keyspace creation. Modifying this property while the keyspace already exists
-will have no effect. Optional. Default value 1.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandra.local.dc</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Allows specifying the local DC as part of the load balancing policy. Specifying it
-would result in the use of <code>new TokenAwarePolicy(DCAwareRoundRobinPolicy.builder().withLocalDc(value).build())</code> as a LoadBalancingPolicy.
-This value is useful in a multi-DC Cassandra setup. Be aware of <a href="../architecture/consistency-model.html#_about_multi_data_center_setups" class="xref page">limitation of multi-DC setups for James</a>
-Not specifying this value results in the driver’s default load balancing policy to be used.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">optimistic.consistency.level.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Allows specifying consistency level ONE for reads in Cassandra BlobStore.
-Falls back to default read consistency level if the blob is missing. Defaults to false.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_cassandra_mailbox_configuration"><a class="anchor" href="#_cassandra_mailbox_configuration"></a>Cassandra Mailbox Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p><strong>cassandra.properties</strong> file furthermore expose some options to tune the Cassandra Mailbox behaviour.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 2. cassandra.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailbox.read.repair.chance</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 0.1 (10% chance).
-Must be between 0 and 1 (inclusive). Controls the probability of doing a read-repair upon mailbox read.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailbox.read.repair.chance</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 0.1 (10% chance).
-Must be between 0 and 1 (inclusive). Controls the probability of doing a read-repair upon mailbox read.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailbox.counters.read.repair.chance.max</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 0.1 (10% chance).
-Must be between 0 and 1 (inclusive). Controls the probability of doing a read-repair upon mailbox counters read.
-Formula: read_repair_chance = min(mailbox.counters.read.repair.chance.max, (100/unseens)*mailbox.counters.read.repair.chance.one.hundred)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailbox.counters.read.repair.chance.one.hundred</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 0.01 (1% chance).
-Must be between 0 and 1 (inclusive). Controls the probability of doing a read-repair upon mailbox counters read.
-Formula: read_repair_chance = min(mailbox.counters.read.repair.chance.max, (100/unseens)*mailbox.counters.read.repair.chance.one.hundred)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailbox.max.retry.acl</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 1000.
-Controls the number of retries upon Cassandra ACL updates.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailbox.max.retry.modseq</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 100000.
-Controls the number of retries upon Cassandra ModSeq generation.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailbox.max.retry.uid</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 100000.
-Controls the number of retries upon Cassandra Uid generation.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailbox.max.retry.message.flags.update</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 1000.
-Controls the number of retries upon Cassandra flags update, in MessageMapper.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailbox.max.retry.message.id.flags.update</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 1000.
-Controls the number of retries upon Cassandra flags update, in MessageIdMapper.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">chunk.size.message.read</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 100.
-Controls the number of messages to be retrieved in parallel.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailbox.blob.part.size</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 102400 (100KB).
-Controls the size of blob parts used to store messages in the Cassandra blobStore.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailbox.read.strong.consistency</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Boolean, defaults to true. Disabling should be considered experimental.
-If enabled, regular consistency level is used for read transactions for mailbox. Not doing so might result
-in stale reads as the system.paxos table will not be checked for latest updates. Better performance are expected
-by turning it off. Note that reads performed as part of write transactions are always performed with a strong
-consistency.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">uid.read.strong.consistency.unsafe</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Boolean, defaults to true. Disabling should be considered experimental.
-If enabled, regular consistency level is used for read transactions for uid upon read oepration (eg IMAP status, select).
-Not doing so might result in stale reads as the system.paxos table will not be checked for latest updates.
-Better performance are expected by turning it off.
-Note that reads performed as part of write transactions are always performed with a strong consistency.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">modseq.read.strong.consistency.unsafe</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Boolean, defaults to true. Disabling should be considered experimental.
-If enabled, regular consistency level is used for read transactions for modseq upon read operation (eg IMAP status, select).
-Not doing so might result in stale reads as the system.paxos table will not be checked for latest updates.
-Better performance are expected by turning it off.
-Note that reads performed as part of write transactions are always performed with a strong consistency.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">message.read.strong.consistency</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Boolean, defaults to true. Disabling should be considered experimental.
-If enabled, regular consistency level is used for read transactions for message. Not doing so might result
-in stale reads as the system.paxos table will not be checked for latest updates. Better performance are expected
-by turning it off. Note that reads performed as part of write transactions are always performed with a strong
-consistency.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">message.write.strong.consistency.unsafe</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Boolean, defaults to true. Disabling should be considered experimental and unsafe.
-If disabled, Lightweight transactions will no longer be used upon messages operation (table <code>imapUidTable</code>).
-As message flags updates relies so far on a read-before-write model, it exposes yourself to data races leading to
-potentially update loss. Better performance are expected
-by turning it off. Reads performed as part of write transaction are also performed with a relaxed consistency.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailrepository.strong.consistency</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Boolean, defaults to true. Allows not to use lightweight transactions in CassandraMailRepository.
- If disabled we implement an idempotent behaviour (duplicates are overridden, missing entries upon deletes are ignored).</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">acl.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Boolean, defaults to true. Allows disabling ACLs: if set to false, delegation will fail and users will only
-have access to the mailboxes they own. ACLs can represent a high volume of requests. If you do not propose mailbox sharing
-features to your users, you can consider disabling them in order to improve performance.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">email.change.ttl</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Duration, default to 60 days. Cassandra Time-to-live for Email change records. Setting time-to-live to zero means refusing to use time-to-live on email changes.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailbox.change.ttl</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Duration, default to 60 days. Cassandra Time-to-live for Mailbox change records. Setting time-to-live to zero means refusing to use time-to-live on mailbox changes.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">uid.modseq.increment</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional, default to 0. Defensive value to add to uids and modseqs generated. This can be used as an heuristic to maintain
-consistency even when consensus of Lightweight Transactions is broken, exemple during a disaster recovery process.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/configure/collecting-contacts.html b/james-distributed-app/3.8.0/configure/collecting-contacts.html
deleted file mode 100644
index dc5ba2e..0000000
--- a/james-distributed-app/3.8.0/configure/collecting-contacts.html
+++ /dev/null
@@ -1,455 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Contact collection :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Extensions</li>
- <li><a href="collecting-contacts.html">Contact collection</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/collecting-contacts.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Contact collection</h1>
-<div class="sect1">
-<h2 id="_motivation"><a class="anchor" href="#_motivation"></a>Motivation</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Many modern applications combines email and contacts.</p>
-</div>
-<div class="paragraph">
-<p>We want recipients of emails sent by a user to automatically be added to this user contacts, for convenience. This
-should even be performed when a user sends emails via SMTP for example using thunderbird.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_design"><a class="anchor" href="#_design"></a>Design</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The idea is to send AMQP messages holding information about mail envelope for a traitment via a tierce application.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_configuration"><a class="anchor" href="#_configuration"></a>Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>We can achieve this goal by combining simple mailets building blocks.</p>
-</div>
-<div class="paragraph">
-<p>Here is a sample pipeline achieving aforementioned objectives :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="SenderIsLocal" class="ContactExtractor">
- <attribute>extractedContacts</attribute>
-</mailet>
-<mailet match="All" class="AmqpForwardAttribute">
- <uri>amqp://${env:JAMES_AMQP_USERNAME}:${env:JAMES_AMQP_PASSWORD}@${env:JAMES_AMQP_HOST}:${env:JAMES_AMQP_PORT}</uri>
- <exchange>collector:email</exchange>
- <attribute>extractedContacts</attribute>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>A sample message looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "userEmail": "sender@james.org",
- "emails": ["to@james.org"]
-}</pre>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/configure/collecting-events.html b/james-distributed-app/3.8.0/configure/collecting-events.html
deleted file mode 100644
index acaa991..0000000
--- a/james-distributed-app/3.8.0/configure/collecting-events.html
+++ /dev/null
@@ -1,489 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Event collection :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Extensions</li>
- <li><a href="collecting-events.html">Event collection</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/collecting-events.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Event collection</h1>
-<div class="sect1">
-<h2 id="_motivation"><a class="anchor" href="#_motivation"></a>Motivation</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Many calendar application do add events invitation received by email directly in ones calendar.</p>
-</div>
-<div class="paragraph">
-<p>Such behaviours requires the calendar application to be aware of the ICalendar related emails a user received.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_design"><a class="anchor" href="#_design"></a>Design</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The idea is to write a portion of mailet pipeline extracting Icalendar attachments and to hold them as attachments that
-can later be sent to other applications over AMQP to be treated in an asynchronous, decoupled fashion.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_configuration"><a class="anchor" href="#_configuration"></a>Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>We can achieve this goal by combining simple mailets building blocks.</p>
-</div>
-<div class="paragraph">
-<p>Here is a sample pipeline achieving aforementioned objectives :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><!-- ICAL pipeline -->
-<mailet match="All" class="StripAttachment">
- <mimeType>text/calendar</mimeType>
- <attribute>rawIcalendar</attribute>
-</mailet>
-<mailet match="All" class="MimeDecodingMailet">
- <attribute>rawIcalendar</attribute>
-</mailet>
-<mailet match="All" class="ICalendarParser">
- <sourceAttribute>rawIcalendar</sourceAttribute>
- <destinationAttribute>icalendar</destinationAttribute>
-</mailet>
-<mailet match="All" class="ICALToHeader">
- <attribute>icalendar</attribute>
-</mailet>
-<mailet match="All" class="ICALToJsonAttribute">
- <source>icalendar</source>
- <destination>icalendarAsJson</destination>
- <rawSource>rawIcalendar</rawSource>
-</mailet>
-<mailet match="All" class="AmqpForwardAttribute">
- <uri>amqp://${env:JAMES_AMQP_USERNAME}:${env:JAMES_AMQP_PASSWORD}@${env:JAMES_AMQP_HOST}:${env:JAMES_AMQP_PORT}</uri>
- <exchange>james:events</exchange>
- <attribute>icalendarAsJson</attribute>
-</mailet>
-<!-- End of ICAL pipeline --></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>A sample message looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "ical": "RAW_DATA_AS_TEXT_FOLLOWING_ICS_FORMAT",
- "sender": "other@james.apache.org",
- "recipient": "any@james2.apache.org",
- "replyTo": "other@james.apache.org",
- "uid": "f1514f44bf39311568d640727cff54e819573448d09d2e5677987ff29caa01a9e047feb2aab16e43439a608f28671ab7c10e754ce92be513f8e04ae9ff15e65a9819cf285a6962bc",
- "dtstamp": "20170106T115036Z",
- "method": "REQUEST",
- "sequence": "0",
- "recurrence-id": null
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The following pipeline positions the X-MEETING-UID in the Header in order for mail user agent to correlate events with this mail.
-The sample look like:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">X-MEETING-UID: f1514f44bf39311568d640727cff54e819573448d09d2e5677987ff29caa01a9e047feb2aab16e43439a608f28671ab7c10e754ce92be513f8e04ae9ff15e65a9819cf285a6962bc</code></pre>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/configure/dns.html b/james-distributed-app/3.8.0/configure/dns.html
deleted file mode 100644
index cf7b77c..0000000
--- a/james-distributed-app/3.8.0/configure/dns.html
+++ /dev/null
@@ -1,475 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — dnsservice.xml :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Core components</li>
- <li><a href="dns.html">dnsservice.xml</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/dns.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — dnsservice.xml</h1>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/dnsservice.xml">example</a>
-to get some examples and hints.</p>
-</div>
-<div class="paragraph">
-<p>Specifies DNS Server information for use by various components inside Apache James Server.</p>
-</div>
-<div class="paragraph">
-<p>DNS Transport services are controlled by a configuration block in
-the dnsservice.xml. This block affects SMTP remote delivery.</p>
-</div>
-<div class="paragraph">
-<p>The dnsservice tag defines the boundaries of the configuration
-block. It encloses all the relevant configuration for the DNS server.
-The behavior of the DNS service is controlled by the attributes and
-children of this tag.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. dnsservice.xml content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">servers</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Information includes a list of DNS Servers to be used by James. These are
-specified by the server elements, each of which is a child element of the
-servers element. Each server element is the IP address of a single DNS server.
-The server elements can have multiple server children. Enter ip address of your DNS server, one IP address per server
-element. If no DNS servers are found and you have not specified any below, 127.0.0.1 will be used</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">autodiscover</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false - If you use autodiscover and add DNS servers manually a combination of all the DNS servers will be used.
-If autodiscover is true, James will attempt to autodiscover the DNS servers configured on your underlying system.
-Currently, this works if the OS has a unix-like /etc/resolv.xml,
-or the system is Windows based with ipconfig or winipcfg. Change autodiscover to false if you would like to turn off autodiscovery
-and set the DNS servers manually in the servers section</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">authoritative</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>true/false</strong> - This tag specifies whether or not
-to require authoritative (non-cached) DNS records; to only accept DNS responses that are
-authoritative for the domain. It is primarily useful in an intranet/extranet environment.
-This should always be <strong>false</strong> unless you understand the implications.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">maxcachesize</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Maximum number of entries to maintain in the DNS cache (typically 50000)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">negativeCacheTTL</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Sets the maximum length of time that negative records will be stored in the DNS negative cache in
-seconds (a negative record means the name has not been found in the DNS). Values for this cache
-can be positive meaning the time in seconds before retrying to resolve the name, zero meaning no
-cache or a negative value meaning infinite caching.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">singleIPperMX</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false (default) - Specifies if Apache James Server must try a single server for each multihomed mx host</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">verbose</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Turn on general debugging statements</p></td>
-</tr>
-</tbody>
-</table>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/configure/domainlist.html b/james-distributed-app/3.8.0/configure/domainlist.html
deleted file mode 100644
index a9b85a2..0000000
--- a/james-distributed-app/3.8.0/configure/domainlist.html
+++ /dev/null
@@ -1,461 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — domainlist.xml :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Core components</li>
- <li><a href="domainlist.html">domainlist.xml</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/domainlist.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — domainlist.xml</h1>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/domainlist.xml">example</a>
-to get some examples and hints.</p>
-</div>
-<div class="paragraph">
-<p>This configuration block is defined by the <strong>domainlist</strong> tag.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. domainlist.xml content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">domainnames</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Domainnames identifies the DNS namespace served by this instance of James.
-These domainnames are used for both matcher/mailet processing and SMTP auth
-to determine when a mail is intended for local delivery - Only applicable for XMLDomainList. The entries mentionned here will be created upon start.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">autodetect</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false - If autodetect is true, James wil attempt to discover its own host name AND
-use any explicitly specified servernames.
-If autodetect is false, James will use only the specified domainnames. Defaults to false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">autodetectIP</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false - If autodetectIP is not false, James will also allow add the IP address for each servername.
-The automatic IP detection is to support RFC 2821, Sec 4.1.3, address literals. Defaults to false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">defaultDomain</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the default domain which will be used if an email is send to a recipient without a domain part.
-If no defaultdomain is set the first domain of the DomainList gets used. If the default is not yet contained by the Domain List, the domain will be created upon start.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">read.cache.enable</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Experimental. Boolean, defaults to false.
-Whether or not to cache domainlist.contains calls. Enable a faster execution however writes will take time
-to propagate.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">read.cache.expiracy</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Experimental. String (duration), defaults to 10 seconds (10s). Supported units are ms, s, m, h, d, w, month, y.
-Expiracy of the cache. Longer means less reads are performed to the backend but writes will take longer to propagate.
-Low values (a few seconds) are advised.</p></td>
-</tr>
-</tbody>
-</table>
-<div class="paragraph">
-<p>To override autodetected domainnames simply add explicit domainname elements.
-In most cases this will be necessary. By default, the domainname 'localhost' is specified. This can be removed, if required.</p>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/configure/dsn.html b/james-distributed-app/3.8.0/configure/dsn.html
deleted file mode 100644
index 8d998af..0000000
--- a/james-distributed-app/3.8.0/configure/dsn.html
+++ /dev/null
@@ -1,663 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Delivery Submission Notifications :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Extensions</li>
- <li><a href="dsn.html">ESMTP DSN support</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/dsn.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Delivery Submission Notifications</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>DSN introduced in <a href="https://tools.ietf.org/html/rfc3461">RFC-3461</a> allows a SMTP sender to demand status messages,
-defined in <a href="https://tools.ietf.org/html/rfc3464">RFC-3464</a> to be sent back to the <code>Return-Path</code> upon delivery
-progress.</p>
-</div>
-<div class="paragraph">
-<p>DSN support is not enabled by default, as it needs specific configuration of the
-<a href="mailetcontainer.html" class="xref page">mailetcontainer.xml</a> to be specification compliant.</p>
-</div>
-<div class="paragraph">
-<p>To enable it you need to:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Add DSN SMTP hooks as part of the SMTP server stack</p>
-</li>
-<li>
-<p>Configure <a href="mailetcontainer.html" class="xref page">mailetcontainer.xml</a> to generate DSN bounces when needed</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_enabling_dsn_in_smtp_server_stack"><a class="anchor" href="#_enabling_dsn_in_smtp_server_stack"></a>Enabling DSN in SMTP server stack</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>For this simply add the <code>DSN hooks</code> in the handler chain in <code>smtpserver.xml</code> :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><smtpserver enabled="true">
- <...> <!-- The rest of your SMTP configuration, unchanged -->
- <handlerchain>
- <handler class="org.apache.james.smtpserver.dsn.DSNEhloHook"/>
- <handler class="org.apache.james.smtpserver.dsn.DSNMailParameterHook"/>
- <handler class="org.apache.james.smtpserver.dsn.DSNRcptParameterHook"/>
- <handler class="org.apache.james.smtpserver.dsn.DSNMessageHook"/>
- <...> <!-- other handlers, like: -->
- <handler class="org.apache.james.smtpserver.CoreCmdHandlerLoader"/> <!-- for instance -->
- </handlerchain>
-</smtpserver></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_enabling_dsn_generation_as_part_of_mail_processing"><a class="anchor" href="#_enabling_dsn_generation_as_part_of_mail_processing"></a>Enabling DSN generation as part of mail processing</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>For the below conditions to be matched we assume you follow
-<a href="remote-delivery-error-handling.html" class="xref page">RemoteDelivery error handling for MXs</a>, which is a
-requirement for detailed RemoteDelivery error and delay handling on top of the Distributed server.</p>
-</div>
-<div class="paragraph">
-<p>Here is a sample <a href="mailetcontainer.html" class="xref page">mailetcontainer.xml</a> achieving the following DSN generation:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Generate a generic <code>delivered</code> notification if LocalDelivery succeeded, if requested</p>
-</li>
-<li>
-<p>Generate a generic <code>failed</code> notification in case of local errors, if requested</p>
-</li>
-<li>
-<p>Generate a specific <code>failed</code> notification in case of a non existing local user, if requested</p>
-</li>
-<li>
-<p>Generate a specific <code>failed</code> notification in case of an address rewriting loop, if requested</p>
-</li>
-<li>
-<p>Generate a <code>failed</code> notification in case of remote permanent errors, if requested. We blame the remote server…​</p>
-</li>
-<li>
-<p>Generate a <code>delayed</code> notification in case of temporary remote errors we are about to retry, if requested. We blame the remote server…​</p>
-</li>
-<li>
-<p>Generate a <code>failed</code> notification in case of temporary remote errors we are not going to retry (failed too many time), if requested. We blame the remote server…​</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailetcontainer enableJmx="true">
- <!-- Common processing settings are unchanged -->
-
- <processors>
- <processor state="root" enableJmx="true">\
- <!-- Content of root processor is unchanged -->
- </processor>
-
- <processor state="transport" enableJmx="true">
- <!-- transport processor unchanged -->
- </processor>
-
- <processor state="error" enableJmx="true">
- <mailet match="DSNFailureRequested" class="DSNBounce">
- <prefix>[FAILED]</prefix>
- <passThrough>true</passThrough>
- <messageString>Hi. This is the James mail server at [machine].
-I'm afraid I wasn't able to deliver your message to the following addresses.
-This is a permanent error; I've given up. Sorry it didn't work out. Below
-I include the list of recipients, and the reason why I was unable to deliver
-your message.</messageString>
- <action>failed</action>
- <defaultStatus>5.0.0</defaultStatus>
- </mailet>
- <mailet match="All" class="ToRepository">
- <repositoryPath>cassandra://var/mail/error/</repositoryPath>
- </mailet>
- </processor>
-
- <processor state="local-delivery" enableJmx="true">
- <!-- Your local-delivery pipeline -->
- <mailet match="All" class="LocalDelivery">
- <!-- Do not abort the pipeline yet -->
- <consume>false</consume>
- </mailet>
- <!-- Tell the world we succeeded -->
- <mailet match="DSNSuccessRequested" class="DSNBounce">
- <prefix>[SUCCESS]</prefix>
- <passThrough>true</passThrough>
- <messageString>Hi. This is the James mail server at [machine].
-I successfully delivered your message to the following addresses.
-Note that it indicates your recipients received the message but do
-not imply they read it.</messageString>
- <action>delivered</action>
- <defaultStatus>2.0.0</defaultStatus>
- </mailet>
- <mailet match="All" class="Null"/> <!-- ignore people not having requesting a dsn success bounce -->
- </processor>
-
- <processor state="relay" enableJmx="true">
- <!-- Perform at most 5 RemoteDelivery attempts -->
- <mailet match="AtMost=5" class="RemoteDelivery">
- <outgoingQueue>outgoing</outgoingQueue>
- <maxRetries>0</maxRetries>
- <maxDnsProblemRetries>0</maxDnsProblemRetries>
- <deliveryThreads>10</deliveryThreads>
- <sendpartial>true</sendpartial>
- <!-- Use a custom processor for error handling -->
- <bounceProcessor>remote-delivery-error</bounceProcessor>
- </mailet>
- <!-- When retries are exceeded, consider the mail as a permanent failure -->
- <mailet match="DSNFailureRequested" class="DSNBounce">
- <prefix>[FAILED]</prefix>
- <passThrough>true</passThrough>
- <messageString>Hi. This is the James mail server at [machine].
-I'm afraid I wasn't able to deliver your message to the following addresses.
-This is a permanent error; I've given up. Sorry it didn't work out.
-The remote server we should relay this mail to keep on failing.
-Below I include the list of recipients, and the reason why I was unable to deliver
-your message.</messageString>
- <action>failed</action>
- <defaultStatus>5.0.0</defaultStatus>
- </mailet>
- <mailet match="All" class="ToRepository">
- <repositoryPath>cassandra://var/mail/error/remote-delivery/permanent/</repositoryPath>
- </mailet>
- </processor>
-
- <processor state="remote-delivery-error" enableJmx="true">
- <matcher name="dsn-permanent" match="org.apache.james.mailetcontainer.impl.matchers.And">
- <matcher match="IsRemoteDeliveryPermanentError"/>
- <matcher match="DSNFailureRequested"/>
- </matcher>
- <matcher name="dsn-temporary" match="org.apache.james.mailetcontainer.impl.matchers.And">
- <matcher match="IsRemoteDeliveryTemporaryError"/>
- <matcher match="DSNDelayRequested"/>
- </matcher>
-
- <mailet match="dsn-permanent" class="DSNBounce">
- <prefix>[FAILED]</prefix>
- <passThrough>true</passThrough>
- <messageString>Hi. This is the James mail server at [machine].
-I'm afraid I wasn't able to deliver your message to the following addresses.
-This is a permanent error; I've given up. Sorry it didn't work out.
-The remote server we should relay this mail to returns a permanent error.
-Below I include the list of recipients, and the reason why I was unable to deliver
-your message.</messageString>
- <action>failed</action>
- <defaultStatus>5.0.0</defaultStatus>
- </mailet>
-
- <mailet match="dsn-temporary" class="DSNBounce">
- <prefix>[DELAYED]</prefix>
- <passThrough>true</passThrough>
- <messageString>Hi. This is the James mail server at [machine].
-I'm afraid I wasn't able to deliver your message to the following addresses yet.
-This is a temporary error: I will keep on trying.
-Below I include the list of recipients, and the reason why I was unable to deliver
-your message.</messageString>
- <action>delayed</action>
- <defaultStatus>4.0.0</defaultStatus>
- </mailet>
-
- <!-- Error management for remote delivery error handling as described in remote-delivery-error-handling.adoc -->
- </processor>
-
- <processor state="local-address-error" enableJmx="true">
- <mailet match="DSNFailureRequested" class="DSNBounce">
- <prefix>[FAILED]</prefix>
- <passThrough>true</passThrough>
- <messageString>Hi. This is the James mail server at [machine].
-I'm afraid I wasn't able to deliver your message to the following addresses.
-This is a permanent error; I've given up. Sorry it didn't work out.
-The following addresses do not exist here. Sorry.</messageString>
- <action>failed</action>
- <defaultStatus>5.0.0</defaultStatus>
- </mailet>
- <mailet match="All" class="ToRepository">
- <repositoryPath>cassandra://var/mail/address-error/</repositoryPath>
- </mailet>
- </processor>
-
- <processor state="relay-denied" enableJmx="true">
- <!-- This is an abuse, you likely do not want to be polite with these people. we just keep a copy for later audit & replay -->
- <mailet match="All" class="ToRepository">
- <repositoryPath>cassandra://var/mail/relay-denied/</repositoryPath>
- <notice>Warning: You are sending an e-mail to a remote server. You must be authenticated to perform such an operation</notice>
- </mailet>
- </processor>
-
- <processor state="rrt-error" enableJmx="false">
- <mailet match="All" class="ToRepository">
- <repositoryPath>cassandra://var/mail/rrt-error/</repositoryPath>
- <passThrough>true</passThrough>
- </mailet>
- <mailet match="IsSenderInRRTLoop" class="Null"/>
- <mailet match="DSNFailureRequested" class="DSNBounce">
- <prefix>[FAILED]</prefix>
- <passThrough>true</passThrough>
- <messageString>Hi. This is the James mail server at [machine].
-I'm afraid I wasn't able to deliver your message to the following addresses.
-This is a permanent error; I've given up. Sorry it didn't work out.
-The following addresses is caught in a rewriting loop. An admin should come and fix it (you likely want to report it).
-Once resolved the admin should be able to resume the processing of your email.
-Below I include the list of recipients, and the reason why I was unable to deliver
-your message.</messageString>
- <action>failed</action>
- <defaultStatus>5.1.6/defaultStatus>
- </mailet>
- </processor>
- </processors>
-</mailetcontainer></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_limitations"><a class="anchor" href="#_limitations"></a>Limitations</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The out of the box tooling do not allow generating <code>relayed</code> DSN notification as RemoteDelivery misses a success
-callback.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/configure/extensions.html b/james-distributed-app/3.8.0/configure/extensions.html
deleted file mode 100644
index 66bf16e..0000000
--- a/james-distributed-app/3.8.0/configure/extensions.html
+++ /dev/null
@@ -1,473 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — extensions.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Extensions</li>
- <li><a href="extensions.html">extensions.properties</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/extensions.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — extensions.properties</h1>
-<div class="paragraph">
-<p>This files enables an operator to define additional bindings used to instantiate others extensions</p>
-</div>
-<div class="paragraph">
-<p><strong>guice.extension.module</strong>: come separated list of fully qualified class name. These classes need to implement Guice modules.</p>
-</div>
-<div class="paragraph">
-<p>Here is an example of such a class :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>public class MyServiceModule extends AbstractModule {
- @Override
- protected void configure() {
- bind(MyServiceImpl.class).in(Scopes.SINGLETON);
- bind(MyService.class).to(MyServiceImpl.class);
- }
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Recording it in extensions.properties :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>guice.extension.module=com.project.MyServiceModule</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Enables to inject MyService into your extensions.</p>
-</div>
-<div class="paragraph">
-<p><strong>guice.extension.tasks</strong>: come separated list of fully qualified class name.</p>
-</div>
-<div class="paragraph">
-<p>The extension can rely on the Task manager to supervise long-running task execution (progress, await, cancellation, scheduling…​).
-These extensions need to implement Task extension modules.</p>
-</div>
-<div class="paragraph">
-<p>Here is an example of such a class :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>public class RspamdTaskExtensionModule implements TaskExtensionModule {
-
- @Inject
- public RspamdTaskExtensionModule() {
- }
-
- @Override
- public Set<TaskDTOModule<? extends Task, ? extends TaskDTO>> taskDTOModules() {
- return Set.of(...);
- }
-
- @Override
- public Set<AdditionalInformationDTOModule<? extends TaskExecutionDetails.AdditionalInformation, ? extends AdditionalInformationDTO>> taskAdditionalInformationDTOModules() {
- return Set.of(...);
- }
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Recording it in extensions.properties :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>guice.extension.tasks=com.project.RspamdTaskExtensionModule</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Read <a href="../extending/index.html#_defining_custom_injections_for_your_extensions" class="xref page">this page</a> for more details.</p>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/configure/healthcheck.html b/james-distributed-app/3.8.0/configure/healthcheck.html
deleted file mode 100644
index a77bf8a..0000000
--- a/james-distributed-app/3.8.0/configure/healthcheck.html
+++ /dev/null
@@ -1,440 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — healthcheck.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Core components</li>
- <li><a href="healthcheck.html">healthcheck.properties</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/healthcheck.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — healthcheck.properties</h1>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/healthcheck.properties">example</a>
-to get some examples and hints.</p>
-</div>
-<div class="paragraph">
-<p>Use this configuration to define the initial delay and period for the PeriodicalHealthChecks. It is only applicable with Guice products.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. healthcheck.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">healthcheck.period</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Define the period between two periodical health checks (default: 60s). Units supported are (ms - millisecond, s - second, m - minute, h - hour, d - day). Default unit is millisecond.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">reception.check.user</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">User to be using for running the "mail reception" health check. The user must exist.
-If not specified, the mail reception check is a noop.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">reception.check.timeout</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Period after which mail reception is considered faulty. Defaults to one minute.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">additional.healthchecks</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">List of fully qualified HealthCheck class names in addition to James' default healthchecks. Default to empty list.</p></td>
-</tr>
-</tbody>
-</table>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/configure/imap.html b/james-distributed-app/3.8.0/configure/imap.html
deleted file mode 100644
index b08c4b2..0000000
--- a/james-distributed-app/3.8.0/configure/imap.html
+++ /dev/null
@@ -1,647 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — imapserver.xml :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Protocols</li>
- <li><a href="imap.html">imapserver.xml</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/imap.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — imapserver.xml</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/imapserver.xml">example</a>
-to get some examples and hints.</p>
-</div>
-<div class="paragraph">
-<p>The IMAP4 service is controlled by a configuration block in the imap4server.xml.
-The imap4server tag defines the boundaries of the configuration block. It encloses
-all the relevant configuration for the IMAP4 server. The behavior of the IMAP4 service is
-controlled by the attributes and children of this tag.</p>
-</div>
-<div class="paragraph">
-<p>This tag has an optional boolean attribute - <strong>enabled</strong> - that defines whether the service is active or not.
-The value defaults to "true" if not present.</p>
-</div>
-<div class="paragraph">
-<p>The standard children of the imapserver tag are:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. imapserver.xml content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">bind</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure this to bind to a specific inetaddress. This is an optional integer value. This value is the port on which this IMAP4 server is configured
-to listen. If the tag or value is absent then the service
-will bind to all network interfaces for the machine If the tag or value is omitted, the value will default to the standard IMAP4 port
-port 143 is the well-known/IANA registered port for IMAP
-port 993 is the well-known/IANA registered port for IMAPS ie over SSL/TLS</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connectionBacklog</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Number of connection backlog of the server (maximum number of queued connection requests)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">compress</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false - Use or don’t use COMPRESS extension. Defaults to false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">maxLineLength</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Maximal allowed line-length before a BAD response will get returned to the client
-This should be set with caution as a to high value can make the server a target for DOS (Denial of Service)!</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">inMemorySizeLimit</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Size limit before we will start to stream to a temporary file.
-Defaults to 10MB. Must be a positive integer, optionally with a unit: B, K, M, G.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">literalSizeLimit</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Maximum size of a literal (IMAP APPEND).
-Defaults to 0 (unlimited). Must be a positive integer, optionally with a unit: B, K, M, G.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">plainAuthDisallowed</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated. Should use <code>auth.plainAuthEnabled</code>, <code>auth.requireSSL</code> instead.
-Whether to enable Authentication PLAIN if the connection is not encrypted via SSL or STARTTLS. Defaults to <code>true</code>.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">auth.plainAuthEnabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Whether to enable Authentication PLAIN/ LOGIN command. Defaults to <code>true</code>.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">auth.requireSSL</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false. Defaults to <code>true</code>. Whether to require SSL to authenticate. If this is required, the IMAP server will disable authentication on unencrypted channels.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">auth.oidc.oidcConfigurationURL</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Provide OIDC url address for information to user. Only configure this when you want to authenticate IMAP server using a OIDC provider.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">auth.oidc.jwksURL</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Provide url to get OIDC’s JSON Web Key Set to validate user token. Only configure this when you want to authenticate IMAP server using a OIDC provider.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">auth.oidc.claim</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Claim string uses to identify user. E.g: "email_address". Only configure this when you want to authenticate IMAP server using a OIDC provider.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">auth.oidc.scope</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">An OAuth scope that is valid to access the service (RF: RFC7628). Only configure this when you want to authenticate IMAP server using a OIDC provider.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">timeout</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Default to 30 minutes. After this time, inactive channels that have not performed read, write, or both operation for a while
-will be closed. Negative value disable this behaviour.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">enableIdle</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Default to true. If enabled IDLE commands will generate a server heartbeat on a regular period.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">idleTimeInterval</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Defaults to 120. Needs to be a strictly positive integer.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">idleTimeIntervalUnit</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Default to SECONDS. Needs to be a parseable TimeUnit.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">disabledCaps</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Implemented server capabilities NOT to advertise to the client. Coma separated list. Defaults to no disabled capabilities.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jmxName</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The name given to the configuration</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tls</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set to true to support STARTTLS or SSL for the Socket.
-To use this you need to copy sunjce_provider.jar to /path/james/lib directory. To create a new keystore execute:
-<code>keytool -genkey -alias james -keyalg RSA -storetype PKCS12 -keystore /path/to/james/conf/keystore</code>.
-Please note that each IMAP server exposed on different port can specify its own keystore, independently from any other
-TLS based protocols.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">handler.helloName</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">This is the name used by the server to identify itself in the IMAP4
-protocol. If autodetect is TRUE, the server will discover its
-own host name and use that in the protocol. If discovery fails,
-the value of 'localhost' is used. If autodetect is FALSE, James
-will use the specified value.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connectiontimeout</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Connection timeout in seconds</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connectionLimit</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum simultaneous incoming connections for this service</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connectionLimitPerIP</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum simultaneous incoming connections per IP for this service</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">concurrentRequests</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Maximum number of IMAP requests executed simultaneously. Past that limit requests are queued. Defaults to 20.
-Negative values deactivate this feature, leading to unbounded concurrency.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">maxQueueSize</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Upper bound to the IMAP throttler queue. Upon burst, requests that cannot be queued are rejected and not executed.
-Integer, defaults to 4096, must be positive, 0 means no queue.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">proxyRequired</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Enables proxy support for this service for incoming connections. HAProxy’s protocol
-(<a href="https://www.haproxy.org/download/2.7/doc/proxy-protocol.txt" class="bare">https://www.haproxy.org/download/2.7/doc/proxy-protocol.txt</a>) is used and might be compatible
-with other proxies (e.g. traefik). If enabled, it is <strong>required</strong> to initiate the connection
-using HAProxy’s proxy protocol.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">bossWorkerCount</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum count of boss threads. Boss threads are responsible for accepting incoming IMAP connections
-and initializing associated resources. Optional integer, by default, boss threads are not used and this responsibility is being dealt with
-by IO threads.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ioWorkerCount</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum count of IO threads. IO threads are responsible for receiving incoming IMAP messages and framing them
-(split line by line). IO threads also take care of compression and SSL encryption. Their tasks are short-lived and non-blocking.
-Optional integer, defaults to 2 times the count of CPUs.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ignoreIDLEUponProcessing</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false - Allow disabling the heartbeat handler. Defaults to true.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_oidc_setup"><a class="anchor" href="#_oidc_setup"></a>OIDC setup</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>James IMAP support XOAUTH2 authentication mechanism which allow authenticating against a OIDC providers.
-Please configure <code>auth.oidc</code> part to use this.</p>
-</div>
-<div class="paragraph">
-<p>We do supply an <a href="https://github.com/apache/james-project/tree/master/examples/oidc">example</a> of such a setup.
-It uses the Keycloak OIDC provider, but usage of similar technologies is definitely doable.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_extending_imap"><a class="anchor" href="#_extending_imap"></a>Extending IMAP</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>IMAP decoders, processors and encoder can be customized. <a href="../extending/imap.html" class="xref page">Read more</a>.</p>
-</div>
-<div class="paragraph">
-<p>Check this <a href="https://github.com/apache/james-project/tree/master/examples/custom-imap">example</a>.</p>
-</div>
-<div class="paragraph">
-<p>The following configuration properties are available for extensions:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 2. imapserver.xml content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">imapPackages</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure (union) of IMAP packages. IMAP packages bundles decoders (parsing IMAP commands) processors and encoders,
-thus enable implementing new IMAP commands or replace existing IMAP processors. List of FQDNs, which can be located in
-James extensions.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">additionalConnectionChecks</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure (union) of additional connection checks. ConnectionCheck will check if the connection IP is secure or not.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">customProperties</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Properties for custom extension. Each tag is a property entry, and holds a string under the form key=value.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_mail_user_agents_auto_configuration"><a class="anchor" href="#_mail_user_agents_auto_configuration"></a>Mail user agents auto-configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Check this example on <a href="https://github.com/apache/james-project/tree/master/examples/imap-autoconf">Mail user agents auto-configuration</a>.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/configure/index.html b/james-distributed-app/3.8.0/configure/index.html
deleted file mode 100644
index 42fbea5..0000000
--- a/james-distributed-app/3.8.0/configure/index.html
+++ /dev/null
@@ -1,624 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Configuration :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item is-current-page" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/index.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Configuration</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This section presents how to configure the Distributed server.</p>
-</div>
-<div class="paragraph">
-<p>The Distributed Server relies on separated files for configuring various components. Some files follow a <strong>xml</strong> format
-and some others follow a <strong>property</strong> format. Some files can be omitted, in which case the functionality can be disabled,
-or rely on reasonable defaults.</p>
-</div>
-<div class="paragraph">
-<p>The following configuration files are exposed:</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_for_protocols"><a class="anchor" href="#_for_protocols"></a>For protocols</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>By omitting these files, the underlying protocols will be disabled.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="imap.html" class="xref page"><strong>imapserver.xml</strong></a> allows configuration for the IMAP protocol <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/imapserver.xml">example</a></p>
-</li>
-<li>
-<p><a href="jmap.html" class="xref page"><strong>jmap.properties</strong></a> allows to configure the JMAP protocol <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/jmap.properties">example</a></p>
-</li>
-<li>
-<p><a href="jmx.html" class="xref page"><strong>jmx.properties</strong></a> allows configuration of JMX being used by the Command Line Interface <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/jmx.properties">example</a></p>
-</li>
-<li>
-<p><a href="smtp.html#_lmtp_configuration" class="xref page"><strong>lmtpserver.xml</strong></a> allows configuring the LMTP protocol <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/lmtpserver.xml">example</a></p>
-</li>
-<li>
-<p><strong>managesieveserver.xml</strong> allows configuration for ManagedSieve (unsupported) <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/managesieveserver.xml">example</a></p>
-</li>
-<li>
-<p><a href="pop3.html" class="xref page"><strong>pop3server.xml</strong></a> allows configuration for the POP3 protocol (experimental) <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/pop3server.xml">example</a></p>
-</li>
-<li>
-<p><a href="smtp.html" class="xref page"><strong>smtpserver.xml</strong></a> allows configuration for the SMTP protocol <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/smtpserver.xml">example</a></p>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="smtp-hooks.html" class="xref page">This page</a> list SMTP hooks that can be used out of the box with the Distributed Server.</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p><a href="webadmin.html" class="xref page"><strong>webadmin.properties</strong></a> enables configuration for the WebAdmin protocol <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/webadmin.properties">example</a></p>
-</li>
-<li>
-<p><a href="ssl.html" class="xref page">This page</a> details SSL & TLS configuration.</p>
-</li>
-<li>
-<p><a href="sieve.html" class="xref page">This page</a> details Sieve setup and how to enable ManageSieve.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_for_storage_dependencies"><a class="anchor" href="#_for_storage_dependencies"></a>For storage dependencies</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Except specific documented cases, these files are required, at least to establish a connection with the storage components.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="blobstore.html" class="xref page"><strong>blobstore.properties</strong></a> allows to configure the BlobStore <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/blob.properties">example</a></p>
-</li>
-<li>
-<p><a href="cassandra.html" class="xref page"><strong>cassandra.properties</strong></a> allows to configure the Cassandra driver <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/cassandra.properties">example</a></p>
-</li>
-<li>
-<p><a href="opensearch.html" class="xref page"><strong>opensearch.properties</strong></a> allows to configure OpenSearch driver <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/opensearch.properties">example</a></p>
-</li>
-<li>
-<p><a href="rabbitmq.html" class="xref page"><strong>rabbitmq.properties</strong></a> allows configuration for the RabbitMQ driver <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/rabbitmq.properties">example</a></p>
-</li>
-<li>
-<p><a href="redis.html" class="xref page"><strong>redis.properties</strong></a> allows configuration for the Redis driver <a href="https://github.com/apache/james-project/blob/fabfdf4874da3aebb04e6fe4a7277322a395536a/server/mailet/rate-limiter-redis/redis.properties">example</a>, that is used by optional
-distributed rate limiting component.</p>
-</li>
-<li>
-<p><a href="tika.html" class="xref page"><strong>tika.properties</strong></a> allows configuring Tika as a backend for text extraction <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/tika.properties">example</a></p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_for_core_components"><a class="anchor" href="#_for_core_components"></a>For core components</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>By omitting these files, sane default values are used.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="batchsizes.html" class="xref page"><strong>batchsizes.properties</strong></a> allows to configure mailbox read batch sizes <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/batchsizes.properties">example</a></p>
-</li>
-<li>
-<p><a href="dns.html" class="xref page"><strong>dnsservice.xml</strong></a> allows to configure DNS resolution <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/dnsservice.xml">example</a></p>
-</li>
-<li>
-<p><a href="domainlist.html" class="xref page"><strong>domainlist.xml</strong></a> allows to configure Domain storage <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/domainlist.xml">example</a></p>
-</li>
-<li>
-<p><a href="healthcheck.html" class="xref page"><strong>healthcheck.properties</strong></a> allows to configure periodical healthchecks <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/healthcheck.properties">example</a></p>
-</li>
-<li>
-<p><a href="mailetcontainer.html" class="xref page"><strong>mailetcontainer.xml</strong></a> allows configuring mail processing <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/mailetcontainer.xml">example</a></p>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="mailets.html" class="xref page">This page</a> list matchers that can be used out of the box with the Distributed Server.</p>
-</li>
-<li>
-<p><a href="matchers.html" class="xref page">This page</a> list matchers that can be used out of the box with the Distributed Server.</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p><a href="mailrepositorystore.html" class="xref page"><strong>mailrepositorystore.xml</strong></a> enables registration of allowed MailRepository protcols and link them to MailRepository implementations <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/mailrepositorystore.xml">example</a></p>
-</li>
-<li>
-<p><a href="recipientrewritetable.html" class="xref page"><strong>recipientrewritetable.xml</strong></a> enables advanced configuration for the Recipient Rewrite Table component <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/recipientrewritetable.xml">example</a></p>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="matchers.html" class="xref page">This page</a> allows choosing the indexing technology.</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p><a href="usersrepository.html" class="xref page"><strong>usersrepository.xml</strong></a> allows configuration of user storage <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/usersrepository.xml">example</a></p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_for_extensions"><a class="anchor" href="#_for_extensions"></a>For extensions</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>By omitting these files, no extra behaviour is added.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="vault.html" class="xref page"><strong>deletedMessageVault.properties</strong></a> allows to configure the DeletedMessageVault <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/deletedMessageVault.properties">example</a></p>
-</li>
-<li>
-<p><a href="listeners.html" class="xref page"><strong>listeners.xml</strong></a> enables configuration of Mailbox Listeners <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/listeners.xml">example</a></p>
-</li>
-<li>
-<p><a href="extensions.html" class="xref page"><strong>extensions.properties</strong></a> allows to extend James behaviour by loading your extensions in it <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/extensions.properties">example</a></p>
-</li>
-<li>
-<p><a href="jvm.html" class="xref page"><strong>jvm.properties</strong></a> lets you specify additional system properties without cluttering your command line</p>
-</li>
-<li>
-<p><a href="spam.html" class="xref page">This page</a> documents Anti-Spam setup with SpamAssassin, Rspamd.</p>
-</li>
-<li>
-<p><a href="remote-delivery-error-handling.html" class="xref page">This page</a> proposes a simple strategy for RemoteDelivery error handling.</p>
-</li>
-<li>
-<p><a href="collecting-contacts.html" class="xref page">This page</a> documents contact collection</p>
-</li>
-<li>
-<p><a href="collecting-events.html" class="xref page">This page</a> documents event collection</p>
-</li>
-<li>
-<p><a href="dsn.html" class="xref page">this page</a> specified how to support SMTP Delivery Submission Notification (<a href="https://tools.ietf.org/html/rfc3461">RFC-3461</a>)</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_system_properties"><a class="anchor" href="#_system_properties"></a>System properties</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Some tuning can be done via system properties. This includes:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. System properties</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">james.message.memory.threshold</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">(Optional). String (size, integer + size units, example: <code>12 KIB</code>, supported units are bytes KIB MIB GIB TIB). Defaults to 100KIB.
-This governs the threshold MimeMessageInputStreamSource relies on for storing MimeMessage content on disk.
-Below, data is stored in memory. Above data is stored on disk.
-Lower values will lead to longer processing time but will minimize heap memory usage. Modern SSD hardware
-should however support a high throughput. Higher values will lead to faster single mail processing at the cost
-of higher heap usage.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">james.message.usememorycopy</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Boolean. Defaults to false. Recommended value is false.
-Should MimeMessageWrapper use a copy of the message in memory? Or should bigger message exceeding james.message.memory.threshold
-be copied to temporary files?</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/configure/jmap.html b/james-distributed-app/3.8.0/configure/jmap.html
deleted file mode 100644
index 06abc4f..0000000
--- a/james-distributed-app/3.8.0/configure/jmap.html
+++ /dev/null
@@ -1,681 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — jmap.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Protocols</li>
- <li><a href="jmap.html">jmap.properties</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/jmap.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — jmap.properties</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p><a href="https://jmap.io/">JMAP</a> is intended to be a new standard for email clients to connect to mail
-stores. It therefore intends to primarily replace IMAP + SMTP submission. It is also designed to be more
-generic. It does not replace MTA-to-MTA SMTP transmission.</p>
-</div>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/jmap.properties">example</a>
-to get some examples and hints.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. jmap.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true/false. Governs whether JMAP should be enabled</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jmap.port</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 80. The port this server will be listening on. This value must be a valid
-port, ranging between 1 and 65535 (inclusive)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tls.keystoreURL</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Keystore to be used for generating authentication tokens for password authentication mechanism.
-This should not be the same keystore than the ones used by TLS based protocols.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tls.secret</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Password used to read the keystore</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jwt.publickeypem.url</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Coma separated list of RSA public keys URLs to validate JWT tokens allowing requests to bypass authentication.
-Defaults to an empty list.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">url.prefix</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Configuration urlPrefix for JMAP routes. Default value: <a href="http://localhost" class="bare">http://localhost</a>.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">websocket.url.prefix</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. URL for JMAP WebSocket route. Default value: ws://localhost</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">email.send.max.size</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Configuration max size for message created in both JMAP Draft amd RFC-8621.
-Default value: None. Supported units are B (bytes) K (KB) M (MB) G (GB).</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">max.size.attachments.per.mail</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 20MB. RFC-8621 <code>maxSizeAttachmentsPerEmail</code> advertised to JMAP client as part of the
-<code>urn:ietf:params:jmap:mail</code> capability. This needs to be at least 33% lower than <code>email.send.max.size</code> property
-(in order to account for text body, headers, base64 encoding and MIME structures).
-JMAP clients would use this property in order not to create too big emails.
-Default value: None. Supported units are B (bytes) K (KB) M (MB) G (GB).</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">upload.max.size</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Configuration max size for each upload file in new JMAP-RFC-8621.
-Default value: 30M. Supported units are B (bytes) K (KB) M (MB) G (GB).</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">upload.quota.limit</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Configure JMAP upload quota for total existing uploads' size per user. User exceeding the upload quota would result in old uploads being cleaned up.
-Default value: 200M. Supported units are B (bytes) K (KB) M (MB) G (GB).</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">view.email.query.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional boolean. Defaults to false. Should simple Email/query be resolved against a Cassandra projection, or should we resolve them against OpenSearch?
-This enables a higher resilience, but the projection needs to be correctly populated.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">user.provisioning.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional boolean. Defaults to true. Governs whether authenticated users that do not exist locally should be created in the users repository.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">authentication.strategy.draft</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional List[String] with delimiter <code>,</code> . Specify which authentication strategies system admin want to use for JMAP draft server.
-The implicit package name is <code>org.apache.james.jmap.http</code>. If you have a custom authentication strategy outside this package, you have to specify its FQDN.
-If no authentication strategy is specified, JMAP draft server will fallback to default strategies:
-<code>AccessTokenAuthenticationStrategy</code>, <code>JWTAuthenticationStrategy</code>, <code>QueryParameterAccessTokenAuthenticationStrategy</code></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">authentication.strategy.rfc8621</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional List[String] with delimiter <code>,</code> . Specify which authentication strategies system admin want to use for JMAP RFC-8621 server.
-The implicit package name is <code>org.apache.james.jmap.http</code>. If you have a custom authentication strategy outside this package, you have to specify its FQDN.
-If no authentication strategy is specified, JMAP RFC-8621 server will fallback to default strategies:
-<code>JWTAuthenticationStrategy</code>, <code>BasicAuthenticationStrategy</code>.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jmap.version.default</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional string. Defaults to draft. Allowed values: draft, rfc-8621.
-Which version of the JMAP protocol should be served when none supplied in the Accept header.
-Defaults to draft for legacy reasons (avoid breaking changes) but setting the value to
-rfc-8621 allow compatibility with other third party apps.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">dynamic.jmap.prefix.resolution.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional boolean. Defaults to false. Supported Jmap session endpoint returns dynamic prefix in response.
-When its config is true, and the HTTP request to Jmap session endpoint has a <code>X-JMAP-PREFIX</code> header with the value <code><a href="http://new-domain/prefix" class="bare">http://new-domain/prefix</a></code>,
-then <code>apiUrl, downloadUrl, uploadUrl, eventSourceUrl, webSocketUrl</code> in response will be changed with a new prefix. Example: The <code>apiUrl</code> will be "http://new-domain/prefix/jmap".
-If the HTTP request to Jmap session endpoint has the <code>X-JMAP-WEBSOCKET-PREFIX</code> header with the value <code>ws://new-domain/prefix</code>,
-then <code>capabilities."urn:ietf:params:jmap:websocket".url</code> in response will be "ws://new-domain/prefix/jmap/ws".</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">webpush.prevent.server.side.request.forgery</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional boolean. Prevent server side request forgery by preventing calls to the private network ranges. Defaults to true, can be disabled for testing.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandra.filter.projection.activated</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional boolean. Defaults to false. Casandra backends only. Whether to use or not the Cassandra projection
-for JMAP filters. This projection optimizes reads, but needs to be correctly populated. Turning it on on
-systems with filters already defined would result in those filters to be not read.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">delay.sends.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional boolean. Defaults to false. Whether to support or not the delay send with JMAP protocol.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">disabled.capabilities</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional, defaults to empty. Coma separated list of JMAP capabilities to reject.
-This allows to prevent users from using some specific JMAP extensions.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">email.get.full.max.size</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional, default value is 5. The max number of items for EmailGet full reads.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_wire_tapping"><a class="anchor" href="#_wire_tapping"></a>Wire tapping</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Enabling <strong>TRACE</strong> on <code>org.apache.james.jmap.wire</code> enables reactor-netty wiretap, logging of
-all incoming and outgoing requests, outgoing requests. This will log also potentially sensible information
-like authentication credentials.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_oidc_set_up"><a class="anchor" href="#_oidc_set_up"></a>OIDC set up</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The use of <code>XUserAuthenticationStrategy</code> allow delegating the authentication responsibility to a third party system,
-which could be used to set up authentication against an OIDC provider.</p>
-</div>
-<div class="paragraph">
-<p>We do supply an <a href="https://github.com">example</a> of such a setup. It combines the <a href="https://www.keycloak.org/">Keycloack</a>
-OIDC provider with the <a href="https://www.krakend.io/">Krackend</a> API gateway, but usage of similar technologies is definitely doable.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_generating_a_jwt_key_pair"><a class="anchor" href="#_generating_a_jwt_key_pair"></a>Generating a JWT key pair</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Apache James can alternatively be configured to check the validity of JWT tokens itself. No revocation mechanism is
-supported in such a setup, and the <code>sub</code> claim is used to identify the user. The key configuration is static.</p>
-</div>
-<div class="paragraph">
-<p>This requires the <code>JWTAuthenticationStrategy</code> authentication strategy to be used.</p>
-</div>
-<div class="paragraph">
-<p>The Distributed server enforces the use of RSA-SHA-256.</p>
-</div>
-<div class="paragraph">
-<p>One can use OpenSSL to generate a JWT key pair :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre># private key
-openssl genrsa -out rs256-4096-private.rsa 4096
-# public key
-openssl rsa -in rs256-4096-private.rsa -pubout > rs256-4096-public.pem</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The private key can be used to generate JWT tokens, for instance
-using <a href="https://github.com/vandium-io/jwtgen">jwtgen</a>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>jwtgen -a RS256 -p rs256-4096-private.rsa 4096 -c "sub=bob@domain.tld" -e 3600 -V</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>This token can then be passed as <code>Bearer</code> of the <code>Authorization</code> header :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -H "Authorization: Bearer $token" -XPOST http://127.0.0.1:80/jmap -d '...'</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The public key can be referenced as <code>jwt.publickeypem.url</code> of the <code>jmap.properties</code> configuration file.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_annotated_specification"><a class="anchor" href="#_annotated_specification"></a>Annotated specification</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The [annotated documentation](<a href="https://github.com/apache/james-project/tree/master/server/protocols/jmap-rfc-8621/doc/specs/spec" class="bare">https://github.com/apache/james-project/tree/master/server/protocols/jmap-rfc-8621/doc/specs/spec</a>)
-presents the limits of the JMAP RFC-8621 implementation part of the Apache James project. We furthermore implement
-[JSON Meta Application Protocol (JMAP) Subprotocol for WebSocket](<a href="https://tools.ietf.org/html/rfc8887" class="bare">https://tools.ietf.org/html/rfc8887</a>).</p>
-</div>
-<div class="paragraph">
-<p>Some methods / types are not yet implemented, some implementations are naive, and the PUSH is not supported yet.</p>
-</div>
-<div class="paragraph">
-<p>Users are invited to read these limitations before using actively the JMAP RFC-8621 implementation, and should ensure their
-client applications only uses supported operations.</p>
-</div>
-<div class="paragraph">
-<p>Contributions enhancing support are furthermore welcomed.</p>
-</div>
-<div class="paragraph">
-<p>The list of tested JMAP clients are:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>[OpenPaaS](<a href="https://open-paas.org/" class="bare">https://open-paas.org/</a>) is actively using the draft version of the JMAP implementation. Migration to
-RFC-8621 is planned.</p>
-</li>
-<li>
-<p>Experiments had been run on top of [LTT.RS](<a href="https://github.com/iNPUTmice/lttrs-android" class="bare">https://github.com/iNPUTmice/lttrs-android</a>). Version in the Accept
-headers needs to be explicitly set to <code>rfc-8621</code>. [Read more](<a href="https://github.com/linagora/james-project/pull/4089" class="bare">https://github.com/linagora/james-project/pull/4089</a>).</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_jmap_auto_configuration"><a class="anchor" href="#_jmap_auto_configuration"></a>JMAP auto-configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p><a href="https://datatracker.ietf.org/doc/html/rfc8620">RFC-8620</a> defining JMAP core RFC defines precisely service location.</p>
-</div>
-<div class="paragraph">
-<p>James already redirects <code><a href="http://jmap.domain.tld/.well-known/jmap" class="bare">http://jmap.domain.tld/.well-known/jmap</a></code> to the JMAP session.</p>
-</div>
-<div class="paragraph">
-<p>You can further help your clients by publishing extra SRV records.</p>
-</div>
-<div class="paragraph">
-<p>Eg:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>_jmap._tcp.domain.tld. 3600 IN SRV 0 1 443 jmap.domain.tld.</pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_jmap_reverse_proxy_set_up"><a class="anchor" href="#_jmap_reverse_proxy_set_up"></a>JMAP reverse-proxy set up</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>James implementation adds the value of <code>X-Real-IP</code> header as part of the logging MDC.</p>
-</div>
-<div class="paragraph">
-<p>This allows for reverse proxies to cary other the IP address of the client down to the JMAP server for diagnostic purpose.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/configure/jmx.html b/james-distributed-app/3.8.0/configure/jmx.html
deleted file mode 100644
index 23df8e2..0000000
--- a/james-distributed-app/3.8.0/configure/jmx.html
+++ /dev/null
@@ -1,515 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — jmx.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Protocols</li>
- <li><a href="jmx.html">jmx.properties</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/jmx.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — jmx.properties</h1>
-<div class="sect1">
-<h2 id="_disclaimer"><a class="anchor" href="#_disclaimer"></a>Disclaimer</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>JMX poses several security concerns and had been leveraged to conduct arbitrary code execution.
-This threat is mitigated by not allowing remote connections to JMX, setting up authentication and pre-authentication filters.
-However, we recommend to either run James in isolation (docker / own virtual machine) or disable JMX altogether.<br/></p>
-</div>
-<div class="paragraph">
-<p>James JMX endpoint provides command line utilities and exposes a few metrics, also available on the metric endpoint.</p></p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_configuration"><a class="anchor" href="#_configuration"></a>Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This is used to configure the JMX MBean server via which all management is achieved.</p>
-</div>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/jmx.properties">example</a>
-in GIT to get some examples and hints.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. jmx.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jmx.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Boolean. Should the JMX server be enabled? Defaults to <code>true</code>.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jmx.address</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The IP address (host name) the MBean Server will bind/listen to.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jmx.port</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The port number the MBean Server will bind/listen to.</p></td>
-</tr>
-</tbody>
-</table>
-<div class="paragraph">
-<p>To access from a remote location, it has been reported that <code>-Dcom.sun.management.jmxremote.ssl=false</code> is needed as
-a JVM argument.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_jmx_security"><a class="anchor" href="#_jmx_security"></a>JMX Security</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>In order to set up JMX authentication, we need to put <code>jmxremote.password</code> and <code>jmxremote.access</code> file
-to <code>/conf</code> directory.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>jmxremote.password</code>: define the username and password, that will be used by the client (here is james-cli)</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>File’s content example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">james-admin pass1</code></pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>jmxremote.access</code>: define the pair of username and access permission</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>File’s content example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">james-admin readwrite</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>When James runs with option <code>-Djames.jmx.credential.generation=true</code>, James will automatically generate <code>jmxremote.password</code> if the file does not exist.
-Then the default username is <code>james-admin</code> and a random password. This option defaults to true.</p>
-</div>
-<div class="sect2">
-<h3 id="_james_cli"><a class="anchor" href="#_james_cli"></a>James-cli</h3>
-<div class="paragraph">
-<p>When the JMX server starts with authentication configuration, it will require the client need provide username/password for bypass.
-To do that, we need set arguments <code>-username</code> and <code>-password</code> for the command request.</p>
-</div>
-<div class="paragraph">
-<p>Command example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">james-cli -h 127.0.0.1 -p 9999 -username james-admin -password pass1 listdomains</code></pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/configure/jvm.html b/james-distributed-app/3.8.0/configure/jvm.html
deleted file mode 100644
index b2652d8..0000000
--- a/james-distributed-app/3.8.0/configure/jvm.html
+++ /dev/null
@@ -1,533 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — jvm.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="jvm.html">Distributed James Server — jvm.properties</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/jvm.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — jvm.properties</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This file may contain any additional system properties for tweaking JVM execution. When you normally would add a command line option <code>-Dmy.property=whatever</code>, you can put it in this file as <code>my.property=whatever</code> instead. These properties will be added as system properties on server start.</p>
-</div>
-<div class="paragraph">
-<p>Note that in some rare cases this might not work,
-when a property affects very early JVM start behaviour.</p>
-</div>
-<div class="paragraph">
-<p>For testing purposes, you may specify a different file path via the command line option <code>-Dextra.props=/some/other/jvm.properties</code>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_control_the_threshold_memory"><a class="anchor" href="#_control_the_threshold_memory"></a>Control the threshold memory</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This governs the threshold MimeMessageInputStreamSource relies on for storing MimeMessage content on disk.</p>
-</div>
-<div class="paragraph">
-<p>In <code>jvm.properties</code></p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>james.message.memory.threshold=12K</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>(Optional). String (size, integer + size units, example: <code>12 KIB</code>, supported units are bytes KIB MIB GIB TIB). Defaults to 100KIB.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_enable_the_copy_of_message_in_memory"><a class="anchor" href="#_enable_the_copy_of_message_in_memory"></a>Enable the copy of message in memory</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Should MimeMessageWrapper use a copy of the message in memory? Or should bigger message exceeding james.message.memory.threshold
-be copied to temporary files?</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>james.message.usememorycopy=true</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Optional. Boolean. Defaults to false. Recommended value is false.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_running_resource_leak_detection"><a class="anchor" href="#_running_resource_leak_detection"></a>Running resource leak detection</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>It is used to detect a resource not be disposed of before it’s garbage-collected.</p>
-</div>
-<div class="paragraph">
-<p>In <code>jvm.properties</code></p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>james.lifecycle.leak.detection.mode=advanced</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Allowed mode values are: none, simple, advanced, testing</p>
-</div>
-<div class="paragraph">
-<p>The purpose of each mode is introduced in <code>config-system.xml</code></p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_disabling_host_information_in_protocol_mdc_logging_context"><a class="anchor" href="#_disabling_host_information_in_protocol_mdc_logging_context"></a>Disabling host information in protocol MDC logging context</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Should we add the host in the MDC logging context for incoming IMAP, SMTP, POP3? Doing so, a DNS resolution
-is attempted for each incoming connection, which can be costly. Remote IP is always added to the logging context.</p>
-</div>
-<div class="paragraph">
-<p>In <code>jvm.properties</code></p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>james.protocols.mdc.hostname=false</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Optional. Boolean. Defaults to true.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_change_the_encoding_type_used_for_the_blobid"><a class="anchor" href="#_change_the_encoding_type_used_for_the_blobid"></a>Change the encoding type used for the blobId</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>By default, the blobId is encoded in base64 url. The property <code>james.blob.id.hash.encoding</code> allows to change the encoding type.
-The support value are: base16, hex, base32, base32Hex, base64, base64Url.</p>
-</div>
-<div class="paragraph">
-<p>Ex in <code>jvm.properties</code></p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>james.blob.id.hash.encoding=base16</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Optional. String. Defaults to base64Url.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_jmap_quota_draft_compatibility"><a class="anchor" href="#_jmap_quota_draft_compatibility"></a>JMAP Quota draft compatibility</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Some JMAP clients depend on the JMAP Quota draft specifications. The property <code>james.jmap.quota.draft.compatibility</code> allows
-to enable JMAP Quota draft compatibility for those clients and allow them a time window to adapt to the RFC-9245 JMAP Quota.</p>
-</div>
-<div class="paragraph">
-<p>Optional. Boolean. Default to false.</p>
-</div>
-<div class="paragraph">
-<p>Ex in <code>jvm.properties</code></p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>james.jmap.quota.draft.compatibility=true</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>To enable the compatibility.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/configure/listeners.html b/james-distributed-app/3.8.0/configure/listeners.html
deleted file mode 100644
index 7364a24..0000000
--- a/james-distributed-app/3.8.0/configure/listeners.html
+++ /dev/null
@@ -1,636 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — listeners.xml :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Extensions</li>
- <li><a href="listeners.html">listeners.xml</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/listeners.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — listeners.xml</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>Distributed James relies on an event bus system to enrich mailbox capabilities. Each
-operation performed on the mailbox will trigger related events, that can
-be processed asynchronously by potentially any James node on a
-distributed system.</p>
-</div>
-<div class="paragraph">
-<p>Mailbox listeners can register themselves on this event bus system to be
-called when an event is fired, allowing to do different kind of extra
-operations on the system.</p>
-</div>
-<div class="paragraph">
-<p>Distributed James allows the user to register potentially user defined additional mailbox listeners.</p>
-</div>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/listener.xml">example</a>
-to get some examples and hints.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_configuration"><a class="anchor" href="#_configuration"></a>Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The <executeGroupListeners> controls whether to launch group mailbox listener consumption. Defaults to true. Use with caution:
-never disable on standalone james servers, and ensure at least some instances do consume group mailbox listeners within a
-clustered topology.</p>
-</div>
-<div class="paragraph">
-<p>Mailbox listener configuration is under the XML element <listener>.</p>
-</div>
-<div class="paragraph">
-<p>Some MailboxListener allows you to specify if you want to run them synchronously or asynchronously. To do so,
-for MailboxListener that supports this, you can use the <strong>async</strong> attribute (optional, per mailet default) to govern the execution mode.
-If <strong>true</strong> the execution will be scheduled in a reactor elastic scheduler. If <strong>false</strong>, the execution is synchronous.</p>
-</div>
-<div class="paragraph">
-<p>Already provided additional listeners are documented below.</p>
-</div>
-<div class="sect2">
-<h3 id="_spamassassinlistener"><a class="anchor" href="#_spamassassinlistener"></a>SpamAssassinListener</h3>
-<div class="paragraph">
-<p>Provides per user real-time HAM/SPAM feedback to a SpamAssassin server depending on user actions.</p>
-</div>
-<div class="paragraph">
-<p>This mailet is asynchronous by default, but this behaviour can be overridden by the <strong>async</strong>
-configuration property.</p>
-</div>
-<div class="paragraph">
-<p>This MailboxListener is supported.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><listeners>
- <!-- ... -->
- <listener>
- <class>org.apache.james.mailbox.spamassassin.SpamAssassinListener</class>
- </listener>
-</listeners></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Please note that a <code>spamassassin.properties</code> file is needed. Read also
-<a href="spam.html" class="xref page">this page</a> for extra configuration required to support this feature.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_rspamdlistener"><a class="anchor" href="#_rspamdlistener"></a>RspamdListener</h3>
-<div class="paragraph">
-<p>Provides HAM/SPAM feedback to a Rspamd server depending on user actions.</p>
-</div>
-<div class="paragraph">
-<p>This MailboxListener is supported.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><listeners>
- <!-- ... -->
- <listener>
- <class>org.apache.james.rspamd.RspamdListener</class>
- </listener>
-</listeners></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Please note that a <code>rspamd.properties</code> file is needed. Read also
-<a href="spam.html" class="xref page">this page</a> for extra configuration required to support this feature.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_mailboxoperationlogginglistener"><a class="anchor" href="#_mailboxoperationlogginglistener"></a>MailboxOperationLoggingListener</h3>
-<div class="paragraph">
-<p>Provides more insights on mailbox operationsby logging them.</p>
-</div>
-<div class="paragraph">
-<p>This MailboxListener is supported.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><listeners>
- <listener>
- <class>org.apache.james.mailbox.cassandra.MailboxOperationLoggingListener</class>
- </listener>
- <!-- ... -->
-</listeners></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_quotathresholdcrossinglistener"><a class="anchor" href="#_quotathresholdcrossinglistener"></a>QuotaThresholdCrossingListener</h3>
-<div class="paragraph">
-<p>Sends emails to users exceeding 80% and 99% of their quota to warn them (for instance).</p>
-</div>
-<div class="paragraph">
-<p>Here are the following properties you can configure:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. QuotaThresholdCrossingListener configuration properties</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Useful when configuring several time this listener. You might want to do so to use different rendering templates for
-different occupation thresholds.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">gracePeriod</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Period during which no more email for a given threshold should be sent.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">subjectTemplate</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Mustache template for rendering the subject of the warning email.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">bodyTemplate</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Mustache template for rendering the body of the warning email.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">thresholds</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Floating number between 0 and 1 representing the threshold of quota occupation from which a mail should be sent.
-Configuring several thresholds is supported.</p></td>
-</tr>
-</tbody>
-</table>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><listeners>
- <!-- ... -->
- <listener>
- <class>org.apache.james.mailbox.quota.mailing.listeners.QuotaThresholdCrossingListener</class>
- <group>QuotaThresholdCrossingListener-upper-threshold</group>
- <configuration>
- <thresholds>
- <threshold>
- <value>0.8</value>
- </threshold>
- </thresholds>
- <name>thirst</name>
- <subjectTemplate>conf://templates/QuotaThresholdMailSubject.mustache</subjectTemplate>
- <bodyTemplate>conf://templates/QuotaThresholdMailBody.mustache</bodyTemplate>
- <gracePeriod>1week/</gracePeriod>
- </configuration>
- </listener>
-</listeners></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Here are examples of templates you can use:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>For subject template: <code>conf://templates/QuotaThresholdMailSubject.mustache</code></p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>Warning: Your email usage just exceeded a configured threshold</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>For body template: <code>conf://templates/QuotaThresholdMailBody.mustache</code></p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>You receive this email because you recently exceeded a threshold related to the quotas of your email account.
-
-{{#hasExceededSizeThreshold}}
-You currently occupy more than {{sizeThreshold}} % of the total size allocated to you.
-You currently occupy {{usedSize}}{{#hasSizeLimit}} on a total of {{limitSize}} allocated to you{{/hasSizeLimit}}.
-
-{{/hasExceededSizeThreshold}}
-{{#hasExceededCountThreshold}}
-You currently occupy more than {{countThreshold}} % of the total message count allocated to you.
-You currently have {{usedCount}} messages{{#hasCountLimit}} on a total of {{limitCount}} allowed for you{{/hasCountLimit}}.
-
-{{/hasExceededCountThreshold}}
-You need to be aware that actions leading to exceeded quotas will be denied. This will result in a degraded service.
-To mitigate this issue you might reach your administrator in order to increase your configured quota. You might also delete some non important emails.</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>This MailboxListener is supported.</p>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/configure/mailetcontainer.html b/james-distributed-app/3.8.0/configure/mailetcontainer.html
deleted file mode 100644
index 074d4f0..0000000
--- a/james-distributed-app/3.8.0/configure/mailetcontainer.html
+++ /dev/null
@@ -1,536 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — mailetcontainer.xml :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Core components</li>
- <li><a href="mailetcontainer.html">mailetcontainer.xml</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/mailetcontainer.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — mailetcontainer.xml</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This documents explains how to configure Mail processing. Mails pass through the MailetContainer. The
-MailetContainer is a Matchers (condition for executing a mailet) and Mailets (execution units that perform
-actions based on incoming mail) pipeline arranged into processors (List of mailet/matcher pairs allowing
-better logical organisation). You can read more about these concepts on
-<a href="../architecture/index.html#_mail_processing" class="xref page">the mailet container feature description</a>.</p>
-</div>
-<div class="paragraph">
-<p>Apache James Server includes a number of <a href="mailets.html" class="xref page">Packaged Mailets</a> and
-<a href="matchers.html" class="xref page">Packaged Matchers</a>.</p>
-</div>
-<div class="paragraph">
-<p>Furthermore, you can write and use with James <a href="../extending/mail-processing.html" class="xref page">your own mailet and matchers</a>.</p>
-</div>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/mailetcontainer.xml">example</a>
-to get some examples and hints.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. mailetcontainer.xml content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">context.postmaster</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The body of this element is the address that the server
-will consider its postmaster address. This address will be listed as the sender address
-of all error messages that originate from James. Also, all messages addressed to
-postmaster@<servername>, where <servername> is one of the domain names whose
-mail is being handled by James, will be redirected to this email address.
-Set this to the appropriate email address for error reports
-If this is set to a non-local email address, the mail server
-will still function, but will generate a warning on startup.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">spooler.threads</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Number of simultaneous threads used to spool the mails. Set to zero, it disables mail processing - use with
-caution.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">spooler.errorRepository</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Mail repository to store email in after several unrecoverable errors. Mails failing processing, for which
-the Mailet Container could not handle Error, will be stored there after their processing had been attempted
-5 times. Note that if standard java Exception occurs, <strong>Error handling</strong> section below will be applied
-instead.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_the_mailet_tag"><a class="anchor" href="#_the_mailet_tag"></a>The Mailet Tag</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Consider the following simple <strong>mailet</strong> tag:</p></p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="RemoteAddrNotInNetwork=127.0.0.1" class="ToProcessor">
- <processor>spam</processor>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The mailet tag has two required attributes, <strong>match</strong> and <strong>class</strong>.</p>
-</div>
-<div class="paragraph">
-<p>The <strong>match</strong> attribute is set to the value of the specific Matcher class to be instantiated with a an
-optional argument. If present, the argument is separated from the Matcher class name by an '='. Semantic
-interpretation of the argument is left to the particular mailet.</p>
-</div>
-<div class="paragraph">
-<p>The <strong>class</strong> attribute is set to the value of the Mailet class that is to be instantiated.</p>
-</div>
-<div class="paragraph">
-<p>Finally, the children of the <strong>mailet</strong> tag define the configuration that is passed to the Mailet. The
-tags used in this section should have no attributes or children. The names and bodies of the elements will be passed to
-the mailet as (name, value) pairs.</p>
-</div>
-<div class="paragraph">
-<p>So in the example above, a Matcher instance of RemoteAddrNotInNetwork would be instantiated, and the value "127.0.0.1"
-would be passed to the matcher. The Mailet of the pair will be an instance of ToProcessor, and it will be passed the (name, value)
-pair of ("processor", "spam").</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_error_handling"><a class="anchor" href="#_error_handling"></a>Error handling</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>If an exception is encountered during the execution of a mailet or a matcher, the default behaviour is to
-process the mail using the <strong>error</strong> processor.</p>
-</div>
-<div class="paragraph">
-<p>The <strong>onMailetException</strong> property allows you to override this behaviour. You can specify another
-processor than the <strong>error</strong> one for handling the errors of this mailet.</p>
-</div>
-<div class="paragraph">
-<p>The <strong>ignore</strong> special value also allows to continue processing and ignore the error.</p>
-</div>
-<div class="paragraph">
-<p>The <strong>propagate</strong> special value causes the mailet container to rethrow the
-exception, propagating it to the execution context. In an SMTP execution context, the spooler will then requeue
-the item and automatic retries will be setted up - note that attempts will be done for each recipients. In LMTP
-(if LMTP is configured to execute the mailetContainer), the entire mail transaction is reported as failed to the caller.</p>
-</div>
-<div class="paragraph">
-<p>Moreover, the <strong>onMatcherException</strong> allows you to override matcher error handling. You can
-specify another processor than the <strong>error</strong> one for handling the errors of this mailet. The <strong>matchall</strong>
-special value also allows you to match all recipients when there is an error. The <strong>nomatch</strong>
-special value also allows you to match no recipients when there is an error.</p>
-</div>
-<div class="paragraph">
-<p>Here is a short example to illustrate this:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match=RecipientIsLocal class="LocalDelivery">
- <onMailetException>deliveryError</onMailetException>
- <onMatcherException>nomatch</onMatcherException>
-</mailet></pre>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/configure/mailets.html b/james-distributed-app/3.8.0/configure/mailets.html
deleted file mode 100644
index 7c104f1..0000000
--- a/james-distributed-app/3.8.0/configure/mailets.html
+++ /dev/null
@@ -1,3090 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Mailets :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Core components</li>
- <li><a href="mailets.html">Packaged Mailets</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/mailets.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Mailets</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This documentation page lists and documents Mailet that can be used within the
-Distributed Server MailetContainer in order to write your own mail processing logic with out-of-the-box components.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_supported_mailets"><a class="anchor" href="#_supported_mailets"></a>Supported mailets</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_adddeliveredtoheader"><a class="anchor" href="#_adddeliveredtoheader"></a>AddDeliveredToHeader</h3>
-<div class="paragraph">
-<p>This mailet adds the de-facto standard QMail Delivered-To header.</p>
-</div>
-<div class="paragraph">
-<p>Upon processing by LocalDelivery, a Delivered-To header matching the recipient mail address will be added before storage.</p>
-</div>
-<div class="paragraph">
-<p>Example</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="AddDeliveredToHeader"></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_addfooter"><a class="anchor" href="#_addfooter"></a>AddFooter</h3>
-<div class="paragraph">
-<p>Takes the message and attaches a footer message to it. Right now, it only
-supports simple messages. Needs to have additions to make it support
-messages with alternate content types or with attachments.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_addsubjectprefix"><a class="anchor" href="#_addsubjectprefix"></a>AddSubjectPrefix</h3>
-<div class="paragraph">
-<p>Add an prefix (tag) to the subject of a message <br></p>
-</div>
-<div class="paragraph">
-<p>Sample Configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="RecipientIs=robot@james.apache.org" class="TagMessage">
- <subjectPrefix>[robot]</subjectPrefix>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_amqpforwardattribute"><a class="anchor" href="#_amqpforwardattribute"></a>AmqpForwardAttribute</h3>
-<div class="paragraph">
-<p>This mailet forwards the attributes values to a AMPQ.</p>
-</div>
-<div class="paragraph">
-<p>It takes 4 parameters:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>attribute (mandatory): content to be forwarded, expected to be a Map<String, byte[]>
-where the byte[] content is issued from a MimeBodyPart.
-It is typically generated from the StripAttachment mailet.</p>
-</li>
-<li>
-<p>uri (mandatory): AMQP URI defining the server where to send the attachment.</p>
-</li>
-<li>
-<p>exchange (mandatory): name of the AMQP exchange.</p>
-</li>
-<li>
-<p>routing_key (optional, default to empty string): name of the routing key on this exchange.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This mailet will sent the data attached to the mail as an attribute holding a map.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_bounce"><a class="anchor" href="#_bounce"></a>Bounce</h3>
-<div class="paragraph">
-<p>Generates a response to the reverse-path address. Note that this is different
-than a mail-client’s reply, which would use the Reply-To or From header.</p>
-</div>
-<div class="paragraph">
-<p>Bounced messages are attached in their entirety (headers and content) and the
-resulting MIME part type is "message/rfc822".</p>
-</div>
-<div class="paragraph">
-<p>The reverse-path and the Return-Path header of the response is set to "null"
-("<>"), meaning that no reply should be sent.</p>
-</div>
-<div class="paragraph">
-<p>A sender of the notification message can optionally be specified. If one is
-not specified, the postmaster’s address will be used.</p>
-</div>
-<div class="paragraph">
-<p>A notice text can be specified, and in such case will be inserted into the
-notification inline text.</p>
-</div>
-<div class="paragraph">
-<p>If the notified message has an "error message" set, it will be inserted into
-the notification inline text. If the <strong>attachError</strong> init
-parameter is set to true, such error message will be attached to the
-notification message.</p>
-</div>
-<div class="paragraph">
-<p>Supports the <strong>passThrough</strong> init parameter (true if missing).</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="Bounce">
- <sender>*an address or postmaster or sender or unaltered, default=postmaster*</sender>
- <attachError>*true or false, default=false*</attachError>
- <message>*notice attached to the original message text (optional)*</message>
- <prefix>*optional subject prefix prepended to the original message*</prefix>
- <inline>*default=none*</inline>
- <attachment>*default=message*</attachment>
- <passThrough>*true or false, default=true*</passThrough>
- <fakeDomainCheck>*true or false, default=true*</fakeDomainCheck>
- <debug>*true or false, default=false*</debug>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The behaviour of this mailet is equivalent to using Resend with the following
-configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="Resend">
- <sender>*an address or postmaster or sender or unaltered*</sender>
- <attachError>*true or false*</attachError>
- <message>**dynamically built**</message>
- <prefix>*a string*</prefix>
- <passThrough>true or false</passThrough>
- <fakeDomainCheck>*true or false*</fakeDomainCheck>
- <recipients>*sender*</recipients>
- <reversePath>null</reversePath>
- <inline>see Resend</inline>
- <attachment>see Resend</attachment>
- <isReply>true</isReply>
- <debug>*true or false*</debug>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>notice</strong> and <strong>sendingAddress</strong> can be used instead of <strong>message</strong>
-and <strong>sender</strong>; such names are kept for backward compatibility.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_contactextractor"><a class="anchor" href="#_contactextractor"></a>ContactExtractor</h3>
-<div class="paragraph">
-<p>Collects the sender and the recipients of a message and store them as JSON in a
-specified message attribute.</p>
-</div>
-<div class="paragraph">
-<p>Here is the JSON format:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "userEmail" : "sender@james.org",
- "emails" : [ "to@james.org", "cc@james.org" ]
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="ContactExtractor">
- <attribute>ExtractedContacts</attribute>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_convertto7bit"><a class="anchor" href="#_convertto7bit"></a>ConvertTo7Bit</h3>
-<div class="paragraph">
-<p>Make sure the message stream is 7bit. Every 8bit part is encoded to
-quoted-printable or base64 and the message is saved.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_dkimsign"><a class="anchor" href="#_dkimsign"></a>DKIMSign</h3>
-<div class="paragraph">
-<p>This mailet sign a message using the DKIM protocol
-If the privateKey is encoded using a password then you can pass
-the password as privateKeyPassword parameter.</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration with inlined private key:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match=&quot;All&quot; class=&quot;DKIMSign&quot;>
- <signatureTemplate>v=1; s=selector; d=example.com; h=from:to:received:received; a=rsa-sha256; bh=; b=;</signatureTemplate>
- <privateKey>
- -----BEGIN RSA PRIVATE KEY-----
- MIICXAIBAAKBgQDYDaYKXzwVYwqWbLhmuJ66aTAN8wmDR+rfHE8HfnkSOax0oIoT
- M5zquZrTLo30870YMfYzxwfB6j/Nz3QdwrUD/t0YMYJiUKyWJnCKfZXHJBJ+yfRH
- r7oW+UW3cVo9CG2bBfIxsInwYe175g9UjyntJpWueqdEIo1c2bhv9Mp66QIDAQAB
- AoGBAI8XcwnZi0Sq5N89wF+gFNhnREFo3rsJDaCY8iqHdA5DDlnr3abb/yhipw0I
- /1HlgC6fIG2oexXOXFWl+USgqRt1kTt9jXhVFExg8mNko2UelAwFtsl8CRjVcYQO
- cedeH/WM/mXjg2wUqqZenBmlKlD6vNb70jFJeVaDJ/7n7j8BAkEA9NkH2D4Zgj/I
- OAVYccZYH74+VgO0e7VkUjQk9wtJ2j6cGqJ6Pfj0roVIMUWzoBb8YfErR8l6JnVQ
- bfy83gJeiQJBAOHk3ow7JjAn8XuOyZx24KcTaYWKUkAQfRWYDFFOYQF4KV9xLSEt
- ycY0kjsdxGKDudWcsATllFzXDCQF6DTNIWECQEA52ePwTjKrVnLTfCLEG4OgHKvl
- Zud4amthwDyJWoMEH2ChNB2je1N4JLrABOE+hk+OuoKnKAKEjWd8f3Jg/rkCQHj8
- mQmogHqYWikgP/FSZl518jV48Tao3iXbqvU9Mo2T6yzYNCCqIoDLFWseNVnCTZ0Q
- b+IfiEf1UeZVV5o4J+ECQDatNnS3V9qYUKjj/krNRD/U0+7eh8S2ylLqD3RlSn9K
- tYGRMgAtUXtiOEizBH6bd/orzI9V9sw8yBz+ZqIH25Q=
- -----END RSA PRIVATE KEY-----
- </privateKey>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Sample configuration with file-provided private key:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match=&quot;All&quot; class=&quot;DKIMSign&quot;>
- <signatureTemplate>v=1; s=selector; d=example.com; h=from:to:received:received; a=rsa-sha256; bh=; b=;</signatureTemplate>
- <privateKeyFilepath>dkim-signing.pem</privateKeyFilepath>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>By default the mailet assume that Javamail will convert LF to CRLF when sending
-so will compute the hash using converted newlines. If you don’t want this
-behaviour then set forceCRLF attribute to false.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_dkimverify"><a class="anchor" href="#_dkimverify"></a>DKIMVerify</h3>
-<div class="paragraph">
-<p>This mailet verify a message using the DKIM protocol</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="DKIMVerify">
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>By default the mailet assume that Javamail will use LF instead of CRLF
-so it will verify the hash using converted newlines. If you don’t want this
-behaviour then set forceCRLF attribute to false.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_dsnbounce"><a class="anchor" href="#_dsnbounce"></a>DSNBounce</h3>
-<div class="paragraph">
-<p>Generates a Delivery Status Notification (DSN) Note that this is different
-than a mail-client’s reply, which would use the Reply-To or From header.</p>
-</div>
-<div class="paragraph">
-<p>Bounced messages are attached in their entirety (headers and content) and the
-resulting MIME part type is "message/rfc822".</p>
-</div>
-<div class="paragraph">
-<p>The reverse-path and the Return-Path header of the response is set to "null"
-("<>"), meaning that no reply should be sent.</p>
-</div>
-<div class="paragraph">
-<p>A sender of the notification message can optionally be specified. If one is
-not specified, the postmaster’s address will be used.</p>
-</div>
-<div class="paragraph">
-<p>Supports the <code>passThrough</code> init parameter (true if missing).</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="DSNBounce">
- <sender>*an address or postmaster or sender or unaltered, default=postmaster*</sender>
- <prefix>*optional subject prefix prepended to the original message*</prefix>
- <attachment>*message, heads or none, default=message*</attachment>
- <messageString>*the message sent in the bounce, the first occurrence of the pattern [machine] is replaced with the name of the executing machine, default=Hi. This is the James mail server at [machine] ... *</messageString>
- <passThrough>*true or false, default=true*</passThrough>
- <debug>*true or false, default=false*</debug>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_expires"><a class="anchor" href="#_expires"></a>Expires</h3>
-<div class="paragraph">
-<p>Sanitizes or adds an expiration date to a message, in the form of an <code>Expires</code>
-header (RFC 4021).</p>
-</div>
-<div class="paragraph">
-<p>The mailet can force an existing expiration date to be within the bounds
-given by <code>minAge</code>, <code>maxAge</code>, or both. <code>minAge</code> specifies the minimum time
-the date must lie in the future, while <code>maxAge</code> specifies a maximum.</p>
-</div>
-<div class="paragraph">
-<p>If a message has no expiration date, the mailet can add one according to
-the optional <code>defaultAge</code> parameter.</p>
-</div>
-<div class="paragraph">
-<p>All parameter values should be expressed in the following format: <code>Nunit</code>.
-<code>N</code> should be positive. <code>unit</code> could be either in the short form
-(<code>h</code>, <code>d</code>, <code>w</code>, <code>y</code> etc.), or in the long form (<code>hours</code>, days`, <code>weeks</code>,
-<code>months</code>, <code>years</code>). The default unit is <code>days</code>.</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="Expires">
- <minAge>12h</minAge>
- <defaultAge>7d</defaultAge>
- <maxAge>8w</maxAge>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>By itself the <code>Expires</code> header is informational only. But some variants of James
-will let you delete expired messages through the
-<a href="../operate/webadmin.html#_administrating_messages" class="xref page">WebAdmin</a> interface:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/messages?byExpiresHeader</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_extractmdnoriginaljmapmessageid"><a class="anchor" href="#_extractmdnoriginaljmapmessageid"></a>ExtractMDNOriginalJMAPMessageId</h3>
-<div class="paragraph">
-<p>This mailet handles MDN messages and define a header X-JAMES-MDN-JMAP-MESSAGE-ID referencing
-the original message (by its Jmap Id) asking for the recipient to send an MDN.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_forward"><a class="anchor" href="#_forward"></a>Forward</h3>
-<div class="paragraph">
-<p>Replaces incoming recipients with those specified, and resends the message
-unaltered.</p>
-</div>
-<div class="paragraph">
-<p>Can be totally replaced by an equivalent usage of {@link Resend} (see below),
-simply replacing <strong><forwardto></strong> with <strong><recipients></strong>.</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="Forward">
- <forwardTo>*comma delimited list of email addresses*</forwardTo>
- <passThrough>*true or false, default=false*</passThrough>
- <fakeDomainCheck>*true or false, default=true*</fakeDomainCheck>
- <debug>*true or false, default=false*</debug>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The behaviour of this mailet is equivalent to using Resend with the following
-configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="Resend">
- <forwardTo>comma delimited list of email addresses</recipients>
- <passThrough>true or false</passThrough>
- <fakeDomainCheck>*true or false*</fakeDomainCheck>
- <debug>*true or false*</debug>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>forwardto</strong> can be used instead of <strong>forwardTo</strong>; such name is kept
-for backward compatibility.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_icalendarparser"><a class="anchor" href="#_icalendarparser"></a>ICalendarParser</h3>
-<div class="paragraph">
-<p>This mailet can be combined with the Strip attachment mailet.</p>
-</div>
-<div class="paragraph">
-<p>The ICS body part byte array is arranged as map then this mailet should look for ICS and parse it
-with Ical4J then store it as a mail attribute</p>
-</div>
-<div class="paragraph">
-<p>Configuration: The mailet contains 2 mandatory attributes</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> <mailet match="All" class="ICalendarParser" >
- <sourceAttribute>source.attribute.name</sourceAttribute>
- <!-- The attribute which contains output value of StripAttachment mailet -- >
- <destAttribute>dest.attribute.name</destAttribute>
- <!-- The attribute store the map of Calendar -- >
- </mailet ></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_icaltoheader"><a class="anchor" href="#_icaltoheader"></a>ICALToHeader</h3>
-<div class="paragraph">
-<p>ICALToHeader takes a Map of filenames to ICAL4J calendars, will pick the first Calendar,
-and add it to the headers of the e-mail.</p>
-</div>
-<div class="paragraph">
-<p>The following headers will be added : X_MEETING_UID, X_MEETING_METHOD, X_MEETING_RECURRENCE_ID, X_MEETING_SEQUENCE,
-X_MEETING_DTSTAMP</p>
-</div>
-<div class="paragraph">
-<p>The only configuration parameter for this mailet is the attribute the ICAL4J Calendar map should be attached to,
-named <strong>attribute</strong>.</p>
-</div>
-<div class="paragraph">
-<p>Configuration example :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match=??? class=ICALToHeader>
- <attribute>icalendars</attribute>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_icaltojsonattribute"><a class="anchor" href="#_icaltojsonattribute"></a>ICALToJsonAttribute</h3>
-<div class="paragraph">
-<p>ICALToJsonAttribute takes a map of ICAL4J objects attached as attribute, and
-output the map of corresponding json bytes as an other attribute, with unique String keys.</p>
-</div>
-<div class="paragraph">
-<p>The JSON contains the following fields :</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>ical</strong> : the raw ical string, in UTF-8</p>
-</li>
-<li>
-<p><strong>sender</strong> : the sender of the mail (compulsory, mail without sender will be discarded)</p>
-</li>
-<li>
-<p><strong>recipient</strong> : the recipient of the mail. If the mail have several recipients, each recipient will have its own JSON.</p>
-</li>
-<li>
-<p><strong>uid</strong> : the UID of the ical (optional)</p>
-</li>
-<li>
-<p><strong>sequence</strong> : the sequence of the ical (optional)</p>
-</li>
-<li>
-<p><strong>dtstamp</strong> : the date stamp of the ical (optional)</p>
-</li>
-<li>
-<p><strong>method</strong> : the method of the ical (optional)</p>
-</li>
-<li>
-<p><strong>recurrence-id</strong> : the recurrence-id of the ical (optional)</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Example are included in test call ICalToJsonAttributeTest.</p>
-</div>
-<div class="paragraph">
-<p>Configuration example :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match=??? class=ICALToJsonAttribute>
- <sourceAttribute>icalendars</sourceAttribute>
- <destinationAttribute>icalendarJson</destinationAttribute>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_icssanitizer"><a class="anchor" href="#_icssanitizer"></a>ICSSanitizer</h3>
-<div class="paragraph">
-<p>Some senders embed 'text/calendar' content as part of Mime bodypart headers with an empty body.</p>
-</div>
-<div class="paragraph">
-<p>This mailet duplicate the 'text/calendar' content to the Mime body part.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="ICSSanitizer"/></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_localdelivery"><a class="anchor" href="#_localdelivery"></a>LocalDelivery</h3>
-<div class="paragraph">
-<p>Receives a Mail from the Queue and takes care of delivery of the
-message to local inboxes.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_logmessage"><a class="anchor" href="#_logmessage"></a>LogMessage</h3>
-<div class="paragraph">
-<p>Logs Message Headers and/or Body.
-If the "passThrough" in confs is true the mail will be left untouched in
-the pipe. If false will be destroyed. Default is true.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_mailattributeslisttomimeheaders"><a class="anchor" href="#_mailattributeslisttomimeheaders"></a>MailAttributesListToMimeHeaders</h3>
-<div class="paragraph">
-<p>Convert attributes of type Collection<String> to headers</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="MailAttributesToMimeHeaders">
- <simplemapping>org.apache.james.attribute1;headerName1</simplemapping>
- <simplemapping>org.apache.james.attribute2;headerName2</simplemapping>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_mailattributestomimeheaders"><a class="anchor" href="#_mailattributestomimeheaders"></a>MailAttributesToMimeHeaders</h3>
-<div class="paragraph">
-<p>Convert attributes of type Collection<String> to headers</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="MailAttributesToMimeHeaders">
- <simplemapping>org.apache.james.attribute1;headerName1</simplemapping>
- <simplemapping>org.apache.james.attribute2;headerName2</simplemapping>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_metricsmailet"><a class="anchor" href="#_metricsmailet"></a>MetricsMailet</h3>
-<div class="paragraph">
-<p>This Metrics mailet increments a counter on every incoming emails.</p>
-</div>
-<div class="paragraph">
-<p>This counter is accessible via JMX, or grafana. Read <a href="../operate/metrics.html" class="xref page">more about metrics</a>.</p>
-</div>
-<div class="paragraph">
-<p>Example :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="all" class="MetricsMailet">
- <metricName>relayDenied</metricName>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will increment a counter relayDenied</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_mailattributestomimeheaders_2"><a class="anchor" href="#_mailattributestomimeheaders_2"></a>MailAttributesToMimeHeaders</h3>
-<div class="paragraph">
-<p>This mailet replace the mail attribute map of key to MimePart
-by a map of key to the MimePart content (as bytes).</p>
-</div>
-<div class="paragraph">
-<p>It takes only one parameter:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>attribute (mandatory): mime content to be decoded, expected to be a Map<String, byte[]></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Then all this map attribute values will be replaced by their content.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_notifypostmaster"><a class="anchor" href="#_notifypostmaster"></a>NotifyPostmaster</h3>
-<div class="paragraph">
-<p>Sends a notification message to the Postmaster.</p>
-</div>
-<div class="paragraph">
-<p>A sender of the notification message can optionally be specified. If one is
-not specified, the postmaster’s address will be used.</p>
-</div>
-<div class="paragraph">
-<p>The "To:" header of the notification message can be set to "unaltered"; if
-missing will be set to the postmaster.</p>
-</div>
-<div class="paragraph">
-<p>A notice text can be specified, and in such case will be inserted into the
-notification inline text.</p>
-</div>
-<div class="paragraph">
-<p>If the notified message has an "error message" set, it will be inserted into
-the notification inline text. If the <strong>attachError</strong> init
-parameter is set to true, such error message will be attached to the
-notification message.</p>
-</div>
-<div class="paragraph">
-<p>The notified messages are attached in their entirety (headers and content)
-and the resulting MIME part type is "message/rfc822".</p>
-</div>
-<div class="paragraph">
-<p>Supports the <strong>passThrough</strong> init parameter (true if missing).</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="NotifyPostmaster">
- <sender>*an address or postmaster or sender or unaltered, default=postmaster*</sender>
- <attachError>*true or false, default=false*</attachError>
- <message>*notice attached to the original message text (optional)*</message>
- <prefix>*optional subject prefix prepended to the original message, default="Re:"*</prefix>
- <inline>*default=none*</inline>
- <attachment>*default=message*</attachment>
- <passThrough>*true or false, default=true*</passThrough>
- <fakeDomainCheck>*true or false, default=true*</fakeDomainCheck>
- <to>*unaltered (optional, defaults to postmaster)*</to>
- <debug>*true or false, default=false*</debug>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The behaviour of this mailet is equivalent to using Resend with the following
-configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="Resend">
- <sender>*an address or postmaster or sender or unaltered*</sender>
- <attachError>*true or false*</attachError>
- <message>*<b>dynamically built</b>*</message>
- <prefix>*a string*</prefix>
- <passThrough>*true or false*</passThrough>
- <fakeDomainCheck>*true or false*</fakeDomainCheck>
- <to>*<b>unaltered or postmaster</b>*</to>
- <recipients><b>postmaster</b></recipients>
- <inline>see {@link Resend}</inline>
- <attachment>see {@link Resend}</attachment>
- <isReply>true</isReply>
- <debug>*true or false*</debug>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>notice</strong>, <strong>sendingAddress</strong> and <strong>attachError</strong> can be used
-instead of <strong>message</strong>, <strong>sender</strong> and <strong>attachError</strong>; such names
-are kept for backward compatibility.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_notifysender"><a class="anchor" href="#_notifysender"></a>NotifySender</h3>
-<div class="paragraph">
-<p>Sends a notification message to the sender of a message.</p>
-</div>
-<div class="paragraph">
-<p>A sender of the notification message can optionally be specified. If one is
-not specified, the postmaster’s address will be used.</p>
-</div>
-<div class="paragraph">
-<p>The "To:" header of the notification message can be set to "unaltered"; if
-missing will be set to the sender of the notified message.</p>
-</div>
-<div class="paragraph">
-<p>A notice text can be specified, and in such case will be inserted into the
-notification inline text.</p>
-</div>
-<div class="paragraph">
-<p>If the notified message has an "error message" set, it will be inserted into
-the notification inline text. If the <strong>attachError</strong> init
-parameter is set to true, such error message will be attached to the
-notification message.</p>
-</div>
-<div class="paragraph">
-<p>The notified messages are attached in their entirety (headers and content)
-and the resulting MIME part type is "message/rfc822".</p>
-</div>
-<div class="paragraph">
-<p>Supports the <strong>passThrough</strong> init parameter (true if missing).</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="NotifySender">
- <sender>*an address or postmaster or sender or unaltered, default=postmaster*</sender>
- <attachError>*true or false, default=false*</attachError>
- <prefix>*optional subject prefix prepended to the original message*</prefix>
- <inline>default=none*</inline>
- <attachment>default=message*</attachment>
- <passThrough>*true or false, default=true*</passThrough>
- <fakeDomainCheck>*true or false, default=true*</fakeDomainCheck>
- <to>*unaltered or sender or from(optional, defaults to sender)*</to>
- <debug>*true or false, default=false*</debug>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The behaviour of this mailet is equivalent to using Resend with the following
-configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="Resend">
- <sender>*an address or postmaster or sender or unaltered*</sender>
- <attachError>*true or false*</attachError>
- <message>*<b>dynamically built</b>*</message>
- <prefix>*a string*</prefix>
- <passThrough>true</passThrough>
- <fakeDomainCheck>*true or false*</fakeDomainCheck>
- <to>*unaltered or sender or from&lt*;/to>
- <recipients><b>sender</b></recipients>
- <inline>none</inline>
- <attachment>message</attachment>
- <isReply>true</isReply>
- <debug>*true or false*</debug>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>notice</strong>, <strong>sendingAddress</strong> and <strong>attachError</strong> can be used
-instead of <strong>message</strong>, <strong>sender</strong> and <strong>attachError</strong>; such names
-are kept for backward compatibility.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_null"><a class="anchor" href="#_null"></a>Null</h3>
-<div class="paragraph">
-<p>Simplest Mailet which destroys any incoming messages by setting their state to GHOST.</p>
-</div>
-<div class="paragraph">
-<p>This effectively stops all processing of this mail.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_postmasteralias"><a class="anchor" href="#_postmasteralias"></a>PostmasterAlias</h3>
-<div class="paragraph">
-<p>Rewrites recipient addresses to make sure email for the postmaster is
-always handled. This mailet is silently inserted at the top of the root
-spool processor. All recipients mapped to postmaster@<servernames> are
-changed to the postmaster account as specified in the server conf.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_randomstoring"><a class="anchor" href="#_randomstoring"></a>RandomStoring</h3>
-<div class="paragraph">
-<p>Process messages and randomly assign them to 4 to 8 mailboxes.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_recipientrewritetable"><a class="anchor" href="#_recipientrewritetable"></a>RecipientRewriteTable</h3>
-<div class="paragraph">
-<p>Mailet which should get used when using RecipientRewriteTable-Store to
-implementations for mappings of forwards and aliases.</p>
-</div>
-<div class="paragraph">
-<p>By specifying an 'errorProcessor' you can specify your logic upon RecipientRewriteTable failures.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> <mailet match="All" class="RecipientRewriteTable">
- <errorProcessor>rrt-errors</errorProcessor>
- </mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The <strong>rewriteSenderUponForward</strong> option (default to true) can be used to prevent senders to be rewritten upon forwards in the transport envelope
-(JAMES 3.8.0 default behaviour). <strong>WARNING</strong>: Please note that not rewriting the sender will cause issues forwarding emails
-from external senders to external addresses as the DKIM and SPF records will not be matching the ones of the sending
-domain.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_recipienttolowercase"><a class="anchor" href="#_recipienttolowercase"></a>RecipientToLowerCase</h3>
-<div class="paragraph">
-<p>GenericMailet which convert all Recipients to lowercase.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_redirect"><a class="anchor" href="#_redirect"></a>Redirect</h3>
-<div class="paragraph">
-<p>A mailet providing configurable redirection services.</p>
-</div>
-<div class="paragraph">
-<p>Can produce listserver, forward and notify behaviour, with the original
-message intact, attached, appended or left out altogether.</p>
-</div>
-<div class="paragraph">
-<p>It differs from Resend because (i) some defaults are different,
-notably for the following parameters: <strong><recipients></strong>,
-<strong><to></strong>, <strong><reversePath></strong> and <strong><inline></strong>; (ii)
-because it allows the use of the <strong><static></strong> parameter;.</p>
-</div>
-<div class="paragraph">
-<p>Use <code>Resend</code> if you need full control, <code>Redirect</code> if
-the more automatic behaviour of some parameters is appropriate.</p>
-</div>
-<div class="paragraph">
-<p>This built in functionality is controlled by the configuration as laid out
-below. In the table please note that the parameters controlling message
-headers accept the <b>"unaltered"</b> value, whose meaning is to
-keep the associated header unchanged and, unless stated differently,
-corresponds to the assumed default if the parameter is missing.</p>
-</div>
-<div class="paragraph">
-<p>The configuration parameters are:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. Redirect parameters</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">recipients</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A comma delimited list of addresses for recipients of this message; it will
-use the "to" list if not specified, and "unaltered" if
-none of the lists is specified.</p>
-<p class="tableblock">These addresses will only appear in the To: header if no "to" list
-is supplied.</p>
-<p class="tableblock">Such addresses can contain "full names", like <strong>Mr. John D. Smith
-<<a href="mailto:john.smith@xyz.com">john.smith@xyz.com</a>></strong>.</p>
-<p class="tableblock">The list can include constants "sender", "from",
-"replyTo", "postmaster", "reversePath",
-"recipients", "to", "null" and
-"unaltered"; "replyTo" uses the ReplyTo header if
-available, otherwise the From header if available, otherwise the Sender
-header if available, otherwise the return-path; "from" is made
-equivalent to "sender", and "to" is made equivalent to
-"recipients"; "null" is ignored.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">to</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A comma delimited list of addresses to appear in the To: header; the email
-will be delivered to any of these addresses if it is also in the recipients
-list.</p>
-<p class="tableblock">The recipients list will be used if this list is not supplied; if none of the
-lists is specified it will be "unaltered".</p>
-<p class="tableblock">Such addresses can contain "full names", like <strong>Mr. John D. Smith
-<<a href="mailto:john.smith@xyz.com">john.smith@xyz.com</a>></strong>.</p>
-<p class="tableblock">The list can include constants "sender", "from",
-"replyTo", "postmaster", "reversePath",
-"recipients", "to", "null" and
-"unaltered"; "from" uses the From header if available,
-otherwise the Sender header if available, otherwise the return-path;
-"replyTo" uses the ReplyTo header if available, otherwise the From
-header if available, otherwise the Sender header if available, otherwise the
-return-path; "recipients" is made equivalent to "to"; if
-"null" is specified alone it will remove this header.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">sender</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">single email address to appear in the From: and Return-Path: headers and
-become the sender.</p>
-<p class="tableblock">It can include constants "sender", "postmaster" and
-"unaltered"; "sender" is equivalent to
-"unaltered".</p>
-<p class="tableblock">Default: "unaltered".</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">message</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A text message to insert into the body of the email.</p>
-<p class="tableblock">Default: no message is inserted.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">inline</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">One of the following items:</p>
-<p class="tableblock">* unaltered The original message is the new
-message, for forwarding/aliasing
-* heads The
-headers of the original message are appended to the message
-* body The
-body of the original is appended to the new message
-*
-all &nbsp
-; Both headers and body are appended
-* none
-Neither body nor headers are appended
-</ul>
-Default: "body".</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">attachment</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">One of the following items:</p>
-<p class="tableblock">* heads The headers of the original are
-attached as text
-* body The body of the original is
-attached as text
-* all Both
-headers and body are attached as a single text file
-* none Nothing is attached
-* message The original message is attached as type message/rfc822,
-this means that it can, in many cases, be opened, resent, fw’d, replied to
-etc by email client software.</p>
-<p class="tableblock">Default: "none".</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">passThrough</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false, if true the original message continues in the mailet processor
-after this mailet is finished. False causes the original to be stopped.</p>
-<p class="tableblock">Default: false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">fakeDomainCheck</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false, if true will check if the sender domain is valid.</p>
-<p class="tableblock">Default: true.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">attachError</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false, if true any error message available to the mailet is appended
-to the message body (except in the case of inline == unaltered).</p>
-<p class="tableblock">Default: false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">replyTo</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A single email address to appear in the Reply-To: header.</p>
-<p class="tableblock">It can include constants "sender", "postmaster"
-"null" and "unaltered"; if "null" is specified
-it will remove this header.</p>
-<p class="tableblock">Default: "unaltered".</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">reversePath</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A single email address to appear in the Return-Path: header.</p>
-<p class="tableblock">It can include constants "sender", "postmaster" and
-"null"; if "null" is specified then it will set it to <>,
-meaning "null return path".</p>
-<p class="tableblock">Notice: the "unaltered" value is <strong>not allowed</strong>.</p>
-<p class="tableblock">Default: the value of the <strong><sender></strong> parameter, if set, otherwise
-remains unaltered.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">subject</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">An optional string to use as the subject.</p>
-<p class="tableblock">Default: keep the original message subject.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">prefix</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">An optional subject prefix prepended to the original message subject, or to a
-new subject specified with the <strong><subject></strong> parameter.</p>
-<p class="tableblock">For example: <strong>[Undeliverable mail]</strong>.</p>
-<p class="tableblock">Default: ".</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">isReply</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false, if true the IN_REPLY_TO header will be set to the id of the
-current message.</p>
-<p class="tableblock">Default: false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">debug</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false. If this is true it tells the mailet to write some debugging
-information to the mailet log.</p>
-<p class="tableblock">Default: false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">static</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false. If this is true it tells the mailet that it can reuse all the
-initial parameters (to, from, etc) without re-calculating their values. This
-will boost performance where a redirect task doesn’t contain any dynamic
-values. If this is false, it tells the mailet to recalculate the values for
-each e-mail processed.</p>
-<p class="tableblock">Default: false.</p></td>
-</tr>
-</tbody>
-</table>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> <mailet match="RecipientIs=test@localhost" class="Redirect">
- <recipients>x@localhost, y@localhost, z@localhost</recipients>
- <to>list@localhost</to>
- <sender>owner@localhost</sender>
- <message>sent on from James</message>
- <inline>unaltered</inline>
- <passThrough>FALSE</passThrough>
- <replyTo>postmaster</replyTo>
- <prefix xml:space="preserve">[test mailing] </prefix>
- <!-- note the xml:space="preserve" to preserve whitespace -->
- <static>TRUE</static>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>and:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> <mailet match="All" class="Redirect">
- <recipients>x@localhost</recipients>
- <sender>postmaster</sender>
- <message xml:space="preserve">Message marked as spam:</message>
- <inline>heads</inline>
- <attachment>message</attachment>
- <passThrough>FALSE</passThrough>
- <attachError>TRUE</attachError>
- <replyTo>postmaster</replyTo>
- <prefix>[spam notification]</prefix>
- <static>TRUE</static>
- </mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>replyto</strong> can be used instead of <strong>replyTo</strong>; such name is kept for
-backward compatibility.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_remotedelivery"><a class="anchor" href="#_remotedelivery"></a>RemoteDelivery</h3>
-<div class="paragraph">
-<p>The RemoteDelivery mailet delivers messages to a remote SMTP server able to deliver or forward messages to their final
-destination.</p>
-</div>
-<div class="paragraph">
-<p>The remote SMTP server through which each mail is delivered is resolved using MX lookup for each message destination
-unless the <strong><gateway/></strong> parameter is set. The <strong><gateway/></strong> parameter enables the
-definition of one or more gateway servers through which all messages are sent.</p>
-</div>
-<div class="paragraph">
-<p>If an attempt to deliver a message fails, a redelivery attempt is scheduled according to the scheme defined
-by the <strong><delayTime/></strong> parameter, retrying up to the limit defined
-by the <strong><maxRetries/></strong> parameter. When the retry limit is exceeded, delivery failure is processed
-according to the setting of the <strong><bounceProcessor/></strong> parameter.</p>
-</div>
-<div class="paragraph">
-<p>These are the parameters that control the operation of the RemoteDelivery mailet:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>outgoing</strong> (required) - a String containing the name of the queue that will hold messages being processed by this mailet.</p>
-</li>
-<li>
-<p><strong>bind</strong> (optional) - a String describing the local IP address to which the mailet should be bound while delivering
-emails. This tag is useful for multihomed machines. Default is to bind to the default local address of the machine.<br>
-Note: The same IP address must be used for all of those RemoteDelivery instances where you explicitly supply a bind address.</p>
-</li>
-<li>
-<p><strong>delayTime</strong> (optional) a String containing a comma separated list of patterns defining the number of and delays between delivery
-attempts. The pattern is <strong>[attempts\</strong>]delay [unit]* where:</p>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>attempts</strong> (optional) - an Integer for the number of delivery attempts. Default is 1.</p>
-</li>
-<li>
-<p><strong>delay</strong> (required) - a Long for the delay between attempts.</p>
-</li>
-<li>
-<p><strong>unit</strong> (optional) - a String with the value of one of 'msec', 'sec', 'minute', 'hour', or 'day'. Default is msec.</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Default is one attempt after 6 hours, which if explicitly declared would be written as <strong><delayTime>1 6 hour</delayTime></strong></p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>maxRetries</strong> (optional) an Integer for the number of times an attempt is made to deliver a particular mail.
-Default is the greater of five and the sum of the attempts for each <strong><delayTime/></strong> specified.</p>
-</li>
-<li>
-<p><strong>maxDnsProblemRetries</strong> (optional) - an Integer for the number of times to retry if DNS problems for a domain occur.
-Default is 0.</p>
-</li>
-<li>
-<p><strong>timeout</strong> (optional) - an Integer for the Socket I/O timeout in milliseconds. Default is 180000</p>
-</li>
-<li>
-<p><strong>connectionTimeout</strong> (optional) - an Integer for the Socket connection timeout in milliseconds. Default is 60000</p>
-</li>
-<li>
-<p><strong>bounceProcessor</strong> (optional) - a String containing the name of the mailet processor to pass messages that cannot
-be delivered to for DSN bounce processing. Default is to send a traditional message containing the bounce details.</p>
-</li>
-<li>
-<p><strong>onSuccess</strong> (optional) - if specified, this processor is called for each email successfully sent to remote third parties.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>When using bounceProcessor or onSuccess processors, take special care of error handling (see onMailetException and onMatcherException)
- to avoid confusing situations. Also remember that on partial delivery, both processors will be used: <strong>onSuccess</strong> with successfull recipients,
- and <strong>bounceProcessor</strong> with failed recipients.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>startTLS</strong> (optional) - a Boolean (true/false) indicating whether the STARTTLS command (if supported by the server)
-to switch the connection to a TLS-protected connection before issuing any login commands. Default is false.</p>
-</li>
-<li>
-<p><strong>sslEnable</strong> (optional) - a Boolean (true/false) indicating whether to use SSL to connect and use the SSL port unless
-explicitly overridden. Default is false. Setting up to true will result in delivery attempts in SMTPS on port 465 with a fallback
-to SMTP on port 25. The trust-store if needed can be customized by <strong>-Djavax.net.ssl.trustStore=/root/conf/keystore</strong>.</p>
-</li>
-<li>
-<p><strong>verifyServerIdentity</strong> (optional) - a Boolean (true/false) indicating whether to match the remote server name against its certificate on TLS connections. Default is true. Disabling this runs the risk of someone spoofing a legitimate server and intercepting mails, but may be necessary to contact servers that have strange certificates, no DNS entries, are reachable by IP address only, and similar edge cases.</p>
-</li>
-<li>
-<p><strong>gateway</strong> (optional) - a String containing a comma separated list of patterns defining the gateway servers to be used to
-deliver mail regardless of the recipient address. If multiple gateway servers are defined, each will be tried in definition order
-until delivery is successful. If none are successful, the mail is bounced. The pattern is <strong>host[:port]</strong> where:</p>
-</li>
-<li>
-<p><strong>host</strong> (required) - the FQN of the gateway server.</p>
-</li>
-<li>
-<p><strong>port</strong> (optional) - the port of the gateway server. Default is the value defined in the <strong><gatewayPort/></strong>
-parameter if set, else the default port for the specified connection type.
-Default is to resolve the destination SMTP server for each mail using MX lookup.</p>
-</li>
-<li>
-<p><strong>gatewayPort</strong> (optional) - an Integer for the gateway port to be used for each defined gateway server for which a
-port is not explicitly defined in the <strong><gateway/></strong> parameter. Default is the default port for the specified connection type.</p>
-</li>
-<li>
-<p><strong>gatewayUsername</strong> (optional) - a String containing the user name to be used to authenticate the user using the
-AUTH command. Default is not to issue the AUTH command.</p>
-</li>
-<li>
-<p><strong>gatewayPassword</strong> (required if <strong>gatewayUsername</strong>) is set - a String representing the password to be used
-to authenticate the user using the AUTH command.</p>
-</li>
-<li>
-<p><strong>loadBalancing</strong> (optional) - a Boolean (true/false) indicating whether load should be balanced randomly over all defined gateway server. Default is true, false leads to failover only.</p>
-</li>
-<li>
-<p><strong>heloName</strong> (optional) - a String containing the name used in the SMTP HELO and EHLO commands. Default is the default domain,
-which is typically <strong>localhost</strong>.</p>
-</li>
-<li>
-<p><strong>mail.</strong>* (optional) - Any property beginning with <strong>mail.</strong> described in the Javadoc for package
-<a href="https://eclipse-ee4j.github.io/angus-mail/docs/api/org.eclipse.angus.mail/org/eclipse/angus/mail/smtp/package-summary.html">*org.eclipse.angus.mail.smtp*</a>
-can be set with a parameter of the corresponding name. For example the parameter
-<strong><mail.smtp.ssl.enable>true</mail.smtp.ssl.enable></strong> is equivalent to the Java code
-<strong>props.put("mail.smtp.ssl.enable", "true");</strong>. Properties set by this facility override settings made
-within the mailet code.<br>
-Note: This facility should be used with extreme care by expert users with a thorough knowledge of the relevant RFCs and
-the ability to perform their own problem resolutions.</p>
-</li>
-<li>
-<p><strong>debug</strong> (optional) - a Boolean (true/false) indicating whether debugging is on. Default is false.</p>
-</li>
-</ul>
-</div>
-<div class="sect3">
-<h4 id="_security"><a class="anchor" href="#_security"></a>Security</h4>
-<div class="paragraph">
-<p>You can use the <strong>sslEnable</strong> parameter described above to force SMTP outgoing delivery to default to SSL encrypted traffic (SMTPS).
-This is a shortcut for the <strong>mail.smtps.ssl.enable</strong> javax property.</p>
-</div>
-<div class="paragraph">
-<p>When enabling SSL, you might need to specify the <strong>mail.smtps.ssl.trust</strong> property as well.
-You can also control ciphersuites and protocols via <strong>mail.smtps.ssl.ciphersuites</strong> and
-<strong>mail.smtps.ssl.protocols</strong> properties.</p>
-</div>
-<div class="paragraph">
-<p>StartTLS can alternatively be enabled upon sending a mail. For this, use the <strong>startTls</strong> parameter, serving as a shortcut for the
-javax <strong>mail.smtp.starttls.enable</strong> property. Depending on how strict your security policy is, you might consider
-<strong>mail.smtp.starttls.required</strong> as well. Be aware that configuring trust will then be required.
-You can also use other javax properties for StartTLS, but their property prefix must be <strong>mail.smtp.ssl.</strong> in this case.</p>
-</div>
-<div class="paragraph">
-<p>James enables server identity verification by default. In certain rare edge cases you might disable it via the <strong>verifyServerIdentity</strong> parameter,
-or use the <strong>mail.smtps.ssl.checkserveridentity</strong> and <strong>mail.smtp.ssl.checkserveridentity</strong> javax properties for fine control.</p>
-</div>
-<div class="paragraph">
-<p>Read <a href="https://eclipse-ee4j.github.io/angus-mail/docs/api/org.eclipse.angus.mail/org/eclipse/angus/mail/smtp/package-summary.html"><strong>org.eclipse.angus.mail.smtp</strong></a>
-for full information.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_removeallmailattributes"><a class="anchor" href="#_removeallmailattributes"></a>RemoveAllMailAttributes</h3>
-<div class="paragraph">
-<p>This mailet sets removes all attributes set on the Mail instance</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="RemoveAllMailAttributes"/></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_removemailattribute"><a class="anchor" href="#_removemailattribute"></a>RemoveMailAttribute</h3>
-<div class="paragraph">
-<p>This mailet sets attributes on the Mail.</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="RemoveMailAttribute">
- <name>attribute_name1</name>
- <name>attribute_name2</name>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_removemimeheader"><a class="anchor" href="#_removemimeheader"></a>RemoveMimeHeader</h3>
-<div class="paragraph">
-<p>Remove mime headers from the message (global) and per recipient (specific).</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="RemoveMimeHeader">
- <name>header1,header2</name>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_removemimeheader_2"><a class="anchor" href="#_removemimeheader_2"></a>RemoveMimeHeader</h3>
-<div class="paragraph">
-<p>This mailet removes all of the headers starting with a given prefix in the message (global) and per recipient (specific).</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="RemoveMimeHeaderByPrefix">
- <name>X-APPLICATIVE-HEADER-</name>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_replacecontent"><a class="anchor" href="#_replacecontent"></a>ReplaceContent</h3>
-<div class="paragraph">
-<p>Replace text contents</p>
-</div>
-<div class="paragraph">
-<p>This mailet allow to specific regular expression to replace text in subject and content.</p>
-</div>
-<div class="paragraph">
-<p>Each expression is defined as: <strong>/REGEX_PATTERN/SUBSTITUTION_PATTERN/FLAGS/</strong></p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>REGEX_PATTERN</strong> is a regex used for the match</p>
-</li>
-<li>
-<p><strong>SUBSTITUTION_PATTERN</strong> is a substitution pattern</p>
-</li>
-<li>
-<p><strong>FLAGS</strong> flags supported for the pattern:</p>
-<div class="ulist">
-<ul>
-<li>
-<p>i: case insensitive</p>
-</li>
-<li>
-<p>m: multi line</p>
-</li>
-<li>
-<p>x: extended (N/A)</p>
-</li>
-<li>
-<p>r: repeat - keep matching until a substitution is possible</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>To identify subject and body pattern we use the tags <subjectPattern> and <bodyPattern></p>
-</div>
-<div class="paragraph">
-<p>Rules can be specified in external files.
-Lines must be CRLF terminated and lines starting with # are considered comments.
-Tags used to include external files are <subjectPatternFile> and
-<bodyPatternFile>
-If file path starts with # then the file is loaded as a resource.</p>
-</div>
-<div class="paragraph">
-<p>Use of both files and direct patterns at the same time is allowed.</p>
-</div>
-<div class="paragraph">
-<p>This mailet allow also to enforce the resulting charset for messages processed, when a replacement has been done.
-To do that the tag <charset> must be specified.</p>
-</div>
-<div class="paragraph">
-<p>NOTE:
-Regexp rules must be escaped by regexp escaping rules and applying this 2 additional rules:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>"/" char inside an expression must be prefixed with "\":
-e.g: "/\//-//" replaces "/" with "-"</p>
-</li>
-<li>
-<p>when the rules are specified using <subjectPattern> or <bodyPattern> and
-"/,/" has to be used in a pattern string it must be prefixed with a "\".
-E.g: "/\/\/,//" replaces "/" with "," (the rule would be "/\//,//" but the "/,/" must
-be escaped.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_resend"><a class="anchor" href="#_resend"></a>Resend</h3>
-<div class="paragraph">
-<p>A mailet providing configurable redirection services.</p>
-</div>
-<div class="paragraph">
-<p>Can produce listserver, forward and notify behaviour, with the original
-message intact, attached, appended or left out altogether. Can be used as a
-replacement to {@link Redirect}, having more consistent defaults, and new
-options available.</p>
-</div>
-<div class="paragraph">
-<p>Use <code>Resend</code> if you need full control, <code>Redirect</code> if
-the more automatic behaviour of some parameters is appropriate.</p>
-</div>
-<div class="paragraph">
-<p>This built in functionality is controlled by the configuration as laid out
-below. In the table please note that the parameters controlling message
-headers accept the <b>"unaltered"</b> value, whose meaning is to
-keep the associated header unchanged and, unless stated differently,
-corresponds to the assumed default if the parameter is missing.</p>
-</div>
-<div class="paragraph">
-<p>The configuration parameters are:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 2. Resend properties</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">recipients</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A comma delimited list of addresses for recipients of this message.</p>
-<p class="tableblock">Such addresses can contain "full names", like <strong>Mr. John D. Smith
-<<a href="mailto:john.smith@xyz.com">john.smith@xyz.com</a>></strong>.</p>
-<p class="tableblock">The list can include constants "sender", "from",
-"replyTo", "postmaster", "reversePath",
-"recipients", "to", "null" and
-"unaltered"; "replyTo" uses the ReplyTo header if
-available, otherwise the From header if available, otherwise the Sender
-header if available, otherwise the return-path; "from" is made
-equivalent to "sender", and "to" is made equivalent to
-"recipients"; "null" is ignored. Default:
-"unaltered".</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">to</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A comma delimited list of addresses to appear in the To: header.</p>
-<p class="tableblock">Such addresses can contain "full names", like <strong>Mr. John D. Smith
-<<a href="mailto:john.smith@xyz.com">john.smith@xyz.com</a>></strong>.</p>
-<p class="tableblock">The list can include constants "sender", "from",
-"replyTo", "postmaster", "reversePath",
-"recipients", "to", "null" and
-"unaltered"; "from" uses the From header if available,
-otherwise the Sender header if available, otherwise the return-path;
-"replyTo" uses the ReplyTo header if available, otherwise the From
-header if available, otherwise the Sender header if available, otherwise the
-return-path; "recipients" is made equivalent to "to"; if
-"null" is specified alone it will remove this header. Default:
-"unaltered".</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">sender</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A single email address to appear in the From: header and become the sender.</p>
-<p class="tableblock">It can include constants "sender", "postmaster" and
-"unaltered"; "sender" is equivalent to
-"unaltered".</p>
-<p class="tableblock">Default: "unaltered".</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">message</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A text message to insert into the body of the email.</p>
-<p class="tableblock">Default: no message is inserted.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">inline</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">One of the following items:
-</p>
-<ul>
-* unaltered The original message is the new
-message, for forwarding/aliasing
-* heads The
-headers of the original message are appended to the message
-* body The
-body of the original is appended to the new message
-*
-all &nbsp
-; Both headers and body are appended
-* none
-Neither body nor headers are appended</p>
-<p class="tableblock">Default: "unaltered".</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">attachment</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">One of the following items:</p>
-<p class="tableblock">* heads The headers of the original are
-attached as text
-* body The body of the original is
-attached as text
-* all Both
-headers and body are attached as a single text file
-* none Nothing is attached
-* message The original message is attached as type message/rfc822,
-this means that it can, in many cases, be opened, resent, fw’d, replied to
-etc by email client software.</p>
-<p class="tableblock">Default: "none".</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">passThrough</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false, if true the original message continues in the mailet processor
-after this mailet is finished. False causes the original to be stopped.</p>
-<p class="tableblock">Default: false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">fakeDomainCheck</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false, if true will check if the sender domain is valid.</p>
-<p class="tableblock">Default: true.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">attachError</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false, if true any error message available to the mailet is appended
-to the message body (except in the case of inline == unaltered).</p>
-<p class="tableblock">Default: false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">replyTo</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A single email address to appear in the Reply-To: header.</p>
-<p class="tableblock">It can include constants "sender", "postmaster"
-"null" and "unaltered"; if "null" is specified
-it will remove this header.</p>
-<p class="tableblock">Default: "unaltered".</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">reversePath</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A single email address to appear in the Return-Path: header.</p>
-<p class="tableblock">It can include constants "sender", "postmaster"
-"null" and "unaltered"; if "null" is specified
-then it will set it to <>, meaning "null return path".</p>
-<p class="tableblock">Default: "unaltered".</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">subject</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">An optional string to use as the subject.</p>
-<p class="tableblock">Default: keep the original message subject.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">prefix</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">An optional subject prefix prepended to the original message subject, or to a
-new subject specified with the <strong><subject></strong> parameter.</p>
-<p class="tableblock">For example: <strong>[Undeliverable mail]</strong>.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">isReply</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false, if true the IN_REPLY_TO header will be set to the id of the
-current message.</p>
-<p class="tableblock">Default: false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">debug</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false. If this is true it tells the mailet to write some debugging
-information to the mailet log.</p>
-<p class="tableblock">Default: false.</p></td>
-</tr>
-</tbody>
-</table>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> <mailet match="RecipientIs=test@localhost" class="Resend">
- <recipients>x@localhost, y@localhost, z@localhost</recipients>
- <to>list@localhost</to>
- <sender>owner@localhost</sender>
- <message>sent on from James</message>
- <inline>unaltered</inline>
- <passThrough>FALSE</passThrough>
- <replyTo>postmaster</replyTo>
- <prefix xml:space="preserve">[test mailing] </prefix>
- <!-- note the xml:space="preserve" to preserve whitespace -->
- <static>TRUE</static>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>and:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> <mailet match="All" class="Resend">
- <recipients>x@localhost</recipients>
- <sender>postmaster</sender>
- <message xml:space="preserve">Message marked as spam:</message>
- <inline>heads</inline>
- <attachment>message</attachment>
- <passThrough>FALSE</passThrough>
- <attachError>TRUE</attachError>
- <replyTo>postmaster</replyTo>
- <prefix>[spam notification]</prefix>
- </mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The following example forwards the message without any modification, based on
-the defaults:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> <mailet match="All" class="Resend&quot/;></pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>replyto</strong> can be used instead of <strong>replyTo</strong>; such name is kept for
-backward compatibility.</p>
-</div>
-<div class="admonitionblock warning">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-warning" title="Warning"></i>
-</td>
-<td class="content">
-as the message (or a copy of it) is reinjected in the spool
-without any modification, the preceding example is very likely to cause a
-"configuration loop" in your system, unless some other mailet has previously
-modified something (a header for instance) that could force the resent
-message follow a different path so that it does not return here
-unchanged.
-</td>
-</tr>
-</table>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_setmailattribute"><a class="anchor" href="#_setmailattribute"></a>SetMailAttribute</h3>
-<div class="paragraph">
-<p>This mailet sets attributes on the Mail.</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="SetMailAttribute">
- <name1>value1</name1>
- <name2>value2</name2>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_setmailattribute_2"><a class="anchor" href="#_setmailattribute_2"></a>SetMailAttribute</h3>
-<div class="paragraph">
-<p>Adds a specified header and value to the message.</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="AddHeader">
- <name>X-MailetHeader</name>
- <value>TheHeaderValue</value>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_sieve"><a class="anchor" href="#_sieve"></a>Sieve</h3>
-<div class="paragraph">
-<p>Execute Sieve scripts for incoming emails, and set the result of the execution as attributes of the mail</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_sign"><a class="anchor" href="#_sign"></a>Sign</h3>
-<div class="paragraph">
-<p>Puts a <strong>server-side</strong> SMIME signature on a message.</p>
-</div>
-<div class="paragraph">
-<p>It is a concrete subclass of Sign, with very few modifications to it,
-to specialize for SMIME.</p>
-</div>
-<div class="paragraph">
-<p>Handles the following init parameters:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><keyHolderClass>: Sets the class of the KeyHolder object that will handle the cryptography functions,
-for example org.apache.james.security.SMIMEKeyHolder for SMIME.</p>
-</li>
-<li>
-<p><debug>: if <strong>true</strong> some useful information is logged.
-The default is <strong>false</strong>.</p>
-</li>
-<li>
-<p><keyStoreFileName>: the {@link java.security.KeyStore} full file name.</p>
-</li>
-<li>
-<p><keyStorePassword>: the <strong>KeyStore</strong> password.
-If given, it is used to check the integrity of the keystore data,
-otherwise, if null, the integrity of the keystore is not checked.</p>
-</li>
-<li>
-<p><keyAlias>: the alias name to use to search the Key using {@link java.security.KeyStore#getKey}.
-The default is to look for the first and only alias in the keystore;
-if zero or more than one is found a {@link java.security.KeyStoreException} is thrown.</p>
-</li>
-<li>
-<p><keyAliasPassword>: the alias password. The default is to use the <strong>KeyStore</strong> password.
-At least one of the passwords must be provided.</p>
-</li>
-<li>
-<p><keyStoreType>: the type of the keystore. The default will use {@link java.security.KeyStore#getDefaultType}.</p>
-</li>
-<li>
-<p><postmasterSigns>: if <strong>true</strong> the message will be signed even if the sender is the Postmaster. The default is <strong>true</strong>.</p>
-</li>
-<li>
-<p><rebuildFrom>: If <strong>true</strong> will modify the "From:" header. The default is <strong>true</strong>.</p>
-</li>
-<li>
-<p><signerName>: the name of the signer to be shown in the explanation text. The default is to use the "CN="
-property of the signing certificate.</p>
-</li>
-<li>
-<p><explanationText>. There is a default explanation string template in English, displaying
-also all the headers of the original message.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_smimechecksignature"><a class="anchor" href="#_smimechecksignature"></a>SMIMECheckSignature</h3>
-<div class="paragraph">
-<p>Verifies the s/mime signature of a message. The s/mime signing ensure that
-the private key owner is the real sender of the message. To be checked by
-this mailet the s/mime signature must contain the actual signature, the
-signer’s certificate and optionally a set of certificate that can be used to
-create a chain of trust that starts from the signer’s certificate and leads
-to a known trusted certificate.</p>
-</div>
-<div class="paragraph">
-<p>This check is composed by two steps: firstly it’s ensured that the signature
-is valid, then it’s checked if a chain of trust starting from the signer
-certificate and that leads to a trusted certificate can be created. The first
-check verifies that the message has not been modified after the signature
-was put and that the signer’s certificate was valid at the time of the
-signing. The latter should ensure that the signer is who he declare to be.</p>
-</div>
-<div class="paragraph">
-<p>The results of the checks perfomed by this mailet are wrote as a mail
-attribute which default name is org.apache.james.SMIMECheckSignature (it can
-be changed using the mailet parameter <strong>mailAttribute</strong>). After
-the check this attribute will contain a list of SMIMESignerInfo object, one
-for each message’s signer. These objects contain the signer’s certificate and
-the trust path.</p>
-</div>
-<div class="paragraph">
-<p>Optionally, specifying the parameter <strong>strip</strong>, the signature of
-the message can be stripped after the check. The message will become a
-standard message without an attached s/mime signature.</p>
-</div>
-<div class="paragraph">
-<p>The configuration parameter of this mailet are summerized below. The firsts
-defines the location, the format and the password of the keystore containing
-the certificates that are considered trusted. Note: only the trusted certificate
-entries are read, the key ones are not.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>keyStoreType (default: jks): Certificate store format . "jks" is the
-standard java certificate store format, but pkcs12 is also quite common and
-compatible with standard email clients like Outlook Express and Thunderbird.</p>
-</li>
-<li>
-<p>keyStoreFileName (default: JAVA_HOME/jre/lib/security/cacert): Certificate
-store path.</p>
-</li>
-<li>
-<p>keyStorePassword (default: ""): Certificate store password.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Other parameters configure the behavior of the mailet:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>strip (default: false): Defines if the s/mime signature of the message
-have to be stripped after the check or not. Possible values are true and
-false.</p>
-</li>
-<li>
-<p>mailAttribute (default: org.apache.james.SMIMECheckSignature):
-specifies in which attribute the check results will be written.</p>
-</li>
-<li>
-<p>onlyTrusted (default: true): Usually a message signature to be
-considered by this mailet as authentic must be valid and trusted. Setting
-this mailet parameter to "false" the last condition is relaxed and also
-"untrusted" signature are considered will be considered as authentic.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_smimedecrypt"><a class="anchor" href="#_smimedecrypt"></a>SMIMEDecrypt</h3>
-<div class="paragraph">
-<p>This mailet decrypts a s/mime encrypted message. It takes as input an
-encrypted message and it tries to dechiper it using the key specified in its
-configuration. If the decryption is successful the mail will be changed and
-it will contain the decrypted message. The mail attribute
-<strong>org.apache.james.SMIMEDecrypt</strong> will contain the public
-certificate of the key used in the process.</p>
-</div>
-<div class="paragraph">
-<p>The configuration parameters of this mailet are summarized below. The firsts
-define the keystore where the key that will be used to decrypt messages is
-saved.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>keyStoreType (default: system dependent): defines the type of the store.
-Usually jks, pkcs12 or pkcs7</p>
-</li>
-<li>
-<p>keyStoreFileName (mandatory): private key store path.</p>
-</li>
-<li>
-<p>keyStorePassword (default: ""): private key store password</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The other parameters define which private key have to be used. (if the store
-contains more than one key).</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>keyAlias: private key alias.</p>
-</li>
-<li>
-<p>keyPass: private key password</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_smimesign"><a class="anchor" href="#_smimesign"></a>SMIMESign</h3>
-<div class="paragraph">
-<p>Puts a <strong>server-side</strong> signature on a message.</p>
-</div>
-<div class="paragraph">
-<p>It is a concrete subclass of AbstractSign, with very few modifications to it.</p>
-</div>
-<div class="paragraph">
-<p>A text file with an explanation text is attached to the original message,
-and the resulting message with all its attachments is signed.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>The resulting appearance of the message is almost unchanged: only an extra attachment</p>
-</li>
-<li>
-<p>and the signature are added.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The kind of signature depends on the value of the <keyHolderClass> init parameter.</p>
-</div>
-<div class="paragraph">
-<p>Handles the following init parameters:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><keyHolderClass>: Sets the class of the KeyHolder object that will handle the cryptography functions,
-for example org.apache.james.security.SMIMEKeyHolder for SMIME.</p>
-</li>
-<li>
-<p><debug>: if <strong>true</strong> some useful information is logged.
-The default is <strong>false</strong>.</p>
-</li>
-<li>
-<p><keyStoreFileName>: the {@link java.security.KeyStore} full file name.</p>
-</li>
-<li>
-<p><keyStorePassword>: the <strong>KeyStore</strong> password.
-If given, it is used to check the integrity of the keystore data,
-otherwise, if null, the integrity of the keystore is not checked.</p>
-</li>
-<li>
-<p><keyAlias>: the alias name to use to search the Key using {@link java.security.KeyStore#getKey}.
-The default is to look for the first and only alias in the keystore;
-if zero or more than one is found a {@link java.security.KeyStoreException} is thrown.</p>
-</li>
-<li>
-<p><keyAliasPassword>: the alias password. The default is to use the <strong>KeyStore</strong> password.
-At least one of the passwords must be provided.</p>
-</li>
-<li>
-<p><keyStoreType>: the type of the keystore. The default will use {@link java.security.KeyStore#getDefaultType}.</p>
-</li>
-<li>
-<p><postmasterSigns>: if <strong>true</strong> the message will be signed even if the sender is the Postmaster. The default is <strong>true</strong>.</p>
-</li>
-<li>
-<p><rebuildFrom>: If <strong>true</strong> will modify the "From:" header. The default is <strong>true</strong>.</p>
-</li>
-<li>
-<p><signerName>: the name of the signer to be shown in the explanation text. The default is to use the "CN="
-property of the signing certificate.</p>
-</li>
-<li>
-<p><explanationText>. There is a default explanation string template in English, displaying
-also all the headers of the original message.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_spamassassin"><a class="anchor" href="#_spamassassin"></a>SpamAssassin</h3>
-<div class="paragraph">
-<p>Sends the message through daemonized SpamAssassin (spamd), visit
-<a href="http://spamassassin.apache.org">spamassassin.apache.org</a> for info
-on configuration. The header X-Spam-Status is added to every message, this
-contains the score and the threshold score for spam (usually 5.0). If the
-message exceeds the threshold, the header X-Spam-Flag will be added with the
-value of YES. The default host for spamd is localhost and the default port is
-783.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> org.apache.james.spamassassin.status - Holds the status
- org.apache.james.spamassassin.flag - Holds the flag</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Sample Configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet notmatch="SenderHostIsLocal" class="SpamAssassin">
- <spamdHost>localhost</spamdHost>
- <spamdPort>783</spamdPort>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_stripattachment"><a class="anchor" href="#_stripattachment"></a>StripAttachment</h3>
-<div class="paragraph">
-<p>Remove attachments from a Message. Supports simple removal, storing to file,
-or storing to mail attributes.</p>
-</div>
-<div class="paragraph">
-<p>Configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match=&quot;All&quot; class=&quot;StripAttachment&quot; >
- <pattern >.*\.xls </pattern> <!-- The regular expression that must be matched -- >
- <!-- notpattern >.*\.xls </notpattern--> <!-- The regular expression that must be matched -- >
- <mimeType>text/calendar</mimeType> <!-- The matching mimeType -- >
- <directory >c:\temp\james_attach </directory> <!-- The directory to save to -- >
- <remove >all </remove> <!-- either &quot;no&quot;, &quot;matched&quot;, &quot;all&quot; -- >
- <!-- attribute>my.attribute.name</attribute -->
-</mailet ></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>At least one of pattern, notpattern and mimeType is required.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_textcalendarbodytoattachment"><a class="anchor" href="#_textcalendarbodytoattachment"></a>TextCalendarBodyToAttachment</h3>
-<div class="paragraph">
-<p>This mailet converts Content-Type of MimeMessage from text/calendar to mulitpart/mixed</p>
-</div>
-<div class="paragraph">
-<p>The BodyPart should be retrieved from content of text/calendar with all the same "Content-*" headers from original message
-and those "Content-" header are removed from original message</p>
-</div>
-<div class="paragraph">
-<p>It does not takes any parameter</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="TextCalendarBodyToAttachment"/></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_toprocessor"><a class="anchor" href="#_toprocessor"></a>ToProcessor</h3>
-<div class="paragraph">
-<p>This mailet redirects the mail to the named processor</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="ToProcessor">
- <processor>spam</processor>
- <notice>Notice attached to the message (optional)</notice>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_torepository"><a class="anchor" href="#_torepository"></a>ToRepository</h3>
-<div class="paragraph">
-<p>Stores incoming Mail in the specified Repository.</p>
-</div>
-<div class="paragraph">
-<p>If the "passThrough" in conf is true the mail will be returned untouched in
-the pipe and may be processed by additional mailets. If false will be destroyed.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_tosenderdomainrepository"><a class="anchor" href="#_tosenderdomainrepository"></a>ToSenderDomainRepository</h3>
-<div class="paragraph">
-<p>Stores incoming Mail in a repository defined by the sender’s domain.<br></p>
-</div>
-<div class="paragraph">
-<p>Supported configuration parameters:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>"urlPrefix" mandatory: defines the prefix for the per sender’s domain repository. For example for the value
-'cassandra://var/mail/sendersRepositories/', a mail sent by '<a href="mailto:user@james.org">user@james.org</a>' will be stored
-in 'cassandra://var/mail/sendersRepositories/james.org'.</p>
-</li>
-<li>
-<p>"passThrough" optional, defaults to false. If true, the processing of the mail continues. If false it stops.</p>
-</li>
-<li>
-<p>"allowRepositoryCreation" optional, defaults to true. If true, non existing repository will be created. In case of
-misconfiguration, this might lead to arbitrary repository creation. If false, the incoming mails will be stored only
- in already existing repository. If not existing, the email will be dropped with an appropriate log warning (leading
- to potential data loss). In case, you want to create a repository manually, make a http PUT request to
- /mailRepositories/encodedUrlOfTheRepository from web admin api.
- For example <a href="http://ip:port/mailRepositories/file%3A%2F%2FmailRepo" class="bare">http://ip:port/mailRepositories/file%3A%2F%2FmailRepo</a></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="ToSenderDomainRepository">
- <urlPrefix>cassandra://var/mail/sendersRepositories/</urlPrefix>
- <passThrough>false</passThrough>
- <allowRepositoryCreation>true</allowRepositoryCreation>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_vacationmailet"><a class="anchor" href="#_vacationmailet"></a>VacationMailet</h3>
-<div class="paragraph">
-<p>This mailet uses <a href="https://jmap.io/spec-mail.html#vacation-response">JMAP VacationResponse</a> and
-sends back a vacation notice to the sender if needed.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_withpriority"><a class="anchor" href="#_withpriority"></a>WithPriority</h3>
-<div class="paragraph">
-<p>This mailet sets the priority of the incoming mail.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="WithPriority">
- <priority>7</priority>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_withstoragedirective"><a class="anchor" href="#_withstoragedirective"></a>WithStorageDirective</h3>
-<div class="paragraph">
-<p>WithStorageDirective position storage directive for the recipients of this email.</p>
-</div>
-<div class="paragraph">
-<p>These directives are used by <strong>LocalDelivery</strong> mailet when adding the email to the recipients mailboxes.</p>
-</div>
-<div class="paragraph">
-<p>The following storage directives can be set:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>targetFolderNames: the folders to append the email in. Defaults to none (INBOX). Coma separated list of folder names. Fallback to targetFolderName.</p>
-</li>
-<li>
-<p>targetFolderName: the folder to append the email in. Defaults to none (INBOX).</p>
-</li>
-<li>
-<p>seen: boolean, whether the message should be automatically marked as seen. Defaults to false.</p>
-</li>
-<li>
-<p>important: boolean, whether the message should be automatically marked as important. Defaults to false.</p>
-</li>
-<li>
-<p>keywords: set of string, encoded as a string (value are coma separated). IMAP user flags to set for the message. Defaults to none</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="IsMarkedAsSpam" class="WithStorageDirective">
- <targetFolderName>Spam</targetFolderName>
- <seen>true</seen>
- <important>true</important>
- <keywords>keyword1,keyword2</keywords>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Alternatively, several target folders can be specified:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="IsMarkedAsSpam" class="WithStorageDirective">
- <targetFolderNames>Important, INBOX</targetFolderNames>
- <seen>true</seen>
- <important>true</important>
- <keywords>keyword1,keyword2</keywords>
-</mailet></pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_experimental_mailets"><a class="anchor" href="#_experimental_mailets"></a>Experimental mailets</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_addhabeaswarrantmark"><a class="anchor" href="#_addhabeaswarrantmark"></a>AddHabeasWarrantMark</h3>
-<div class="paragraph">
-<p>This matcher adds the Hebeas Warrant Mark to a message.</p>
-</div>
-<div class="paragraph">
-<p>For details see: <a href="http://www.hebeas.com</p>" class="bare">http://www.hebeas.com</p></a>;</p>
-</div>
-<div class="paragraph">
-<p>Usage:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="AddHabeasWarrantMark" />;</pre>
-</div>
-</div>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-note" title="Note"></i>
-</td>
-<td class="content">
-Although this mailet is covered by the Apache Software License,
-the Habeas Warrant Mark is copyright. A separate license from Habeas
-is required in order to legally attach the Habeas Warrant Mark to
-e-mail messages. Each James Administrator is responsible for
-ensuring that James is configured to attach the Habeas Warrant Mark
-only to e-mail covered by a suitable license received from Habeas.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>Because the Habeas Warrant Mark is copyright material, I have asked
-for and received the following explicit statement from Habeas:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>-----------------------------------
-From: Lindsey Pettit [mailto:support@habeas.com]
-Sent: Sunday, September 29, 2002 5:51
-To: Noel J. Bergman
-Subject: RE: Habeas and Apache James
-*
-Dear Noel,
-*
-> FURTHERMORE, if James is to be capable of sending Habeas SWE, I need
-> to write a Mailet that attaches the headers. As with any MTA, it
-> would be up to the administrator to properly configure James and make
-> sure that licenses are acquired. Since the Habeas Warrant Mark is
-> copyright, I believe that I require authorization from you for that
-> Mailet, especially since it attaches the Habeas Warrant Mark. For my
-> own protection, please show me why such authorization is unnecessary,
-> send me a digitally signed e-mail, or FAX a signed authorization
-*
-You do not yourself need the authorization to build the functionality
-into the [mailet]; what one needs authorization, in the form of a
-license, for, is to use the mark *in headers*, in outgoing email.
-However, please let me know if you would like something more
-formal, and I can try to have something faxed to you.
-*
-> The Mailet docs would reference the Habeas website, and inform
-> administrators that in order to USE the mailet, they need to ensure
-> that they have whatever licenses are required from you as appropriate
-> to your licensing terms.
-*
-That's absolutely perfect!
------------------------------------</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_clamavscan"><a class="anchor" href="#_clamavscan"></a>ClamAVScan</h3>
-<div class="paragraph">
-<p>Does an antivirus scan check using a ClamAV daemon (CLAMD)</p>
-</div>
-<div class="paragraph">
-<p>Interacts directly with the daemon using the "stream" method,
-which should have the lowest possible overhead.</p>
-</div>
-<div class="paragraph">
-<p>The CLAMD daemon will typically reside on <strong>localhost</strong>, but could reside on a
-different host.
-It may also consist on a set of multiple daemons, each residing on a different
-server and on different IP number.
-In such case a DNS host name with multiple IP addresses (round-robin load sharing)
-is supported by the mailet (but on the same port number).</p>
-</div>
-<div class="paragraph">
-<p>Handles the following init parameters:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong><debug></strong></p>
-</li>
-<li>
-<p><strong><host></strong>: the host name of the server where CLAMD runs. It can either be
-a machine name, such as
-"<strong>java.sun.com</strong>", or a textual representation of its
-IP address. If a literal IP address is supplied, only the
-validity of the address format is checked.
-If the machine name resolves to multiple IP addresses, <strong>round-robin load sharing</strong> will
-be used.
-The default is <strong>localhost</strong>.</p>
-</li>
-<li>
-<p><strong><port></strong>: the port on which CLAMD listens. The default is <strong>3310</strong>.</p>
-</li>
-<li>
-<p><strong><maxPings></strong>: the maximum number of connection retries during startup.
-If the value is <strong>0</strong> no startup test will be done.
-The default is <strong>6</strong>.</p>
-</li>
-<li>
-<p><strong><pingIntervalMilli></strong>: the interval (in milliseconds)
-between each connection retry during startup.
-The default is <strong>30000</strong> (30 seconds).</p>
-</li>
-<li>
-<p><strong><streamBufferSize></strong>: the BufferedOutputStream buffer size to use
-writing to the <strong>stream connection</strong>. The default is <strong>8192</strong>.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The actions performed are as follows:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>During initialization:</p>
-</li>
-<li>
-<p>Gets all <strong>config.xml</strong> parameters, handling the defaults;</p>
-</li>
-<li>
-<p>resolves the <strong><host></strong> parameter, creating the round-robin IP list;</p>
-</li>
-<li>
-<p>connects to CLAMD at the first IP in the round-robin list, on
-the specified <strong><port></strong>;</p>
-</li>
-<li>
-<p>if unsuccessful, retries every <strong><pingIntervalMilli></strong> milliseconds up to
-<strong><maxPings></strong> times;</p>
-</li>
-<li>
-<p>sends a <strong>PING</strong> request;</p>
-</li>
-<li>
-<p>waits for a <strong>PONG</strong> answer;</p>
-</li>
-<li>
-<p>repeats steps 3-6 for every other IP resolved.</p>
-</li>
-<li>
-<p>For every mail</p>
-</li>
-<li>
-<p>connects to CLAMD at the "next" IP in the round-robin list, on
-the specified <strong><port></strong>, and increments the "next" index;
-if the connection request is not accepted tries with the next one
-in the list unless all of them have failed;</p>
-</li>
-<li>
-<p>sends a "<strong>STREAM</strong>" request;</p>
-</li>
-<li>
-<p>parses the "<strong>PORT *streamPort</strong>*" answer obtaining the port number;</p>
-</li>
-<li>
-<p>makes a second connection (the <strong>stream connection</strong>) to CLAMD at the same host (or IP)
-on the <strong>streamPort</strong> just obtained;</p>
-</li>
-<li>
-<p>sends the mime message to CLAMD (using {@link MimeMessage#writeTo(java.io.OutputStream)})
-through the <strong>stream connection</strong>;</p>
-</li>
-<li>
-<p>closes the <strong>stream connection</strong>;</p>
-</li>
-<li>
-<p>gets the "<strong>OK</strong>" or "<strong>…​ FOUND</strong>" answer from the main connection;</p>
-</li>
-<li>
-<p>closes the main connection;</p>
-</li>
-<li>
-<p>sets the "<strong>org.apache.james.infected</strong>" <strong>mail attribute</strong> to either
-"<strong>true</strong>" or "<strong>false</strong>";</p>
-</li>
-<li>
-<p>adds the "<strong>X-MessageIsInfected</strong>" <strong>header</strong> to either
-"<strong>true</strong>" or "<strong>false</strong>";</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Some notes regarding <a href="http://www.clamav.net/">clamav.conf</a> :</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>LocalSocket</strong> must be commented out</p>
-</li>
-<li>
-<p><strong>TCPSocket</strong> must be set to a port# (typically 3310)</p>
-</li>
-<li>
-<p><strong>StreamMaxLength</strong> must be >= the James config.xml parameter
-<*maxmessagesize*> in SMTP <*handler*></p>
-</li>
-<li>
-<p><strong>MaxThreads</strong> should? be >= the James config.xml parameter
-<*threads*> in <*spoolmanager*></p>
-</li>
-<li>
-<p><strong>ScanMail</strong> must be uncommented</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Here follows an example of config.xml definitions deploying CLAMD on localhost,
-and handling the infected messages:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><!-- Do an antivirus scan -->
-<mailet match="All" class="ClamAVScan" onMailetException="ignore"/>
-
-<!-- If infected go to virus processor -->
-<mailet match="HasMailAttributeWithValue=org.apache.james.infected, true" class="ToProcessor">
- <processor> virus </processor>
-</mailet>
-
-<!-- Check attachment extensions for possible viruses -->
-<mailet match="AttachmentFileNameIs=-d -z *.exe *.com *.bat *.cmd *.pif *.scr *.vbs *.avi *.mp3 *.mpeg *.shs" class="ToProcessor">
- <processor> bad-extensions </processor>
-</mailet></pre>
-</div>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><!-- Messages containing viruses -->
-<processor name="virus">
- <!-- To avoid a loop while bouncing -->
- <mailet match="All" class="SetMailAttribute">
- <org.apache.james.infected>true, bouncing</org.apache.james.infected>
- </mailet>
-
- <mailet match="SMTPAuthSuccessful" class="Bounce">
- <sender>bounce-admin@xxx.com</sender>
- <inline>heads</inline>
- <attachment>none</attachment>
- <notice> Warning: We were unable to deliver the message below because it was found infected by virus(es). </notice>
- </mailet>
-
- <mailet match="All" class="ToRepository">
- <repositoryPath>file://var/mail/infected/</repositoryPath>
- </mailet>
-
- <mailet match="All" class="Null" />
-</processor></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_classifybounce"><a class="anchor" href="#_classifybounce"></a>ClassifyBounce</h3>
-<div class="paragraph">
-<p>Assesses the message to determine if it was a hard or soft bounce, and if it was a soft bounce, something of its nature..</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="ClassifyBounce">
- <headerName>X-MailetHeader</headerName>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_fromrepository"><a class="anchor" href="#_fromrepository"></a>FromRepository</h3>
-<div class="paragraph">
-<p>Re-spools Mail found in the specified Repository.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="RecipientIs=respool@localhost" class="FromRepository">
- <repositoryPath> *repository path* </repositoryPath>
- <processor> *target processor* </repositoryPath>
- <delete&t; [true|<b>false</b>] </delete>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_headerstohttp"><a class="anchor" href="#_headerstohttp"></a>HeadersToHTTP</h3>
-<div class="paragraph">
-<p>Serialise the email and pass it to an HTTP call</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="HeadersToHTTP">
- <url>http://192.168.0.252:3000/alarm</url>
- <parameterKey>Test</parameterKey>
- <parameterValue>ParameterValue</parameterValue>
- <passThrough>true</passThrough>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_onlytext"><a class="anchor" href="#_onlytext"></a>OnlyText</h3>
-<div class="paragraph">
-<p>Keep only the text part of a message.</p>
-</div>
-<div class="paragraph">
-<p>If the message is text only then it doesn’t touch it, if it is a multipart it
-transform it a in plain text message with the first text part found.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>text/plain</p>
-</li>
-<li>
-<p>text/html ⇒ with a conversion to text only</p>
-</li>
-<li>
-<p>text/* as is.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_manage_sieve_scripts_via_a_mailet"><a class="anchor" href="#_manage_sieve_scripts_via_a_mailet"></a>Manage Sieve scripts via a mailet</h3>
-<div class="paragraph">
-<p>Each user can manage his SIEVE scripts through the <code>ManageSieveMailet</code> mailet.</p>
-</div>
-<div class="paragraph">
-<p>To use the manage SIEVE mailet :</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>You need to create the user sievemanager@DOMAIN ( if you don’t, the SMTP server will check the domain, recognize it, and look for an absent local user, and will generate an error ).</p>
-</li>
-<li>
-<p>You can send Manage Sieve commands by mail to sievemanager@DOMAIN. Your subject must contain the command. Scripts need to be added as attachments and need the ".sieve" extension.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>To activate a script for a user, you need the following combination :</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>PUTSCRIPT scriptname</p>
-</li>
-<li>
-<p>SETACTIVE scriptname</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_recoverattachment"><a class="anchor" href="#_recoverattachment"></a>RecoverAttachment</h3>
-<div class="paragraph">
-<p>This mailet takes an attachment stored in an attribute and attach it back to
-the message</p>
-</div>
-<div class="paragraph">
-<p>This may be used to place back attachment stripped by StripAttachment and
-stored in the attribute
-<strong>org.apache.james.mailet.standard.mailets.StripAttachment.saved</strong></p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> <mailet match="All" class="RecoverAttachment" >
- <attribute>my.attribute.name</attribute>
- </mailet ></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_serialisetohttp"><a class="anchor" href="#_serialisetohttp"></a>SerialiseToHTTP</h3>
-<div class="paragraph">
-<p>Serialise the email and pass it to an HTTP call</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="SerialiseToHTTP">
- <name>URL</name> <value>url where serialised message will be posted</value>
- <name>ParameterKey</name> <value>An arbitrary parameter be added to the post</value>
- <name>ParameterValue</name> <value>A value for the arbitrary parameter</value>
- <name>MessageKeyName</name> <value>Field name for the serialised message</value>
- <name>passThrough</name> <value>true or false</value>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_servertime"><a class="anchor" href="#_servertime"></a>ServerTime</h3>
-<div class="paragraph">
-<p>Returns the current time for the mail server.</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="RecipientIs=time@cadenza.lokitech.com" class="ServerTime"/></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_spf"><a class="anchor" href="#_spf"></a>SPF</h3>
-<div class="paragraph">
-<p>Check the ip, sender, helo against SPF. Add the following attributes to the
-mail object:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> org.apache.james.transport.mailets.spf.explanation
- org.apache.james.transport.mailets.spf.result</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="SPF">
- <addHeader>true</addHeader>
- <debug>false</debug>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_toplaintext"><a class="anchor" href="#_toplaintext"></a>ToPlainText</h3>
-<div class="paragraph">
-<p>This mailet converts HTML parts of a message into Plain text.</p>
-</div>
-<div class="paragraph">
-<p>It starts looking for multipart/alternative containing a text/plain and a text/html part
-and only keep the text/plain part. Then in a second pass replaces remaining text/html by
-their textual content, infered by parsing the HTML content and handling common tags.</p>
-</div>
-<div class="paragraph">
-<p>Eg:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre><mailet matcher="All" class="ToPlainText"/></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_tosenderfolder"><a class="anchor" href="#_tosenderfolder"></a>ToSenderFolder</h3>
-<div class="literalblock">
-<div class="content">
-<pre>Receives a Mail from the Queue and takes care to deliver the message
- to a defined folder of the sender.</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You have to define the folder name of the sender.</p>
-</div>
-<div class="paragraph">
-<p>The flag 'consume' will tell is the mail will be further</p>
-</div>
-<div class="paragraph">
-<p>processed by the upcoming processor mailets, or not.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="RecipientIsLocal" class="ToSenderFolder">
- <folder> *Sent Items* </folder>
- <consume> *false* </consume>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_unwraptext"><a class="anchor" href="#_unwraptext"></a>UnwrapText</h3>
-<div class="paragraph">
-<p>Remove (best effort to) the hardcoded wrapping from a message.</p>
-</div>
-<div class="paragraph">
-<p>If the text is "format=flowed" then deflows the text. Otherwise it forces a dewrap of the text.</p>
-</div>
-<div class="paragraph">
-<p>Parameters:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>quotewidth - when we try to dewrap e quoted text it helps knowing the original
-with, so we can reconstruct "wrapped wraps" created by multiple wrappings by clients with
-different original width or simply to the add of the heading ">" that increase the line
-length.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The value should be "WIDTH+X" if the original length is known, "-X" otherwise.</p>
-</div>
-<div class="paragraph">
-<p>In the latter case the length of the longer line will be used.</p>
-</div>
-<div class="paragraph">
-<p>X is the tollerance needed for the quoting chars: if the original width is known the suggested
-value for X is 2 (because of "> " prefix), otherwise it is suggested to increase it to a value
-like 10 (-10)</p>
-</div>
-<div class="paragraph">
-<p>In summary, if the original wrap is known (for example 76, for flowed messages) <strong>quotewidth = 78</strong></p>
-</div>
-<div class="paragraph">
-<p>Otherwise <strong>quotewidth = -10</strong></p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_useheaderrecipients"><a class="anchor" href="#_useheaderrecipients"></a>UseHeaderRecipients</h3>
-<div class="paragraph">
-<p>Mailet designed to process the recipients from the mail headers rather
-than the recipients specified in the SMTP message header. This can be
-useful if your mail is redirected on-route by a mail server that
-substitutes a fixed recipient address for the original.</p>
-</div>
-<div class="paragraph">
-<p>To use this, match against the redirection address using the
-<strong>RecipientIs</strong> matcher and set the mailet 'class' to
-<strong>UseHeaderRecipients</strong>. This will cause the email to be
-re-injected into the root process with the recipient substituted
-by all the recipients in the Mail-For, To and Cc headers
-of the message.</p>
-</div>
-<div class="paragraph">
-<p>e.g.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="RecipientIs=forwarded@myhost" class="UseHeaderRecipients">
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_wraptext"><a class="anchor" href="#_wraptext"></a>WrapText</h3>
-<div class="paragraph">
-<p>Convert a message to format=flowed</p>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/configure/mailrepositorystore.html b/james-distributed-app/3.8.0/configure/mailrepositorystore.html
deleted file mode 100644
index d3e9f07..0000000
--- a/james-distributed-app/3.8.0/configure/mailrepositorystore.html
+++ /dev/null
@@ -1,449 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — mailrepositorystore.xml :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Core components</li>
- <li><a href="mailrepositorystore.html">mailrepositorystore.xml</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/mailrepositorystore.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — mailrepositorystore.xml</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>A <code>mail repository</code> allows storage of a mail as part of its
-processing. Standard configuration relies on the following mail
-repository.</p>
-</div>
-<div class="paragraph">
-<p>A mail repository is identified by its <strong>url</strong>, constituted of a <strong>protocol</strong> and a <strong>path</strong>.</p>
-</div>
-<div class="paragraph">
-<p>For instance in the url <code>cassandra://var/mail/error/</code> <code>cassandra</code> is the protocol and <code>var/mail/error</code> the path.</p>
-</div>
-<div class="paragraph">
-<p>The <strong>mailrepositorystore.xml</strong> file allows registration of available protocols, and their binding to actual MailRepository
-implementation. Note that extension developers can write their own MailRepository implementations, load them via the
-<code>extensions-jars</code> mechanism as documented in <a href="../extending/index.html" class="xref page">'writing your own extensions'</a>, and finally
-associated to a protocol in <strong>mailrepositorystore.xml</strong> for a usage in <strong>mailetcontainer.xml</strong>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_configuration"><a class="anchor" href="#_configuration"></a>Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/mailrepositorystore.xml">example</a>
-to get some examples and hints.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailrepositorystore>
- <defaultProtocol>cassandra</defaultProtocol>
- <mailrepositories>
- <mailrepository class="org.apache.james.mailrepository.cassandra.CassandraMailRepository">
- <protocols>
- <protocol>cassandra</protocol>
- </protocols>
- </mailrepository>
- </mailrepositories>
-</mailrepositorystore></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Only the <strong>CassandraMailRepository</strong> is available by default for the Distributed Server. Mails metadata are stored in
-Cassandra while the headers and bodies are stored within the <a href="../architecture/index.html#_blobstore" class="xref page">BlobStore</a>.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/configure/matchers.html b/james-distributed-app/3.8.0/configure/matchers.html
deleted file mode 100644
index 9b1dff7..0000000
--- a/james-distributed-app/3.8.0/configure/matchers.html
+++ /dev/null
@@ -1,1420 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Matchers :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Core components</li>
- <li><a href="matchers.html">Packaged Matchers</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/matchers.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Matchers</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This documentation page lists and documents Matchers that can be used within the
-Distributed Server MailetContainer in order to write your own mail processing logic with out-of-the-box components.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_supported_matchers"><a class="anchor" href="#_supported_matchers"></a>Supported matchers</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_all"><a class="anchor" href="#_all"></a>All</h3>
-<div class="paragraph">
-<p>Matches all mail.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_atleastpriority"><a class="anchor" href="#_atleastpriority"></a>AtLeastPriority</h3>
-<div class="paragraph">
-<p>Numeric value. The priority of this mail should be at least the specified value to be matched.</p>
-</div>
-<div class="paragraph">
-<p>Inclusive.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_atmost"><a class="anchor" href="#_atmost"></a>AtMost</h3>
-<div class="paragraph">
-<p>Checks that a mail did at most X executions on a specific operation.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> If no executions have been performed previously for Y attribute, it will be set up.
- In the mail, every time the check succeeds, its counter will be incremented by one.
-The check fails when the defined X limit is reached.</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>X - count of how many times a specific operation is performed</p>
-</li>
-<li>
-<p>Y - name of attribute represented for specific operation executions, default value is: <strong>AT_MOST_EXECUTIONS</strong></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The example below will match a mail with at most 3 executions on the mailet
-with attribute name <strong>AT_MOST_EXECUTIONS</strong></p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="AtMost=AT_MOST_EXECUTIONS:3" class="<any-class>">
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_atmostpriority"><a class="anchor" href="#_atmostpriority"></a>AtMostPriority</h3>
-<div class="paragraph">
-<p>Numeric value. The priority of this mail should be at most the specified value to be matched.</p>
-</div>
-<div class="paragraph">
-<p>Inclusive.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_dlp"><a class="anchor" href="#_dlp"></a>DLP</h3>
-<div class="paragraph">
-<p>Enable evaluation of incoming emails against DLP rules (Data Leak Prevention) attached to the sender domains.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre><mailet match="DLP" class="ToRepository">
- <repositoryPath>/var/mail/quarantine</repositoryPath>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Rules can be administered via <a href="../operate/webadmin.html#_administrating_dlp_configuration" class="xref page">webAdmin</a>.</p>
-</div>
-<div class="paragraph">
-<p>Only available on top of Memory and Cassandra storages.</p>
-</div>
-<div class="paragraph">
-<p>Additionally a cache can be added to reduce queries done to the underlying database.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre><mailet match="DLP=cache:60s" class="ToRepository">
- <repositoryPath>/var/mail/quarantine</repositoryPath>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will query the DLP rules for a given domain only every 60 seconds.</p>
-</div>
-<div class="paragraph">
-<p>Please note that querying DLP rules on top of Cassandra relies on Event sourcing, involves reading a potentially
-large event stream and involves some SERIAL reads (LightWeight transactions) for each processed emails.</p>
-</div>
-<div class="paragraph">
-<p>Efficiency of the cache can be tracked with the following metrics:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>dlp.cache.hitRate</code></p>
-</li>
-<li>
-<p><code>dlp.cache.missCount</code></p>
-</li>
-<li>
-<p><code>dlp.cache.hitCount</code></p>
-</li>
-<li>
-<p><code>dlp.cache.size</code></p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_fetchedfrom"><a class="anchor" href="#_fetchedfrom"></a>FetchedFrom</h3>
-<div class="paragraph">
-<p>Matches mail with a header set by Fetchpop X-fetched-from</p>
-</div>
-<div class="paragraph">
-<p>fetchpop sets X-fetched-by to the "name" of the fetchpop fetch task.</p>
-</div>
-<div class="paragraph">
-<p>This is used to match all mail fetched from a specific pop account.</p>
-</div>
-<div class="paragraph">
-<p>Once the condition is met the header is stripped from the message to prevent looping if
-the mail is re-inserted into the spool.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_hasattachment"><a class="anchor" href="#_hasattachment"></a>HasAttachment</h3>
-<div class="paragraph">
-<p>Checks whether this message has an attachment</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_hasexception"><a class="anchor" href="#_hasexception"></a>HasException</h3>
-<div class="paragraph">
-<p>This Matcher determines if the exception specified in the condition or
-the subclasses of it has occurred during the processing of the mail.
-If true, all recipients are returned, else null. This matcher presupposes
-that the exception has been captured as a Mail attribute
-org.apache.mailet.Mail#MAILET_ERROR_ATTRIBUTE_NAME in the process.</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="HasException=org.apache.james.managesieve.api.ManageSieveException" class="<any-class>"></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_hasheader"><a class="anchor" href="#_hasheader"></a>HasHeader</h3>
-<div class="paragraph">
-<p>use:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="HasHeader={<header>[=value]}+" class="..." /></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>This matcher checks if the header is present in the message (global) and per recipient (specific). It complements the AddHeader mailet.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_hasheaderwithprefix"><a class="anchor" href="#_hasheaderwithprefix"></a>HasHeaderWithPrefix</h3>
-<div class="paragraph">
-<p>Matches emails with headers having a given prefix.</p>
-</div>
-<div class="paragraph">
-<p>If a header with the given prefix is found in the message (global) all recipients will be matched.
-If a header with the given prefix is found per recipient (specific), only these will be matched.</p>
-</div>
-<div class="paragraph">
-<p>Otherwise, no recipient in returned.</p>
-</div>
-<div class="paragraph">
-<p>use:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="HasHeaderWithPrefix=PREFIX" class="..." /></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_hasmailattribute"><a class="anchor" href="#_hasmailattribute"></a>HasMailAttribute</h3>
-<div class="paragraph">
-<p>This Matcher determines if the mail contains the attribute specified in the
-condition, and returns all recipients if it is the case.</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="HasMailAttribute=whatever" class="<any-class>"></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_hasmailattributewithvalue"><a class="anchor" href="#_hasmailattributewithvalue"></a>HasMailAttributeWithValue</h3>
-<div class="paragraph">
-<p>This Matcher determines if the mail contains the attribute specified in
-the condition and if the value answered when the method toString() is
-invoked on the attribute is equal to the String value specified in the
-condition. If both tests are true, all recipients are returned, else null.</p>
-</div>
-<div class="paragraph">
-<p>Notes:</p>
-</div>
-<div class="paragraph">
-<p>The current matcher implementation expects a single String value to match
-on. This matcher requires two values, the attribute name and attribute
-value. This requires some implicit rules to govern how the single value
-supplied to the matcher is parsed into two values.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>In the match condition, the split between the attribute name and the
-attribute value is made at the first comma. Attribute names that include
-a comma will parse incorrectly and therefore are not supported by this
-matcher.</p>
-</li>
-<li>
-<p>Leading and trailing spaces are removed from both the attribute name and
-attribute value specified in the condition and the tested attribute value in
-the mail prior to matching. Therefore, "abc" , " abc", "abc " and " abc "
-are considered equivalent.</p>
-</li>
-<li>
-<p>To test for an empty string, do not specify an attribute value after the
-comma.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="HasMailAttributeWithValue=name, value" class="<any-class>"></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_hasmailattributewithvalueregex"><a class="anchor" href="#_hasmailattributewithvalueregex"></a>HasMailAttributeWithValueRegex</h3>
-<div class="paragraph">
-<p>This Matcher determines if the mail contains the attribute specified in the
-condition and that attribute matches the supplied regular expression,
-it returns all recipients if that is the case.</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="HasMailAttributeWithValueRegex=whatever,<regex>" class="<any-class>"></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note: as it is not possible to put arbitrary objects in the configuration,
-toString() is called on the attribute value, and that is the value matched against.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_hasmimetype"><a class="anchor" href="#_hasmimetype"></a>HasMimeType</h3>
-<div class="paragraph">
-<p>This matcher checks if the content type matches.</p>
-</div>
-<div class="paragraph">
-<p>This matcher does not walk down the mime tree and stops at the top level mime part.</p>
-</div>
-<div class="paragraph">
-<p>use:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="HasMimeType=text/plain,text/html" class="..." /></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_hasmimetypeparameter"><a class="anchor" href="#_hasmimetypeparameter"></a>HasMimeTypeParameter</h3>
-<div class="paragraph">
-<p>This matcher checks if the content type parameters matches.</p>
-</div>
-<div class="paragraph">
-<p>use:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="HasMimeTypeParameter=report-type=disposition-notification,report-type=other" class="..." /></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_haspriority"><a class="anchor" href="#_haspriority"></a>HasPriority</h3>
-<div class="paragraph">
-<p>Numeric value. The priority of this mail should be equal to the specified value to be matched.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_hostis"><a class="anchor" href="#_hostis"></a>HostIs</h3>
-<div class="paragraph">
-<p>Matches mail to given hosts.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_hostislocal"><a class="anchor" href="#_hostislocal"></a>HostIsLocal</h3>
-<div class="paragraph">
-<p>Matches mail to Domains which are local</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_ismarkedasspam"><a class="anchor" href="#_ismarkedasspam"></a>IsMarkedAsSpam</h3>
-<div class="paragraph">
-<p>Matches mails having a <strong>org.apache.james.spamassassin.status</strong> per recipient header with a <strong>Yes</strong> value.</p>
-</div>
-<div class="paragraph">
-<p>As an example, here is a part of a mailet pipeline which can be used in your LocalDelivery processor:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><!-- SpamAssassing mailets pipeline -->
- <mailet match="RecipientIsLocal" class="SpamAssassin">
- <spamdHost>spamassassin</spamdHost>
- <spamdPort>783</spamdPort>
- </mailet>
- <mailet match="IsMarkedAsSpam" class="WithStorageDirective">
- <targetFolderName>Spam</targetFolderName>
- </mailet>
-<!-- End of SpamAssassing mailets pipeline --></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>In order to use this with <code>rspamd</code>, we need to declare a condition for the matcher
-and drop the Rspamd jar (<strong>third-party/rspamd</strong>) in the James extensions-jars folder.
-Eg: With the recipient header for Rspamd being <strong>org.apache.james.rspamd.status</strong>,
-then the configuration would be:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><!-- Rspamd mailets pipeline -->
- <mailet match="IsMarkedAsSpam=org.apache.james.rspamd.status" class="WithStorageDirective">
- <targetFolderName>Spam</targetFolderName>
- </mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_isoverquota"><a class="anchor" href="#_isoverquota"></a>IsOverQuota</h3>
-<div class="paragraph">
-<p>This matcher will check if the incoming email will make recipients exceed their quotas.</p>
-</div>
-<div class="paragraph">
-<p>Here is a configuration example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="IsOverQuota" class="<any-class>"/></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_isremotedeliverypermanenterror"><a class="anchor" href="#_isremotedeliverypermanenterror"></a>IsRemoteDeliveryPermanentError</h3>
-<div class="paragraph">
-<p>Checks if the mail has a permanent remote delivery failure attribute</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="IsRemoteDeliveryPermanentError" class="<any-class>"/></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_isremotedeliverypermanenterror_2"><a class="anchor" href="#_isremotedeliverypermanenterror_2"></a>IsRemoteDeliveryPermanentError</h3>
-<div class="paragraph">
-<p>Checks if the mail has a temporary remote delivery failure attribute set to false (meaning it’s a temporary error)</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="IsRemoteDeliveryTemporaryError" class="<any-class>"/></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_issenderinrrtloop"><a class="anchor" href="#_issenderinrrtloop"></a>IsSenderInRRTLoop</h3>
-<div class="paragraph">
-<p>This matcher allow you to know if the sender of an email is part of a RRT loop.</p>
-</div>
-<div class="paragraph">
-<p>This is useful when bouncing upon RRT execution issues: we don’t want to create a bouncing loop
-(as the execution of that RRT loop will fail).</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="IsSenderInRRTLoop" class="<any-class>"/></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_issinglerecipient"><a class="anchor" href="#_issinglerecipient"></a>IsSingleRecipient</h3>
-<div class="paragraph">
-<p>Matches mail where the number of recipients is exactly one.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_issmimeencrypted"><a class="anchor" href="#_issmimeencrypted"></a>IsSMIMEEncrypted</h3>
-<div class="paragraph">
-<p>Checks if a mail is smime encrypted.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_issmimesigned"><a class="anchor" href="#_issmimesigned"></a>IsSMIMESigned</h3>
-<div class="paragraph">
-<p>Checks if a mail is smime encrypted.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_isx509certificatesubject"><a class="anchor" href="#_isx509certificatesubject"></a>IsX509CertificateSubject</h3>
-<div class="paragraph">
-<p>Checks if the subject of a X509Certificate contains the supplied string. The
-certificate is read from the specified mail attribute.</p>
-</div>
-<div class="paragraph">
-<p>If the specified attribute contains more than one certificate the matcher matches if at
-least one of the certificates contains the given string.</p>
-</div>
-<div class="paragraph">
-<p>Configuration string:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>mailAttribute;string</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_recipientdomainis"><a class="anchor" href="#_recipientdomainis"></a>RecipientDomainIs</h3>
-<div class="paragraph">
-<p>This will return recipients matching a configured domain.</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="RecipientDomainIs=<domain.com>" class="<any-class>"/></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_recipientis"><a class="anchor" href="#_recipientis"></a>RecipientIs</h3>
-<div class="paragraph">
-<p>This matcher matches a specific recipient (in the envelope of the mail), passed as a condition to
-this matcher.</p>
-</div>
-<div class="paragraph">
-<p>The example below will match only the recipient user@domain</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match=&quot;RecipientIs=user@domain&quot; class=&quot;<any-class>&quot;>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_recipientislocal"><a class="anchor" href="#_recipientislocal"></a>RecipientIsLocal</h3>
-<div class="paragraph">
-<p>Matches mail where the recipient is local.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_recipientisregex"><a class="anchor" href="#_recipientisregex"></a>RecipientIsRegex</h3>
-<div class="paragraph">
-<p>Matches recipients whose address matches a regular expression.</p>
-</div>
-<div class="paragraph">
-<p>Is equivalent to the SenderIsRegex matcher but matching on the recipient.</p>
-</div>
-<div class="paragraph">
-<p>Configuration string: a regular expression.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="RecipientIsRegex=<regular-expression>" class="<any-class>"></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The example below will match any recipient in the format user@log.anything</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="RecipientIsRegex=(.*)@log\.(.*)" class="<any-class>">
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_relaylimit"><a class="anchor" href="#_relaylimit"></a>RelayLimit</h3>
-<div class="paragraph">
-<p>Matches mail which has been relayed more than a given number of times.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_remoteaddrinnetwork"><a class="anchor" href="#_remoteaddrinnetwork"></a>RemoteAddrInNetwork</h3>
-<div class="paragraph">
-<p>Checks the IP address of the sending server against a comma-delimited list
-of IP addresses, domain names or sub-nets.</p>
-</div>
-<div class="paragraph">
-<p>See AbstractNetworkMatcher for details on how to specify entries.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_remoteaddrinnetwork_2"><a class="anchor" href="#_remoteaddrinnetwork_2"></a>RemoteAddrInNetwork</h3>
-<div class="paragraph">
-<p>Checks the IP address of the sending server against a comma-delimited list
-of IP addresses, domain names or sub-nets.</p>
-</div>
-<div class="paragraph">
-<p>See AbstractNetworkMatcher for details on how to specify entries.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_remotedeliveryfailedwithsmtpcode"><a class="anchor" href="#_remotedeliveryfailedwithsmtpcode"></a>RemoteDeliveryFailedWithSMTPCode</h3>
-<div class="paragraph">
-<p>Checks the SMTP error code attached to remote delivery failures</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_senderdomainis"><a class="anchor" href="#_senderdomainis"></a>SenderDomainIs</h3>
-<div class="paragraph">
-<p>SenderDomainIs will look at the envelope sender’s domain. If equal to
-configured value, then all recipients will be returned. Otherwise an empty
-list will be returned.</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="SenderDomainIs=<domain.com>" class="<any-class>"></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_senderhostis"><a class="anchor" href="#_senderhostis"></a>SenderHostIs</h3>
-<div class="paragraph">
-<p>Checks the sender’s displayed domain name against a supplied list.</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="SenderHostIs=domain.com" class="ToProcessor">
- <processor> spam </processor>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_senderis"><a class="anchor" href="#_senderis"></a>SenderIs</h3>
-<div class="paragraph">
-<p>This matcher matches a specific sender, passed as a condition to this matcher.</p>
-</div>
-<div class="paragraph">
-<p>The example below will match mail with a sender being user@domain</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="SenderIs=user@domain" class="<any-class>">
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_senderislocal"><a class="anchor" href="#_senderislocal"></a>SenderIsLocal</h3>
-<div class="paragraph">
-<p>Matches mail where the sender is local.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_senderisnull"><a class="anchor" href="#_senderisnull"></a>SenderIsNull</h3>
-<div class="paragraph">
-<p>Matches mails that are sent by a null sender.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="SenderIsNull" class="<any-class>"></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_senderisregex"><a class="anchor" href="#_senderisregex"></a>SenderIsRegex</h3>
-<div class="paragraph">
-<p>Matches mails that are sent by a sender whose address matches a regular expression.</p>
-</div>
-<div class="paragraph">
-<p>Is equivalent to the RecipientIsRegex matcher but matching on the sender.</p>
-</div>
-<div class="paragraph">
-<p>Configuration string: a regular expression.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="SenderIsRegex=<regular-expression>" class="<any-class>"></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The example below will match any sender in the format user@log.anything</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="SenderIsRegex=(.*)@log\.(.*)" class="<any-class>">
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Another example below will match any sender having some variations of the string
-<strong>mp3</strong> inside the username part.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="SenderIsRegex=(.*)(mp3|emmepitre)(.*)@" class="<any-class>">
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_sentbyjmap"><a class="anchor" href="#_sentbyjmap"></a>SentByJmap</h3>
-<div class="paragraph">
-<p>Matches mails sent via the JMAP protocol.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_sentbymailet"><a class="anchor" href="#_sentbymailet"></a>SentByMailet</h3>
-<div class="paragraph">
-<p>This matcher matches email sent automatically by mailets.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="SentByMailetAny" class="<any-class>"/></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>This matcher allows you, for instance, to enable/disable routing automatically generated emails out of your server.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_sizegreaterthan"><a class="anchor" href="#_sizegreaterthan"></a>SizeGreaterThan</h3>
-<div class="paragraph">
-<p>Checks whether the message (entire message, not just content) is greater
-than a certain number of bytes. You can use 'k' and 'm' as optional postfixes.</p>
-</div>
-<div class="paragraph">
-<p>In other words, "1m" is the same as writing "1024k", which is the same as
-"1048576".</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_smtpauthsuccessful"><a class="anchor" href="#_smtpauthsuccessful"></a>SMTPAuthSuccessful</h3>
-<div class="paragraph">
-<p>Matches mails that are sent by an SMTP authenticated user.</p>
-</div>
-<div class="paragraph">
-<p>If the sender was not authenticated it will not match.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="SMTPAuthSuccessful" class="<any-class>"></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_smtpauthuseris"><a class="anchor" href="#_smtpauthuseris"></a>SMTPAuthUserIs</h3>
-<div class="paragraph">
-<p>Matches mails that are sent by an SMTP authenticated user present in a supplied list.</p>
-</div>
-<div class="paragraph">
-<p>If the sender was not authenticated it will not match.</p>
-</div>
-<div class="paragraph">
-<p>Configuration string: a comma, tab or space separated list of James users.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="SMTPAuthUserIs=<list-of-user-names>" class="<any-class>"></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_smtpisauthnetwork"><a class="anchor" href="#_smtpisauthnetwork"></a>SMTPIsAuthNetwork</h3>
-<div class="paragraph">
-<p>Matches mails that are sent by a client which is allowed to relay.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="SMTPIsAuthNetwork" class="<any-class>"></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_subjectis"><a class="anchor" href="#_subjectis"></a>SubjectIs</h3>
-<div class="paragraph">
-<p>Matches mail where the subject is contained in a configurable list.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_subjectis_2"><a class="anchor" href="#_subjectis_2"></a>SubjectIs</h3>
-<div class="paragraph">
-<p>Matches mail where the subject starts with a given phrase.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_toomanyrecipients"><a class="anchor" href="#_toomanyrecipients"></a>TooManyRecipients</h3>
-<div class="paragraph">
-<p>This matcher matches emails that have too many recipients.</p>
-</div>
-<div class="paragraph">
-<p>The example below will reject any email with more than 5 recipients</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="TooManyRecipients=5" class="<any-class&gt;"></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_useris"><a class="anchor" href="#_useris"></a>UserIs</h3>
-<div class="paragraph">
-<p>Matches mail where the user is contained in a configurable list.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_xoriginatingipinnetwork"><a class="anchor" href="#_xoriginatingipinnetwork"></a>XOriginatingIpInNetwork</h3>
-<div class="paragraph">
-<p>Checks the first X_ORIGINATING_IP IP address against a comma-delimited list
-of IP addresses, domain names or sub-nets.</p>
-</div>
-<div class="paragraph">
-<p>See AbstractNetworkMatcher for details on how to specify entries.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_experimental_matchers"><a class="anchor" href="#_experimental_matchers"></a>Experimental matchers</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_attachmentfilenameis"><a class="anchor" href="#_attachmentfilenameis"></a>AttachmentFileNameIs</h3>
-<div class="paragraph">
-<p>Checks if at least one attachment has a file name which matches any
-element of a comma-separated or space-separated list of file name masks.</p>
-</div>
-<div class="paragraph">
-<p>Syntax: <strong>match="AttachmentFileNameIs=[-d] [-z] masks"</strong></p>
-</div>
-<div class="paragraph">
-<p>The match is case insensitive.</p>
-</div>
-<div class="paragraph">
-<p>File name masks may start with a wildcard '\*'.</p>
-</div>
-<div class="paragraph">
-<p>Multiple file name masks can be specified, e.g.: '*.scr,\*.bat'.</p>
-</div>
-<div class="paragraph">
-<p>If '<strong>-d</strong>' is coded, some debug info will be logged.</p>
-</div>
-<div class="paragraph">
-<p>If '<strong>-z</strong>' is coded, the check will be non-recursively applied
-to the contents of any attached '*.zip' file.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_commandforlistserv"><a class="anchor" href="#_commandforlistserv"></a>CommandForListserv</h3>
-<div class="paragraph">
-<p>Returns positive if the recipient is a command for a listserv. For example,
-if my listserv is <a href="mailto:james@list.working-dogs.com">james@list.working-dogs.com</a>, this matcher will return true
-for <a href="mailto:james-on@list.working-dogs.com">james-on@list.working-dogs.com</a> and <a href="mailto:james-off@list.working-dogs.com">james-off@list.working-dogs.com</a>.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_commandlistservmatcher"><a class="anchor" href="#_commandlistservmatcher"></a>CommandListservMatcher</h3>
-<div class="paragraph">
-<p>CommandListservMatcher is the matcher that pairs with the CommandListservManager
-It checks to see if the request is intended for the ListservManager, but doesn’t guarantee that it is a valid command.</p>
-</div>
-<div class="paragraph">
-<p>To configure, insert this into the config.xml inside of the root processor block.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="CommandListservMatcher=announce@localhost" class="CommandListservManager">
-...
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_comparenumericheadervalue"><a class="anchor" href="#_comparenumericheadervalue"></a>CompareNumericHeaderValue</h3>
-<div class="paragraph">
-<p>Matches mails containing a header with a numeric value whose comparison with the specified value is true.</p>
-</div>
-<div class="paragraph">
-<p>If the header is missing in the message, there will be <strong>no match</strong></p>
-</div>
-<div class="paragraph">
-<p>Configuration string: The headerName, a comparison operator and the numeric headerValue
-to compare with, <strong>space or tab delimited</strong>.</p>
-</div>
-<div class="paragraph">
-<p>The comparison operators are: <strong><, ⇐, ==, >=, ></strong>;
-another set of operators is: <strong>LT, LE, EQ, GE, GT</strong>.</p>
-</div>
-<div class="paragraph">
-<p>Also the following operators are accepted: <strong>=<, =, ⇒</strong>.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="CompareNumericHeaderValue=X-MessageIsSpamProbability > 0.9" class="ToProcessor">
- <processor> spam </processor>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_fileregexmatcher"><a class="anchor" href="#_fileregexmatcher"></a>FileRegexMatcher</h3>
-<div class="paragraph">
-<p>Initializes RegexMatcher with regular expressions from a file.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_hashabeaswarrantmark"><a class="anchor" href="#_hashabeaswarrantmark"></a>HasHabeasWarrantMark</h3>
-<div class="paragraph">
-<p>This matcher tests for the Hebeas Warrant Mark.
-For details see: <a href="http://www.hebeas.com" class="bare">http://www.hebeas.com</a></p>
-</div>
-<div class="paragraph">
-<p>Usage: Place this matcher</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="HasHabeasWarrantMark" class="ToProcessor">
- <processor> transport </processor>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>in the root processes before the DNSRBL block lists (the InSpammerBlacklist matcher).</p>
-</div>
-<div class="paragraph">
-<p>Because the Habeas Warrant Mark is copyright material, I have asked for and
-received the following explicit statement from Habeas:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>-----------------------------------
-From: Lindsey Pettit [mailto:support@habeas.com]
-Sent: Sunday, September 29, 2002 5:51
-To: Noel J. Bergman
-Subject: RE: Habeas and Apache James
-
-Dear Noel,
-
-> I guess that since your Warrant Mark is copyright, I should ask for
-> something from you to explicitly authorize that Hebeas will permit
-> this code to be included and distributed as part of Apache James
-> under the Apache Software License. As we have established, the use
-> of the Habeas Warrant Mark for filtering is not restricted, but I
-> would like something to confirm that, so that Apache will be happy.
-
-I can hereby confirm to you that there is no license necessary in
-order to use the Habeas mark for filtering. That said, however, we
-do insist that it not ever be used as a basis for rejecting email which
-bears the Habeas mark.
------------------------------------</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_inspammerblacklist"><a class="anchor" href="#_inspammerblacklist"></a>InSpammerBlacklist</h3>
-<div class="paragraph">
-<p>Checks the network IP address of the sending server against a blacklist of
-spammers. There are 3 lists that support this…​</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>blackholes.mail-abuse.org</strong>: Rejected - see <a href="http://www.mail-abuse.org/rbl/" class="bare">http://www.mail-abuse.org/rbl/</a></p>
-</li>
-<li>
-<p><strong>dialups.mail-abuse.org</strong>: Dialup - see <a href="http://www.mail-abuse.org/dul/" class="bare">http://www.mail-abuse.org/dul/</a></p>
-</li>
-<li>
-<p><strong>relays.mail-abuse.org</strong>: Open spam relay - see <a href="http://www.mail-abuse.org/rss/" class="bare">http://www.mail-abuse.org/rss/</a></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="InSpammerBlacklist=blackholes.mail-abuse.org." class="ToProcessor">
- <processor>spam</processor>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_nesspamcheck"><a class="anchor" href="#_nesspamcheck"></a>NESSpamCheck</h3>
-<div class="paragraph">
-<p>This is based on a sample filter.cfg for a Netscape Mail Server to stop
-spam.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_senderinfakedomain"><a class="anchor" href="#_senderinfakedomain"></a>SenderInFakeDomain</h3>
-<div class="paragraph">
-<p>Does a DNS lookup (MX and A/CNAME records) on the sender’s domain. If there
-are no entries, the domain is considered fake and the match is successful.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_composite_matchers"><a class="anchor" href="#_composite_matchers"></a>Composite matchers</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>It is possible to combine together matchers in order to create a composite matcher, thus simplifying your
-Mailet Container logic.</p>
-</div>
-<div class="paragraph">
-<p>Here are the available logical operations:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>And</strong> : This matcher performs And conjunction between the two matchers: recipients needs to match both matcher in order to
-match the composite matcher.</p>
-</li>
-<li>
-<p><strong>Or</strong> : This matcher performs Or conjunction between the two matchers: consider it to be a union of the results.
-It returns recipients from the Or composition results of the child matchers.</p>
-</li>
-<li>
-<p><strong>Not</strong> : It returns recipients from the negated composition of the child Matcher(s). Consider what wasn’t
-in the result set of each child matcher. Of course it is easier to understand if it only
-includes one matcher in the composition, the normal recommended use.</p>
-</li>
-<li>
-<p><strong>Xor</strong> : It returns Recipients from the Xor composition of the child matchers. Consider it to be the inequality
-operator for recipients. If any recipients match other matcher results
-then the result does not include that recipient.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Here is the syntax to adopt in <strong>mailetcontainer.xml</strong>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><processor state="transport" enableJmx="true">
- <matcher name="relay-allowed" match="org.apache.james.mailetcontainer.impl.matchers.Or">
- <matcher match="SMTPAuthSuccessful"/>
- <matcher match="SentByMailet"/>
- <matcher match="org.apache.james.jmap.mailet.SentByJmap"/>
- <matcher match="RemoteAddrInNetwork=127.0.0.1, 10.2.*, 193.50.151.*"/>
- </matcher>
-
- <!-- ... -->
-
- <mailet match="relay-allowed" class="ToProcessor">
- <processor>relay</processor>
- </mailet>
-</processor></pre>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/configure/opensearch.html b/james-distributed-app/3.8.0/configure/opensearch.html
deleted file mode 100644
index 76b0be9..0000000
--- a/james-distributed-app/3.8.0/configure/opensearch.html
+++ /dev/null
@@ -1,874 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — opensearch.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Storage dependencies</li>
- <li><a href="opensearch.html">opensearch.properties</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/opensearch.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — opensearch.properties</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/opensearch.properties">example</a>
-to get some examples and hints.</p>
-</div>
-<div class="paragraph">
-<p>If you want more explanation about OpenSearch configuration, you should visit the dedicated <a href="https://opensearch.org/">documentation</a>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_opensearch_configuration"><a class="anchor" href="#_opensearch_configuration"></a>OpenSearch Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This file section is used to configure the connection tp an OpenSearch cluster.</p>
-</div>
-<div class="paragraph">
-<p>Here are the properties allowing to do so :</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. opensearch.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.clusterName</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Is the name of the cluster used by James.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.nb.shards</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Number of shards for index provisionned by James</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.nb.replica</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Number of replica for index provisionned by James (default: 0)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.index.waitForActiveShards</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Wait for a certain number of active shard copies before proceeding with the operation. Defaults to 1.
-You may consult the <a href="https://www.elastic.co/guide/en/elasticsearch/reference/7.10/docs-index_.html#active-shards">documentation</a> for more information.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.retryConnection.maxRetries</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Number of retries when connecting the cluster</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.retryConnection.minDelay</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Minimum delay between connection attempts</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.max.connections</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Maximum count of HTTP connections allowed for the OpenSearch driver. Optional integer, if unspecified driver defaults
-applies (30 connections).</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.max.connections.per.hosts</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Maximum count of HTTP connections per host allowed for the OpenSearch driver. Optional integer, if unspecified driver defaults
-applies (10 connections).</p></td>
-</tr>
-</tbody>
-</table>
-<div class="sect2">
-<h3 id="_mailbox_search"><a class="anchor" href="#_mailbox_search"></a>Mailbox search</h3>
-<div class="paragraph">
-<p>The main use of OpenSearch within the Distributed Server is indexing the mailbox content of users in order to enable
-powerful and efficient full-text search of the mailbox content.</p>
-</div>
-<div class="paragraph">
-<p>Data indexing is performed asynchronously in a reliable fashion via a MailboxListener.</p>
-</div>
-<div class="paragraph">
-<p>Here are the properties related to the use of OpenSearch for Mailbox Search:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 2. opensearch.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.index.mailbox.name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Name of the mailbox index backed by the alias. It will be created if missing.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.index.name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Deprecated</strong> Use <strong>opensearch.index.mailbox.name</strong> instead.
-Name of the mailbox index backed by the alias. It will be created if missing.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.alias.read.mailbox.name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Name of the alias to use by Apache James for mailbox reads. It will be created if missing.
-The target of the alias is the index name configured above.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.alias.read.name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Deprecated</strong> Use <strong>opensearch.alias.read.mailbox.name</strong> instead.
-Name of the alias to use by Apache James for mailbox reads. It will be created if missing.
-The target of the alias is the index name configured above.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.alias.write.mailbox.name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Name of the alias to use by Apache James for mailbox writes. It will be created if missing.
-The target of the alias is the index name configured above.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.alias.write.name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Deprecated</strong> Use <strong>opensearch.alias.write.mailbox.name</strong> instead.
-Name of the alias to use by Apache James for mailbox writes. It will be created if missing.
-The target of the alias is the index name configured above.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.indexAttachments</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Indicates if you wish to index attachments or not (default: true).</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.indexHeaders</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Indicates if you wish to index headers or not (default: true). Note that specific headers
-(From, To, Cc, Bcc, Subject, Message-Id, Date, Content-Type) are still indexed in their dedicated type.
-Header indexing is expensive as each header currently need to be stored as a nested document but
-turning off headers indexing result in non-strict compliance with the IMAP / JMAP standards.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.message.index.optimize.move</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">When set to true, James will attempt to reindex from the indexed message when moved.
-If the message is not found, it will fall back to the old behavior (The message will be indexed from the blobStore source)
-Default to false.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="sect2">
-<h3 id="_quota_search"><a class="anchor" href="#_quota_search"></a>Quota search</h3>
-<div class="paragraph">
-<p>Users are indexed by quota usage, allowing operators a quick audit of users quota occupation.</p>
-</div>
-<div class="paragraph">
-<p>Users quota are asynchronously indexed upon quota changes via a dedicated MailboxListener.</p>
-</div>
-<div class="paragraph">
-<p>The following properties affect quota search :</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 3. opensearch.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.index.quota.ratio.name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Specify the OpenSearch alias name used for quotas</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.alias.read.quota.ratio.name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Specify the OpenSearch alias name used for reading quotas</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.alias.write.quota.ratio.name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Specify the OpenSearch alias name used for writing quotas</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="sect2">
-<h3 id="_disabling_opensearch"><a class="anchor" href="#_disabling_opensearch"></a>Disabling OpenSearch</h3>
-<div class="paragraph">
-<p>OpenSearch component can be disabled but consider it would make search feature to not work. In particular it will break JMAP protocol and SEARCH IMAP comment in an nondeterministic way.
-This is controlled in the <code>search.properties</code> file via the <code>implementation</code> property (defaults
-to <code>OpenSearch</code>). Setting this configuration parameter to <code>scanning</code> will effectively disable OpenSearch, no
-further indexation will be done however searches will rely on the scrolling search, leading to expensive and longer
-searches. Disabling OpenSearch requires no extra action, however
-<a href="../operate/webadmin.html#_reindexing_all_mails" class="xref page">a full re-indexing</a>needs to be carried out when enabling OpenSearch.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_ssl_trusting_configuration"><a class="anchor" href="#_ssl_trusting_configuration"></a>SSL Trusting Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>By default, James will use the system TrustStore to validate https server certificates, if the certificate on
-ES side is already in the system TrustStore, you can leave the sslValidationStrategy property empty or set it to default.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 4. opensearch.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.hostScheme.https.sslValidationStrategy</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Accept only <strong>default</strong>, <strong>ignore</strong>, <strong>override</strong>. Default is <strong>default</strong>. default: Use the default SSL TrustStore of the system.
-ignore: Ignore SSL Validation check (not recommended).
-override: Override the SSL Context to use a custom TrustStore containing ES server’s certificate.</p></td>
-</tr>
-</tbody>
-</table>
-<div class="paragraph">
-<p>In some cases, you want to secure the connection from clients to ES by setting up a <strong>https</strong> protocol
-with a self signed certificate. And you prefer to left the system ca-certificates un touch.
-There are possible solutions to let the ES RestHighLevelClient to trust your self signed certificate.</p>
-</div>
-<div class="paragraph">
-<p>Second solution: importing a TrustStore containing the certificate into SSL context.
-A certificate normally contains two parts: a public part in .crt file, another private part in .key file.
-To trust the server, the client needs to be acknowledged that the server’s certificate is in the list of
-client’s TrustStore. Basically, you can create a local TrustStore file containing the public part of a remote server
-by execute this command:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>keytool -import -v -trustcacerts -file certificatePublicFile.crt -keystore trustStoreFileName.jks -keypass fillThePassword -storepass fillThePassword</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>When there is a TrustStore file and the password to read, fill two options <strong>trustStorePath</strong>
-and <strong>trustStorePassword</strong> with the TrustStore location and the password. ES client will accept
-the certificate of ES service.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 5. opensearch.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.hostScheme.https.trustStorePath</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Use it when https is configured in opensearch.hostScheme, and sslValidationStrategy is <strong>override</strong>
-Configure OpenSearch rest client to use this trustStore file to recognize nginx’s ssl certificate.
-Once you chose <strong>override</strong>, you need to specify both trustStorePath and trustStorePassword.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.hostScheme.https.trustStorePassword</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Use it when https is configured in opensearch.hostScheme, and sslValidationStrategy is <strong>override</strong>
-Configure OpenSearch rest client to use this trustStore file with the specified password.
-Once you chose <strong>override</strong>, you need to specify both trustStorePath and trustStorePassword.</p></td>
-</tr>
-</tbody>
-</table>
-<div class="paragraph">
-<p>During SSL handshaking, the client can determine whether accept or reject connecting to a remote server by its hostname.
-You can configure to use which HostNameVerifier in the client.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 6. opensearch.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.hostScheme.https.hostNameVerifier</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Default is <strong>default</strong>. default: using the default hostname verifier provided by apache http client.
-accept_any_hostname: accept any host (not recommended).</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_search_overrides"><a class="anchor" href="#_search_overrides"></a>Search overrides</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p><strong>Search overrides</strong> allow resolution of predefined search queries against alternative sources of data
-and allow bypassing OpenSearch. This is useful to handle most resynchronisation queries that
-are simple enough to be resolved against Cassandra.</p>
-</div>
-<div class="paragraph">
-<p>Possible values are:
- - <code>org.apache.james.mailbox.cassandra.search.AllSearchOverride</code> Some IMAP clients uses SEARCH ALL to fully list messages in
- a mailbox and detect deletions. This is typically done by clients not supporting QRESYNC and from an IMAP perspective
- is considered an optimisation as less data is transmitted compared to a FETCH command. Resolving such requests against
- Cassandra is enabled by this search override and likely desirable.
- - <code>org.apache.james.mailbox.cassandra.search.UidSearchOverride</code>. Same as above but restricted by ranges.
- - <code>org.apache.james.mailbox.cassandra.search.DeletedSearchOverride</code>. Find deleted messages by looking up in the relevant Cassandra
- table.
- - <code>org.apache.james.mailbox.cassandra.search.DeletedWithRangeSearchOverride</code>. Same as above but limited by ranges.
- - <code>org.apache.james.mailbox.cassandra.search.NotDeletedWithRangeSearchOverride</code>. List non deleted messages in a given range.
- Lists all messages and filters out deleted message thus this is based on the following heuristic: most messages are not marked as deleted.
- - <code>org.apache.james.mailbox.cassandra.search.UnseenSearchOverride</code>. List unseen messages in the corresponding cassandra projection.</p>
-</div>
-<div class="paragraph">
-<p>Please note that custom overrides can be defined here. <code>opensearch.search.overrides</code> allow specifying search overrides and is a
-coma separated list of search override FQDNs. Default to none.</p>
-</div>
-<div class="paragraph">
-<p>EG:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>opensearch.search.overrides=org.apache.james.mailbox.cassandra.search.AllSearchOverride,org.apache.james.mailbox.cassandra.search.DeletedSearchOverride, org.apache.james.mailbox.cassandra.search.DeletedWithRangeSearchOverride,org.apache.james.mailbox.cassandra.search.NotDeletedWithRangeSearchOverride,org.apache.james.mailbox.cassandra.search.UidSearchOverride,org.apache.james.mailbox.cassandra.search.UnseenSearchOverride</pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_configure_dedicated_language_analyzers_for_mailbox_index"><a class="anchor" href="#_configure_dedicated_language_analyzers_for_mailbox_index"></a>Configure dedicated language analyzers for mailbox index</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>OpenSearch supports various language analyzers out of the box: <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/analysis-lang-analyzer.html" class="bare">https://www.elastic.co/guide/en/elasticsearch/reference/current/analysis-lang-analyzer.html</a>.</p>
-</div>
-<div class="paragraph">
-<p>James could utilize this to improve the user searching experience upon his language.</p>
-</div>
-<div class="paragraph">
-<p>While one could modify mailbox index mapping programmatically to customize this behavior, here we should just document a manual way to archive this without breaking our common index' mapping code.</p>
-</div>
-<div class="paragraph">
-<p>The idea is modifying mailbox index mappings with the target language analyzer as a JSON file, then submit it directly
-to OpenSearch via cURL command to create the mailbox index before James start. Let’s adapt dedicated language analyzers
-where appropriate for the following fields:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 7. Language analyzers propose change</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Field</th>
-<th class="tableblock halign-left valign-top">Analyzer change</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">from.name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>keep_mail_and_url</code> analyzer → <code>keep_mail_and_url_language_a</code> analyzer</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">subject</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>keep_mail_and_url</code> analyzer → <code>keep_mail_and_url_language_a</code> analyzer</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">to.name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>keep_mail_and_url</code> analyzer → <code>keep_mail_and_url_language_a</code> analyzer</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cc.name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>keep_mail_and_url</code> analyzer → <code>keep_mail_and_url_language_a</code> analyzer</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">bcc.name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>keep_mail_and_url</code> analyzer → <code>keep_mail_and_url_language_a</code> analyzer</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">textBody</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>standard</code> analyzer → <code>language_a</code> analyzer</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">htmlBody</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>standard</code> analyzer → <code>language_a</code> analyzer</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">attachments.fileName</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>standard</code> analyzer → <code>language_a</code> analyzer</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">attachments.textContent</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>standard</code> analyzer → <code>language_a</code> analyzer</p></td>
-</tr>
-</tbody>
-</table>
-<div class="paragraph">
-<p>In there:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>keep_mail_and_url</code> and <code>standard</code> are our current analyzers for mailbox index.</p>
-</li>
-<li>
-<p><code>language_a</code> analyzer: the built-in analyzer of OpenSearch. EG: <code>french</code></p>
-</li>
-<li>
-<p><code>keep_mail_and_url_language_a</code> analyzer: a custom of <code>keep_mail_and_url</code> analyzer with some language filters.Every language has
-their own filters so please have a look at filters which your language need to add. EG which need to be added for French:</p>
-</li>
-</ul>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>"filter": {
- "french_elision": {
- "type": "elision",
- "articles_case": true,
- "articles": [
- "l", "m", "t", "qu", "n", "s",
- "j", "d", "c", "jusqu", "quoiqu",
- "lorsqu", "puisqu"
- ]
- },
- "french_stop": {
- "type": "stop",
- "stopwords": "_french_"
- },
- "french_stemmer": {
- "type": "stemmer",
- "language": "light_french"
- }
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>After modifying above proposed change, you should have a JSON file that contains new setting and mapping of mailbox index. Here
-we provide <a href="https://github.com/apache/james-project/blob/master/mailbox/opensearch/example_french_index.json">a sample JSON for French language</a>.
-If you want to customize that JSON file for your own language need, please make these modifications:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Replace the <code>french</code> analyzer with your built-in language (have a look at <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/analysis-lang-analyzer.html">built-in language analyzers</a>)</p>
-</li>
-<li>
-<p>Modify <code>keep_mail_and_url_french</code> analyzer' filters with your language filters, and customize the analyzer' name.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Please change also <code>number_of_shards</code>, <code>number_of_replicas</code> and <code>index.write.wait_for_active_shards</code> values in the sample file according to your need.</p>
-</div>
-<div class="paragraph">
-<p>Run this cURL command with above JSON file to create <code>mailbox_v1</code> (Mailbox index' default name) index before James start:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>curl -X PUT ES_IP:ES_PORT/mailbox_v1 -H "Content-Type: application/json" -d @example_french_index.json</pre>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/configure/pop3.html b/james-distributed-app/3.8.0/configure/pop3.html
deleted file mode 100644
index 17407f4..0000000
--- a/james-distributed-app/3.8.0/configure/pop3.html
+++ /dev/null
@@ -1,495 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — pop3server.xml :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Protocols</li>
- <li><a href="pop3.html">pop3server.xml</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/pop3.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — pop3server.xml</h1>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/pop3server.xml">example</a>
-to get some examples and hints.</p>
-</div>
-<div class="paragraph">
-<p>The POP3 service is controlled by a configuration block in the pop3server.xml.
-The pop3server tag defines the boundaries of the configuration block. It encloses
-all the relevant configuration for the POP3 server. The behavior of the POP service is
-controlled by the attributes and children of this tag.</p>
-</div>
-<div class="paragraph">
-<p>This tag has an optional boolean attribute - <strong>enabled</strong> - that defines whether the service is active or not.
-The value defaults to "true" if not present.</p>
-</div>
-<div class="paragraph">
-<p>The standard children of the pop3server tag are:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. jmx.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">bind</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure this to bind to a specific inetaddress. This is an optional integer value.
-This value is the port on which this POP3 server is configured
-to listen. If the tag or value is absent then the service
-will bind to all network interfaces for the machine If the tag or value is omitted,
-the value will default to the standard POP3 port, 11
-port 995 is the well-known/IANA registered port for POP3S ie over SSL/TLS
-port 110 is the well-known/IANA registered port for Standard POP3</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connectionBacklog</p></td>
-<td class="tableblock halign-left valign-top"></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tls</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set to true to support STARTTLS or SSL for the Socket.
-To create a new keystore execute:
-<code>keytool -genkey -alias james -keyalg RSA -storetype PKCS12 -keystore /path/to/james/conf/keystore</code>
-Please note that each POP3 server exposed on different port can specify its own keystore, independently from any other
-TLS based protocols. Read <a href="ssl.html" class="xref page">SSL configuration page</a> for more information.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">handler.helloName</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">This is the name used by the server to identify itself in the POP3
-protocol. If autodetect is TRUE, the server will discover its
-own host name and use that in the protocol. If discovery fails,
-the value of 'localhost' is used. If autodetect is FALSE, James
-will use the specified value.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">handler.connectiontimeout</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Connection timeout in seconds</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">handler.connectionLimit</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum simultaneous incoming connections for this service</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">handler.connectionLimitPerIP</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum simultaneous incoming connections per IP for this service</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">handler.handlerchain</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">This loads the core CommandHandlers. Only remove this if you really know what you are doing.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">bossWorkerCount</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum count of boss threads. Boss threads are responsible for accepting incoming POP3 connections
-and initializing associated resources. Optional integer, by default, boss threads are not used and this responsibility is being dealt with
-by IO threads.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ioWorkerCount</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum count of IO threads. IO threads are responsible for receiving incoming POP3 messages and framing them
-(split line by line). IO threads also take care of compression and SSL encryption. Their tasks are short-lived and non-blocking.
-Optional integer, defaults to 2 times the count of CPUs.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">maxExecutorCount</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum count of worker threads. Worker threads takes care of potentially blocking tasks like executing POP3 requests. Optional integer, defaults to 16.</p></td>
-</tr>
-</tbody>
-</table>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/configure/queue.html b/james-distributed-app/3.8.0/configure/queue.html
deleted file mode 100644
index 98d0b57..0000000
--- a/james-distributed-app/3.8.0/configure/queue.html
+++ /dev/null
@@ -1,442 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — queue.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="queue.html">Distributed James Server — queue.properties</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/queue.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — queue.properties</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This configuration helps you configure mail queue you want to select.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_queue_configuration"><a class="anchor" href="#_queue_configuration"></a>Queue Configuration</h2>
-<div class="sectionbody">
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. queue.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mail.queue.choice</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Mail queue can be implemented by many type of message brokers: Pulsar, RabbitMQ,…​ This property will choose which mail queue you want, defaulting to RABBITMQ</p></td>
-</tr>
-</tbody>
-</table>
-<div class="paragraph">
-<p><code>mail.queue.choice</code> supports the following options:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>You can specify the <code>RABBITMQ</code> if you want to choose RabbitMQ mail queue</p>
-</li>
-<li>
-<p>You can specify the <code>PULSAR</code> if you want to choose Pulsar mail queue</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/configure/rabbitmq.html b/james-distributed-app/3.8.0/configure/rabbitmq.html
deleted file mode 100644
index 7c793a1..0000000
--- a/james-distributed-app/3.8.0/configure/rabbitmq.html
+++ /dev/null
@@ -1,659 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — rabbitmq.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Storage dependencies</li>
- <li><a href="rabbitmq.html">rabbitmq.properties</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/rabbitmq.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — rabbitmq.properties</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This configuration helps you configure components using RabbitMQ.</p>
-</div>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/rabbitmq.properties">example</a>
-to get some examples and hints.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_rabbitmq_configuration"><a class="anchor" href="#_rabbitmq_configuration"></a>RabbitMQ Configuration</h2>
-<div class="sectionbody">
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. rabbitmq.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">uri</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">the amqp URI pointing to RabbitMQ server. If you use a vhost, specify it as well at the end of the URI.
-Details about amqp URI format is in <a href="https://www.rabbitmq.com/uri-spec.html">RabbitMQ URI Specification</a></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">management.uri</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">the URI pointing to RabbitMQ Management Service. James need to retrieve some information about listing queues
-from this service in runtime.
-Details about URI format is in <a href="https://www.rabbitmq.com/management.html#usage-ui">RabbitMQ Management URI</a></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">management.user</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">username used to access management service</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">management.password</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">password used to access management service</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connection.pool.retries</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure retries count to retrieve a connection. Exponential backoff is performed between each retries.
-Optional integer, defaults to 10</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connection.pool.min.delay.ms</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure initial duration (in ms) between two connection retries. Exponential backoff is performed between each retries.
-Optional integer, defaults to 100</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">channel.pool.retries</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure retries count to retrieve a channel. Exponential backoff is performed between each retries.
-Optional integer, defaults to 3</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">channel.pool.max.delay.ms</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure timeout duration (in ms) to obtain a rabbitmq channel. Defaults to 30 seconds.
-Optional integer, defaults to 30 seconds.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">channel.pool.size</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure the size of the channel pool.
-Optional integer, defaults to 3</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ssl.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Is using ssl enabled
-Optional boolean, defaults to false</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ssl.management.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Is using ssl on management api enabled
-Optional boolean, defaults to false</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ssl.validation.strategy</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure the validation strategy used for rabbitmq connections. Possible values are default, ignore and override.
-Optional string, defaults to using systemwide ssl configuration</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ssl.truststore</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Points to the truststore (PKCS12) used for verifying rabbitmq connection. If configured then "ssl.truststore.password" must also be configured,
-Optional string, defaults to systemwide truststore. "ssl.validation.strategy: override" must be configured if you want to use this</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ssl.truststore.password</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure the truststore password. If configured then "ssl.truststore" must also be configured,
-Optional string, defaults to empty string. "ssl.validation.strategy: override" must be configured if you want to use this</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ssl.hostname.verifier</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure host name verification. Possible options are default and accept_any_hostname
-Optional string, defaults to subject alternative name host verifier</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ssl.keystore</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Points to the keystore(PKCS12) used for client certificate authentication. If configured then "ssl.keystore.password" must also be configured,
-Optional string, defaults to empty string</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ssl.keystore.password</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure the keystore password. If configured then "ssl.keystore" must also be configured,
-Optional string, defaults to empty string</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">quorum.queues.enable</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Boolean. Whether to activate Quorum queue usage for use cases that benefits from it (work queue).
-Quorum queues enables high availability.
-False (default value) results in the usage of classic queues.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">quorum.queues.replication.factor</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Strictly positive integer. The replication factor to use when creating quorum queues.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">hosts</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional, default to the host specified as part of the URI.
-Allow creating cluster aware connections.
-A coma separated list of hosts, example: hosts=ip1:5672,ip2:5672</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailqueue.publish.confirm.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Whether or not to enable publish confirms for the mail queue. Optional boolean, defaults to true.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">event.bus.publish.confirm.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Whether or not to enable publish confirms for the event bus. Optional boolean, defaults to true.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">event.bus.notification.durability.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Whether or not the queue backing notifications should be durable. Optional boolean, defaults to true.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">vhost</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional string. This parameter is only a workaround to support invalid URIs containing character like '_'.
-You still need to specify the vhost in the uri parameter.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_rabbitmq_mailqueue_configuration"><a class="anchor" href="#_rabbitmq_mailqueue_configuration"></a>RabbitMQ MailQueue Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>James mail queue is a component acting like a queue where it can enqueue and dequeue mails.
-Beside of the basic features, it also allows some extra operations like getting size, browsing all items in the mail queue…​
-One of the mailqueue implementation is using RabbitMQ.
-As RabbitMQ doesn’t offer enough features to implement efficiently all mailqueue operations,
-this implementation relies on Cassandra.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 2. rabbitmq.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandra.view.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Whether the Cassandra administrative view should be activated. Boolean value defaulting to true.
-Not necessarily needed for MDA deployments, mail queue management adds significant complexity.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailqueue.view.sliceWindow</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">James divides the view into slices, each slice contains data for a given period, sliceWindow parameter controls this period.
-This dividing of periods allows faster browsing of the mail queue. Tips for choosing sliceWindow are explained in
-<a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/rabbitmq.properties">rabbitmq.properties</a></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailqueue.view.bucketCount</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Mails in a mail queue are distributed across the underlying storage service.
-BucketCount describes how to be distributing mails to fit with your James setup
-Tips for choosing bucketCount are explained in
-<a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/rabbitmq.properties">rabbitmq.properties</a></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailqueue.view.updateBrowseStartPace</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">To browse, James needs a starting point and to continuously update that point in runtime.
-UpdateBrowseStartPace describes the probability to update the starting point.
-Tips for choosing updateBrowseStartPace are explained in
-<a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/rabbitmq.properties">rabbitmq.properties</a></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailqueue.size.metricsEnabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">By default, the metrics are disabled for the mail queue size.
-As computing the size of the mail queue is currently implemented on top of browse operation and thus has a linear complexity,
-sometimes it can get too big, making it impossible for the ES reporter to handle it correctly without crashing.
-It can be useful then to disable it.
-Tips for choosing metricsEnabled are explained in
-<a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/rabbitmq.properties">rabbitmq.properties</a></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">notification.queue.ttl</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure queue ttl (in ms). References: <a href="https://www.rabbitmq.com/ttl.html#queue-ttl" class="bare">https://www.rabbitmq.com/ttl.html#queue-ttl</a>.
-This is used only on queues used to share notification patterns, are exclusive to a node. If omitted, it will not add the TTL configure when declaring queues.
-Optional integer, defaults is 3600000.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_rabbitmq_tasks_configuration"><a class="anchor" href="#_rabbitmq_tasks_configuration"></a>RabbitMQ Tasks Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Tasks are WebAdmin triggered long running jobs. RabbitMQ is used to organise their execution in a work queue,
-with an exclusive consumer.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 3. rabbitmq.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">task.consumption.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Whether to enable task consumption on this node.
-Disable with caution (this only makes sense in a distributed setup where other nodes consume tasks).
-Defaults to true.</p>
-<p class="tableblock">Limitation: Sometimes, some tasks running on James can be very heavy and take a couple of hours to complete.
-If other tasks are being triggered meanwhile on WebAdmin, they go on the TaskManagerWorkQueue and James unack them,
-telling RabbitMQ it will consume them later. If they don’t get consumed before the consumer timeout setup in
-RabbitMQ (default being 30 minutes), RabbitMQ closes the channel on an exception. It is thus advised to declare a
-longer timeout in rabbitmq.conf. More <a href="https://www.rabbitmq.com/consumers.html#acknowledgement-timeout">here</a>.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">task.queue.consumer.timeout</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Task queue consumer timeout.</p>
-<p class="tableblock">Optional. Duration (support multiple time units cf <code>DurationParser</code>), defaults to 1 day.</p>
-<p class="tableblock">Required at least RabbitMQ version 3.12 to have effect.
-This is used to avoid the task queue consumer (which could run very long tasks) being disconnected by RabbitMQ after the default acknowledgement timeout 30 minutes.
-References: <a href="https://www.rabbitmq.com/consumers.html#acknowledgement-timeout" class="bare">https://www.rabbitmq.com/consumers.html#acknowledgement-timeout</a>.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/configure/recipientrewritetable.html b/james-distributed-app/3.8.0/configure/recipientrewritetable.html
deleted file mode 100644
index bb7bd4f..0000000
--- a/james-distributed-app/3.8.0/configure/recipientrewritetable.html
+++ /dev/null
@@ -1,431 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — recipientrewritetable.xml :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Core components</li>
- <li><a href="recipientrewritetable.html">recipientrewritetable.xml</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/recipientrewritetable.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — recipientrewritetable.xml</h1>
-<div class="paragraph">
-<p>Here are explanations on the different kinds about <a href="../architecture/index.html#_recipient_rewrite_tables" class="xref page">recipient rewriting</a>.</p>
-</div>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/recipientrewritetable.xml">example</a>
-to get some examples and hints.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. recipientrewritetable.xml</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">recursiveMapping</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">If set to false only the first mapping will get processed - Default true.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mappingLimit</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">By setting the mappingLimit you can specify how much mapping will get processed before a bounce will send. This avoids infinity loops. Default 10.</p></td>
-</tr>
-</tbody>
-</table>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/configure/redis.html b/james-distributed-app/3.8.0/configure/redis.html
deleted file mode 100644
index 0a2f263..0000000
--- a/james-distributed-app/3.8.0/configure/redis.html
+++ /dev/null
@@ -1,448 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — redis.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Storage dependencies</li>
- <li><a href="redis.html">redis.properties</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/redis.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — redis.properties</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This configuration helps you configure components using Redis. This so far only includes optional rate limiting component.</p>
-</div>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/fabfdf4874da3aebb04e6fe4a7277322a395536a/server/mailet/rate-limiter-redis/redis.properties">example</a>
-to get some examples and hints.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_redis_configuration"><a class="anchor" href="#_redis_configuration"></a>Redis Configuration</h2>
-<div class="sectionbody">
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. redis.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">redisURL</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">the Redis URI pointing to Redis server. Compulsory.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cluster.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Whether we should attempt connections to Redis as a cluster.Defaults to false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">redis.ioThreads</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">IO threads to be using for the underlying Netty networking resources. If unspecified driver defaults applies.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">redis.workerThreads</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Worker threads to be using for the underlying driver. If unspecified driver defaults applies.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/configure/remote-delivery-error-handling.html b/james-distributed-app/3.8.0/configure/remote-delivery-error-handling.html
deleted file mode 100644
index 57d11e7..0000000
--- a/james-distributed-app/3.8.0/configure/remote-delivery-error-handling.html
+++ /dev/null
@@ -1,585 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — About RemoteDelivery error handling :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Extensions</li>
- <li><a href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/remote-delivery-error-handling.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — About RemoteDelivery error handling</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>The advanced server mailQueue implemented by combining RabbitMQ for messaging and Cassandra for administrative operation
-does not support delays.</p>
-</div>
-<div class="paragraph">
-<p>Delays are an important feature for Mail Exchange servers, allowing to defer in time the retries, potentially letting the
-time for the remote server to recover. Furthermore, they enable implementation of advanced features like throttling and
-rate limiting of emails sent to a given domain.</p>
-</div>
-<div class="paragraph">
-<p>As such, the use of the distributed server as a Mail Exchange server is currently discouraged.</p>
-</div>
-<div class="paragraph">
-<p>However, for operators willing to inter-operate with a limited set of well-identified, trusted remote mail servers, such
-limitation can be reconsidered. The main concern then become error handling for remote mail server failures. The following
-document will present a well tested strategy for Remote Delivery error handling leveraging standards Mail Processing components
-and mechanisms.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_expectations"><a class="anchor" href="#_expectations"></a>Expectations</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Such a solution should:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Attempt delivery a single time</p>
-</li>
-<li>
-<p>Store transient and permanent failure in different mail repositories</p>
-</li>
-<li>
-<p>After a given number of tries, transient failures should be considered permanent</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_design"><a class="anchor" href="#_design"></a>Design</h2>
-<div class="sectionbody">
-<div class="imageblock">
-<div class="content">
-<img src="../_images/remote-delivery-error-handling.png" alt="Schema detailing the proposed solution">
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Remote Delivery is configured for performing a single retry.</p>
-</li>
-<li>
-<p>Remote Delivery attaches the error code and if the failure is permanent/temporary when transferring failed emails to the
-bounce processor.</p>
-</li>
-<li>
-<p>The specified bounce processor will categorise the failure, and store temporary and permanent failures in different
-mail repositories.</p>
-</li>
-<li>
-<p>A reprocessing of the temporary delivery errors mailRepository needs to be scheduled in a recurring basis. For
-instance via a CRON job calling the right webadmin endpoint.</p>
-</li>
-<li>
-<p>A counter ensures that a configured number of delivery tries is not exceeded.</p>
-</li>
-</ul>
-</div>
-<div class="sect2">
-<h3 id="_limitation"><a class="anchor" href="#_limitation"></a>Limitation</h3>
-<div class="paragraph">
-<p>MailRepositories are not meant for transient data storage, and thus are prone to tombstone issues.</p>
-</div>
-<div class="paragraph">
-<p>This might be acceptable if you need to send mail to well-known peers. For instance handling your mail gateway failures.
-However a Mail Exchange server doing relay on the internet would quickly hit this limitation.</p>
-</div>
-<div class="paragraph">
-<p>Also note that external triggering of the retry process is needed.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_operation"><a class="anchor" href="#_operation"></a>Operation</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Here is an example of configuration achieving the proposed solution:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> <processor state="relay" enableJmx="true">
- <!-- Perform at most 5 RemoteDelivery attemps -->
- <mailet match="AtMost=5" class="RemoteDelivery">
- <outgoingQueue>outgoing</outgoingQueue>
- <maxRetries>0</maxRetries>
- <maxDnsProblemRetries>0</maxDnsProblemRetries>
- <deliveryThreads>10</deliveryThreads>
- <sendpartial>true</sendpartial>
- <!-- Use a custom processor for error handling -->
- <bounceProcessor>remote-delivery-error</bounceProcessor>
- </mailet>
- <!-- When retries are exceeded, consider the mail as a permanent failure -->
- <mailet match="All" class="ToRepository">
- <repositoryPath>cassandra://var/mail/error/remote-delivery/permanent/</repositoryPath>
- </mailet>
- </processor>
-
- <processor state="remote-delivery-error" enableJmx="true">
- <!-- Store temporary failures separately for later retries -->
- <mailet match="IsRemoteDeliveryTemporaryError" class="ToRepository">
- <repositoryPath>cassandra://var/mail/error/remote-delivery/temporary/</repositoryPath>
- </mailet>
- <!-- Store permanent failures for audit -->
- <mailet match="IsRemoteDeliveryPermanentError" class="ToRepository">
- <repositoryPath>cassandra://var/mail/error/remote-delivery/permanent/</repositoryPath>
- </mailet>
- <!-- Mail getting that far were not processed by remote delivery.
- Likely a configuration error. -->
- <mailet match="All" class="ToRepository">
- <repositoryPath>cassandra://var/mail/error/</repositoryPath>
- </mailet>
- </processor></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>The <strong>relay</strong> processor holds a RemoteDelivery mailet configured to do a single try, at most 5 times (see the AtMost matcher).
-Mails exceeding the AtMost condition are considered as permanent delivery errors. Delivery errors are sent to the
-<strong>remote-delivery-error</strong> processor.</p>
-</li>
-<li>
-<p>The <strong>remote-delivery-error</strong> stores temporary and permanent errors.</p>
-</li>
-<li>
-<p>Permanent relay errors are stored in <code>cassandra://var/mail/error/remote-delivery/permanent/</code>.</p>
-</li>
-<li>
-<p>Temporary relay errors are stored in <code>cassandra://var/mail/error/remote-delivery/temporary/</code>.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>In order to retry the relay of temporary failed emails, operators will have to configure a cron job for reprocessing
-emails from <strong>cassandra://var/mail/error/remote-delivery/temporary/</strong> mailRepository into the <strong>relay</strong> processor.</p>
-</div>
-<div class="paragraph">
-<p>This can be achieved via the following webAdmin call :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPATCH 'http://ip:8000/mailRepositories/cassandra%3A%2F%2Fvar%2Fmail%2Ferror%2Fremote-delivery%2Ftemporary%2F/mails?action=reprocess&processor=relay'</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>See <a href="../operate/webadmin.html#_reprocessing_mails_from_a_mail_repository" class="xref page">the documentation</a>.</p>
-</div>
-<div class="paragraph">
-<p>Administrators need to keep a close eye on permanent errors (that might require audit, and potentially contacting the remote
-service supplier).</p>
-</div>
-<div class="paragraph">
-<p>To do so, one should regularly audit the content of <strong>cassandra://var/mail/error/remote-delivery/permanent/</strong>. This can be done
-via webAdmin calls:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET 'http://ip:8000/mailRepositories/cassandra%3A%2F%2Fvar%2Fmail%2Ferror%2Fremote-delivery%2Ftemporary%2F/mails'</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>See <a href="../operate/webadmin.html#_listing_mails_contained_in_a_mail_repository" class="xref page">the documentation</a>.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/configure/search.html b/james-distributed-app/3.8.0/configure/search.html
deleted file mode 100644
index 8c455f1..0000000
--- a/james-distributed-app/3.8.0/configure/search.html
+++ /dev/null
@@ -1,429 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Search configuration :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Core components</li>
- <li><a href="search.html">search.properties</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/search.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Search configuration</h1>
-<div class="paragraph">
-<p>This configuration helps you configure the components used to back search.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. search.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">implementation</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The implementation to be used for search. Should be one of:
- - <strong>opensearch</strong> : Index and search mails into OpenSearch.
- - <strong>scanning</strong> : Do not index documents and perform scanning search, scrolling mailbox for matching contents.
- This implementation can have a prohibitive cost.
- - <strong>opensearch-disabled</strong> : Saves events to index into event dead letter. Make searches fails.
- This is useful to start James without OpenSearch while still tracking messages to index for later recovery. This
- can be used in order to ease delays for disaster recovery action plans.</p></td>
-</tr>
-</tbody>
-</table>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/configure/sieve.html b/james-distributed-app/3.8.0/configure/sieve.html
deleted file mode 100644
index 7d11f10..0000000
--- a/james-distributed-app/3.8.0/configure/sieve.html
+++ /dev/null
@@ -1,549 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Sieve :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Protocols</li>
- <li><a href="sieve.html">Sieve & ManageSieve</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/sieve.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Sieve</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>James servers are able to evaluate and execute Sieve scripts.</p>
-</div>
-<div class="paragraph">
-<p>Sieve is an extensible mail filtering language. It’s limited
-expressiveness (no loops or variables, no tests with side
-effects) allows user created scripts to be run safely on email
-servers. Sieve is targeted at the final delivery phase (where
-an incoming email is transferred to a user’s mailbox).</p>
-</div>
-<div class="paragraph">
-<p>The following Sieve capabilities are supported by Apache James:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://www.ietf.org/rfc/rfc2234.txt">RFC 2234 ABNF</a></p>
-</li>
-<li>
-<p><a href="https://www.ietf.org/rfc/rfc2244.txt">RFC 2244 ACAP</a></p>
-</li>
-<li>
-<p><a href="https://www.ietf.org/rfc/rfc2298.txt">RFC 2298 MDN</a></p>
-</li>
-<li>
-<p><a href="https://tools.ietf.org/html/rfc5228">RFC 5228 Sieve</a></p>
-</li>
-<li>
-<p><a href="https://tools.ietf.org/html/rfc4790">RFC 4790 IAPCR</a></p>
-</li>
-<li>
-<p><a href="https://tools.ietf.org/html/rfc5173">RFC 5173 Body Extension</a></p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc5230">RFC 5230 Vacations</a></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>To be correctly executed, please note that the <strong>Sieve</strong> mailet is required to be positioned prior the
-<strong>LocalDelivery</strong> mailet.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_managing_sieve_scripts"><a class="anchor" href="#_managing_sieve_scripts"></a>Managing Sieve scripts</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>A user willing to manage his Sieve scripts on the server can do so via several means:</p>
-</div>
-<div class="paragraph">
-<p>He can ask an admin to upload his script via the <a href="../operate/cli.html" class="xref page">CLI</a></p>
-</div>
-<div class="paragraph">
-<p>As James supports ManageSieve (<a href="https://datatracker.ietf.org/doc/html/rfc5804">RFC-5804</a>) a user
-can thus use compatible software to manage his Sieve scripts.</p></p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_managesieve_protocol"><a class="anchor" href="#_managesieve_protocol"></a>ManageSieve protocol</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p><strong>WARNING</strong>: ManageSieve protocol should be considered experimental.</p>
-</div>
-<div class="paragraph">
-<p>Consult <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/managesieveserver.xml">managesieveserver.xml</a>
-in GIT to get some examples and hints.</p>
-</div>
-<div class="paragraph">
-<p>The service is controlled by a configuration block in the managesieveserver.xml.
-The managesieveserver tag defines the boundaries of the configuration block. It encloses
-all the relevant configuration for the ManageSieve server. The behavior of the ManageSieve service is
-controlled by the attributes and children of this tag.</p>
-</div>
-<div class="paragraph">
-<p>This tag has an optional boolean attribute - <strong>enabled</strong> - that defines whether the service is active or not.
-The value defaults to "false" if
-not present.</p>
-</div>
-<div class="paragraph">
-<p>The standard children of the managesieveserver tag are:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. managesieveserver.xml content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">bind</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure this to bind to a specific inetaddress. This is an optional integer value. This value is the port on which this ManageSieve server is configured to listen. If the tag or value is absent then the service
-will bind to all network interfaces for the machine If the tag or value is omitted, the value will default to the standard ManageSieve port (port 4190 is the well-known/IANA registered port for ManageSieve.)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tls</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set to true to support STARTTLS or SSL for the Socket.
-To use this you need to copy sunjce_provider.jar to /path/james/lib directory. To create a new keystore execute:
-<code>keytool -genkey -alias james -keyalg RSA -storetype PKCS12 -keystore /path/to/james/conf/keystore</code>.
-Please note that each ManageSieve server exposed on different port can specify its own keystore, independently from any other
-TLS based protocols.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connectionBacklog</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Number of connection backlog of the server (maximum number of queued connection requests)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connectiontimeout</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Connection timeout in seconds</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connectionLimit</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum simultaneous incoming connections for this service</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connectionLimitPerIP</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum simultaneous incoming connections per IP for this service</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">bossWorkerCount</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum count of boss threads. Boss threads are responsible for accepting incoming ManageSieve connections
-and initializing associated resources. Optional integer, by default, boss threads are not used and this responsibility is being dealt with
-by IO threads.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ioWorkerCount</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum count of IO threads. IO threads are responsible for receiving incoming ManageSieve messages and framing them
-(split line by line). IO threads also take care of compression and SSL encryption. Their tasks are short-lived and non-blocking.
-Optional integer, defaults to 2 times the count of CPUs.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">maxExecutorCount</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum count of worker threads. Worker threads takes care of potentially blocking tasks like executing ManageSieve commands.
-Optional integer, defaults to 16.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/configure/smtp-hooks.html b/james-distributed-app/3.8.0/configure/smtp-hooks.html
deleted file mode 100644
index 1a1f3cf..0000000
--- a/james-distributed-app/3.8.0/configure/smtp-hooks.html
+++ /dev/null
@@ -1,833 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — SMTP Hooks :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Protocols</li>
- <li><a href="smtp-hooks.html">Packaged SMTP hooks</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/smtp-hooks.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — SMTP Hooks</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This documentation page lists and documents SMTP hooks that can be used within the
-Distributed Server SMTP protocol stack in order to customize the way your SMTP server
-behaves without of the box components.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_dnsrblhandler"><a class="anchor" href="#_dnsrblhandler"></a>DNSRBLHandler</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This command handler check against <a href="https://www.wikiwand.com/en/Domain_Name_System-based_Blackhole_List">RBL-Lists</a>
-(Real-time Blackhole List).</p>
-</div>
-<div class="paragraph">
-<p>If getDetail is set to true it try to retrieve information from TXT Record
-why the ip was blocked. Default to false.</p>
-</div>
-<div class="paragraph">
-<p>before you enable out the DNS RBL handler documented as an example below,
-please take a moment to review each block in the list.
-We have included some that various JAMES committers use,
-but you must decide which, if any, are appropriate
-for your environment.</p>
-</div>
-<div class="paragraph">
-<p>The mail servers hosting
-@apache.org mailing lists, for example, use a
-slightly different list than we have included below.
-And it is likely that most JAMES committers also have
-slightly different sets of lists.</p>
-</div>
-<div class="paragraph">
-<p>The SpamAssassin user’s list would be one good place to discuss the
-measured quality of various block lists.</p>
-</div>
-<div class="paragraph">
-<p>NOTA BENE: the domain names, below, are terminated
-with '.' to ensure that they are absolute names in
-DNS lookups. Under some circumstances, names that
-are not explicitly absolute could be treated as
-relative names, leading to incorrect results. This
-has been observed on *nix and MS-Windows platforms
-by users of multiple mail servers, and is not JAMES
-specific. If you are unsure what this means for you,
-please speak with your local system/network admins.</p>
-</div>
-<div class="paragraph">
-<p>This handler should be considered experimental.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><handlerchain>
- <!-- ... -->
- <handler class="org.apache.james.smtpserver.fastfail.DNSRBLHandler">
- <getDetail>false</getDetail>
- <rblservers>
- <whitelist>query.bondedsender.org.</whitelist>
- <blacklist>sbl-xbl.spamhaus.org.</blacklist>
- <blacklist>dul.dnsbl.sorbs.net.</blacklist>
- <blacklist>list.dsbl.org.</blacklist>
- </rblservers>
- </handler>
-</handlerchain></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_dsn_hooks"><a class="anchor" href="#_dsn_hooks"></a>DSN hooks</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The Distributed server has optional support for DSN (<a href="https://tools.ietf.org/html/rfc3461">RFC-3461</a>)</p>
-</div>
-<div class="paragraph">
-<p>Please read carefully <a href="dsn.html" class="xref page">this page</a>.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><smtpserver enabled="true">
- <...> <!-- The rest of your SMTP configuration, unchanged -->
- <handlerchain>
- <handler class="org.apache.james.smtpserver.dsn.DSNEhloHook"/>
- <handler class="org.apache.james.smtpserver.dsn.DSNMailParameterHook"/>
- <handler class="org.apache.james.smtpserver.dsn.DSNRcptParameterHook"/>
- <handler class="org.apache.james.smtpserver.dsn.DSNMessageHook"/>
- <...> <!-- other handlers, like: -->
- <handler class="org.apache.james.smtpserver.CoreCmdHandlerLoader"/> <!-- for instance -->
- </handlerchain>
-</smtpserver></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note that a specific configuration of <a href="mailetcontainer.html" class="xref page">mailetcontainer.xml</a> is
-required as well to be spec compliant.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_mailpriorityhandler"><a class="anchor" href="#_mailpriorityhandler"></a>MailPriorityHandler</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This handler can add a hint to the mail which tells the MailQueue which email should get processed first.</p>
-</div>
-<div class="paragraph">
-<p>Normally the MailQueue will just handle Mails in FIFO manner.</p>
-</div>
-<div class="paragraph">
-<p>Valid priority values are 1,5,9 where 9 is the highest.</p>
-</div>
-<div class="paragraph">
-<p>This handler should be considered experimental.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><handlerchain>
- <!-- ... -->
- <handler class="org.apache.james.smtpserver.MailPriorityHandler">
- <priorityEntries>
- <priorityEntry>
- <domain>yourdomain1</domain>
- <priority>1</priority>
- </priorityEntry>
- <priorityEntry>
- <domain>yourdomain2</domain>
- <priority>9</priority>
- </priorityEntry>
- <priorityEntries>
- </handler>
-</handlerchain></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_maxrcpthandler"><a class="anchor" href="#_maxrcpthandler"></a>MaxRcptHandler</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>If activated you can limit the maximal recipients.</p>
-</div>
-<div class="paragraph">
-<p>This handler should be considered experimental.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><handlerchain>
- <!-- ... -->
- <handler class="org.apache.james.smtpserver.fastfail.MaxRcptHandler">
- <maxRcpt>10</maxRcpt>
- </handler>
-</handlerchain></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_pop3beforesmtphandler"><a class="anchor" href="#_pop3beforesmtphandler"></a>POP3BeforeSMTPHandler</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This connect handler can be used to enable POP3 before SMTP support.</p>
-</div>
-<div class="paragraph">
-<p>Please note that only the ip get stored to identify an authenticated client.</p>
-</div>
-<div class="paragraph">
-<p>The expireTime is the time after which an ipAddress is handled as expired.</p>
-</div>
-<div class="paragraph">
-<p>This handler should be considered as unsupported.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><handlerchain>
- <!-- ... -->
- <handler class="org.apache.james.smtpserver.POP3BeforeSMTPHandler">
- <expireTime>1 hour</expireTime>
- </handler>
-</handlerchain></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_resolvableehlohelohandler"><a class="anchor" href="#_resolvableehlohelohandler"></a>ResolvableEhloHeloHandler</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Checks for resolvable HELO/EHLO before accept the HELO/EHLO.</p>
-</div>
-<div class="paragraph">
-<p>If checkAuthNetworks is set to true sender domain will be checked also for clients that
-are allowed to relay. Default is false.</p>
-</div>
-<div class="paragraph">
-<p>This handler should be considered experimental.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><handlerchain>
- <!-- ... -->
- <handler class="org.apache.james.smtpserver.fastfail.ResolvableEhloHeloHandler"/>
-</handlerchain></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_reverseequalsehlohelohandler"><a class="anchor" href="#_reverseequalsehlohelohandler"></a>ReverseEqualsEhloHeloHandler</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Checks HELO/EHLO is equal the reverse of the connecting client before accept it
-If checkAuthNetworks is set to true sender domain will be checked also for clients that
-are allowed to relay. Default is false.</p>
-</div>
-<div class="paragraph">
-<p>This handler should be considered experimental.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><handlerchain>
- <!-- ... -->
- <handler class="org.apache.james.smtpserver.fastfail.ReverseEqualsEhloHeloHandler"/>
-</handlerchain></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_setmimeheaderhandler"><a class="anchor" href="#_setmimeheaderhandler"></a>SetMimeHeaderHandler</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This handler allows you to add mime headers to the processed mails.</p>
-</div>
-<div class="paragraph">
-<p>This handler should be considered experimental.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><handlerchain>
- <!-- ... -->
- <handler class="org.apache.james.smtpserver.SetMimeHeaderHandler">
- <headername>SPF-test</headername>
- <headervalue>passed</headervalue>
- </handler>
-</handlerchain></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_spamassassinhandler"><a class="anchor" href="#_spamassassinhandler"></a>SpamAssassinHandler</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This MessageHandler could be used to check message against spamd before
-accept the email. So it’s possible to reject a message on smtplevel if a
-configured hits amount is reached.</p>
-</div>
-<div class="paragraph">
-<p>This handler should be considered experimental.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><handlerchain>
- <!-- ... -->
- <handler class="org.apache.james.smtpserver.fastfail.SpamAssassinHandler">
- <spamdHost>127.0.0.1</spamdHost>
- <spamdPort>783</spamdPort>
- <spamdRejectionHits>10</spamdRejectionHits>
- </handler>
-</handlerchain></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_spfhandler"><a class="anchor" href="#_spfhandler"></a>SPFHandler</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This command handler can be used to reject emails with not match the SPF record of the sender domain.</p>
-</div>
-<div class="paragraph">
-<p>If checkAuthNetworks is set to true sender domain will be checked also for clients that
-are allowed to relay. Default is false.</p>
-</div>
-<div class="paragraph">
-<p>This handler should be considered experimental.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><handlerchain>
- <!-- ... -->
- <handler class="org.apache.james.smtpserver.fastfail.SPFHandler">
- <blockSoftFail>false</blockSoftFail>
- <blockPermError>true</blockPermError>
- </handler>
-</handlerchain></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_urirblhandler"><a class="anchor" href="#_urirblhandler"></a>URIRBLHandler</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This MessageHandler could be used to extract domain out of the message and check
-this domains against uriRbllists. See <a href="http://www.surbl.org" class="bare">http://www.surbl.org</a> for more information.
-The message get rejected if a domain matched.</p>
-</div>
-<div class="paragraph">
-<p>This handler should be considered experimental.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><handlerchain>
- <!-- ... -->
- <handler class="org.apache.james.smtpserver.fastfail.URIRBLHandler">
- <action>reject</action>
- <getDetail>true</getDetail>
- <uriRblServers>
- <server>multi.surbl.org</server>
- </uriRblServers>
- </handler>
-</handlerchain></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_validrcpthandler"><a class="anchor" href="#_validrcpthandler"></a>ValidRcptHandler</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>With ValidRcptHandler, all email will get rejected which has no valid user.</p>
-</div>
-<div class="paragraph">
-<p>You need to add the recipient to the validRecipient list if you want
-to accept email for a recipient which not exist on the server.</p>
-</div>
-<div class="paragraph">
-<p>If you want James to act as a spamtrap or honeypot, you may comment ValidRcptHandler
-and implement the needed processors in spoolmanager.xml.</p>
-</div>
-<div class="paragraph">
-<p>This handler should be considered stable.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><handlerchain>
- <!-- ... -->
- <handler class="org.apache.james.smtpserver.fastfail.ValidRcptHandler"/>
-</handlerchain></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_validsenderdomainhandler"><a class="anchor" href="#_validsenderdomainhandler"></a>ValidSenderDomainHandler</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>If activated mail is only accepted if the sender contains
-a resolvable domain having a valid MX Record or A Record associated!</p>
-</div>
-<div class="paragraph">
-<p>If checkAuthNetworks is set to true sender domain will be checked also for clients that
-are allowed to relay. Default is false.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><handlerchain>
- <!-- ... -->
- <handler class="org.apache.james.smtpserver.fastfail.ValidSenderDomainHandler"/>
-</handlerchain></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_futurerelease_hooks"><a class="anchor" href="#_futurerelease_hooks"></a>FUTURERELEASE hooks</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The Distributed server has optional support for FUTURERELEASE (<a href="https://www.rfc-editor.org/rfc/rfc4865.html">RFC-4865</a>)</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><smtpserver enabled="true">
- <...> <!-- The rest of your SMTP configuration, unchanged -->
- <handlerchain>
- <handler class="org.apache.james.smtpserver.futurerelease.FutureReleaseEHLOHook"/>
- <handler class="org.apache.james.smtpserver.futurerelease.FutureReleaseMailParameterHook"/>
- <handler class="org.apache.james.smtpserver.CoreCmdHandlerLoader"/>
- </handlerchain>
-</smtpserver></pre>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/configure/smtp.html b/james-distributed-app/3.8.0/configure/smtp.html
deleted file mode 100644
index 6ac704e..0000000
--- a/james-distributed-app/3.8.0/configure/smtp.html
+++ /dev/null
@@ -1,777 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — smtpserver.xml :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Protocols</li>
- <li><a href="smtp.html">smtpserver.xml & lmtpserver.xml</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/smtp.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — smtpserver.xml</h1>
-<div class="sect1">
-<h2 id="_incoming_smtp"><a class="anchor" href="#_incoming_smtp"></a>Incoming SMTP</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/smtpserver.xml">example</a>
-to get some examples and hints.</p>
-</div>
-<div class="paragraph">
-<p>The SMTP service is controlled by a configuration block in the smptserver.xml.
-The smtpserver tag defines the boundaries of the configuration block. It encloses
-all the relevant configuration for the SMTP server. The behavior of the SMTP service is
-controlled by the attributes and children of this tag.</p>
-</div>
-<div class="paragraph">
-<p>This tag has an optional boolean attribute - <strong>enabled</strong> - that defines whether the service is active or not. The value defaults to "true" if
-not present.</p>
-</div>
-<div class="paragraph">
-<p>The standard children of the smtpserver tag are:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. smtpserver.xml content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">bind</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A list of address:port separed by comma - This is an optional value. If present, this value is a string describing
-the IP address to which this service should be bound. If the tag or value is absent then the service
-will bind to all network interfaces for the machine on port 25. Port 25 is the well-known/IANA registered port for SMTP.
-Port 465 is the well-known/IANA registered port for SMTP over TLS.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connectBacklog</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The IP address (host name) the MBean Server will bind/listen to.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tls</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set to true to support STARTTLS or SSL for the Socket.
-To use this you need to copy sunjce_provider.jar to /path/james/lib directory. To create a new keystore execute:
-<code>keytool -genkey -alias james -keyalg RSA -storetype PKCS12 -keystore /path/to/james/conf/keystore</code>.
-The algorithm is optional and only needs to be specified when using something other
-than the Sun JCE provider - You could use IbmX509 with IBM Java runtime.
-Please note that each SMTP/LMTP server exposed on different port can specify its own keystore, independently from any other
-TLS based protocols.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">helloName</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">This is a required tag with an optional body that defines the server name
-used in the initial service greeting. The tag may have an optional attribute - <strong>autodetect</strong>. If
-the autodetect attribute is present and true, the service will use the local hostname
-returned by the Java libraries. If autodetect is absent or false, the body of the tag will be used. In
-this case, if nobody is present, the value "localhost" will be used.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connectionTimeout</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">This is an optional tag with a non-negative integer body. Connection timeout in seconds.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connectionLimit</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum simultaneous incoming connections for this service.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connectionLimitPerIP</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum simultaneous incoming connections per IP for this service.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">proxyRequired</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Enables proxy support for this service for incoming connections. HAProxy’s protocol
-(<a href="https://www.haproxy.org/download/2.7/doc/proxy-protocol.txt" class="bare">https://www.haproxy.org/download/2.7/doc/proxy-protocol.txt</a>) is used and might be compatible
-with other proxies (e.g. traefik). If enabled, it is <strong>required</strong> to initiate the connection
-using HAProxy’s proxy protocol.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">authRequired</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">(deprecated) use auth.announce instead.</p>
-<p class="tableblock">This is an optional tag with a boolean body. If true, then the server will
-announce authentication after HELO command. If this tag is absent, or the value
-is false then the client will not be prompted for authentication. Only simple user/password authentication is
-supported at this time. Supported values:</p>
-<p class="tableblock"> * true: announced only to not authorizedAddresses</p>
-<p class="tableblock"> * false: don’t announce AUTH. If absent, <strong>authorizedAddresses</strong> are set to a wildcard to accept all remote hosts.</p>
-<p class="tableblock"> * announce: like true, but always announce AUTH capability to clients</p>
-<p class="tableblock">Please note that emails are only relayed if, and only if, the user did authenticate, or is in an authorized network,
-regardless of this option.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">auth.announce</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">This is an optional tag. Possible values are:</p>
-<p class="tableblock">* never: Don’t announce auth.</p>
-<p class="tableblock">* always: always announce AUTH capability to clients.</p>
-<p class="tableblock">* forUnauthorizedAddresses: announced only to not authorizedAddresses</p>
-<p class="tableblock">Please note that emails are only relayed if, and only if, the user did authenticate, or is in an authorized network,
-regardless of this option.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">auth.requireSSL</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">This is an optional tag, defaults to true. If true, authentication is not advertised via capabilities on unencrypted
-channels.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">auth.plainAuthEnabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">This is an optional tag, defaults to true. If false, AUTH PLAIN and AUTH LOGIN will not be exposed. This setting
-can be used to enforce strong authentication mechanisms.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">auth.oidc.oidcConfigurationURL</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Provide OIDC url address for information to user. Only configure this when you want to authenticate SMTP server using a OIDC provider.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">auth.oidc.jwksURL</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Provide url to get OIDC’s JSON Web Key Set to validate user token. Only configure this when you want to authenticate SMTP server using a OIDC provider.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">auth.oidc.claim</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Claim string uses to identify user. E.g: "email_address". Only configure this when you want to authenticate SMTP server using a OIDC provider.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">auth.oidc.scope</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">An OAuth scope that is valid to access the service (RF: RFC7628). Only configure this when you want to authenticate SMTP server using a OIDC provider.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">auth.oidc.introspection.url</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. An OAuth introspection token URL will be called to validate the token (RF: RFC7662).
-Only configure this when you want to validate the revocation token by the OIDC provider.
-Note that James always verifies the signature of the token even whether this configuration is provided or not.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">auth.oidc.introspection.auth</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Provide Authorization in header request when introspecting token.
-Eg: <code>Basic xyz</code></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">auth.oidc.userinfo.url</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. An Userinfo URL will be called to validate the token (RF: OpenId.Core <a href="https://openid.net/specs/openid-connect-core-1_0.html" class="bare">https://openid.net/specs/openid-connect-core-1_0.html</a>).
-Only configure this when you want to validate the revocation token by the OIDC provider.
-Note that James always verifies the signature of the token even whether this configuration is provided or not.
-James will ignore check token by userInfo if the <code>auth.oidc.introspection.url</code> is already configured</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">authorizedAddresses</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Authorize specific addresses/networks.</p>
-<p class="tableblock">If you use SMTP AUTH, addresses that match those specified here will
-be permitted to relay without SMTP AUTH. If you do not use SMTP
-AUTH, and you specify addresses here, then only addresses that match
-those specified will be permitted to relay.</p>
-<p class="tableblock">Addresses may be specified as a IP address or domain name, with an
-optional netmask, e.g.,</p>
-<p class="tableblock">127.*, 127.0.0.0/8, 127.0.0.0/255.0.0.0, and localhost/8 are all the same</p>
-<p class="tableblock">See also the RemoteAddrNotInNetwork matcher in the transport processor.
-You would generally use one OR the other approach.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">verifyIdentity</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">This is an optional tag with a boolean body. This option can only be used
-if SMTP authentication is required. If the parameter is set to true then the sender address for the submitted message
-will be verified against the authenticated subject. Verify sender addresses, ensuring that
-the sender address matches the user who has authenticated.
-It will verify that the sender address matches the address of the user or one of its alias (from user or domain aliases).
-This prevents a user of your mail server from acting as someone else
-If unspecified, default value is true.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">maxmessagesize</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">This is an optional tag with a non-negative integer body. It specifies the maximum
-size, in kbytes, of any message that will be transmitted by this SMTP server. It is a service-wide, as opposed to
-a per user, limit. If the value is zero then there is no limit. If the tag isn’t specified, the service will
-default to an unlimited message size. Must be a positive integer, optionally with a unit: B, K, M, G.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">heloEhloEnforcement</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">This sets whether to enforce the use of HELO/EHLO salutation before a
-MAIL command is accepted. If unspecified, the value defaults to true.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">smtpGreeting</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">This sets the SMTPGreeting which will be used when connect to the smtpserver
-If none is specified a default is generated</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">handlerchain</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The configuration handler chain. See <a href="smtp-hooks.html" class="xref page">this page</a> for configuring out-of the
-box extra SMTP handlers and hooks.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">bossWorkerCount</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum count of boss threads. Boss threads are responsible for accepting incoming SMTP connections
-and initializing associated resources. Optional integer, by default, boss threads are not used and this responsibility is being dealt with
-by IO threads.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ioWorkerCount</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum count of IO threads. IO threads are responsible for receiving incoming SMTP messages and framing them
-(split line by line). IO threads also take care of compression and SSL encryption. Their tasks are short-lived and non-blocking.
-Optional integer, defaults to 2 times the count of CPUs.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">maxExecutorCount</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum count of worker threads. Worker threads takes care of potentially blocking tasks like executing SMTP commands.
-Optional integer, defaults to 16.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">disabledFeatures</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Extended SMTP features to hide in EHLO responses.</p></td>
-</tr>
-</tbody>
-</table>
-<div class="sect2">
-<h3 id="_oidc_setup"><a class="anchor" href="#_oidc_setup"></a>OIDC setup</h3>
-<div class="paragraph">
-<p>James SMTP support XOAUTH2 authentication mechanism which allow authenticating against a OIDC providers.
-Please configure <code>auth.oidc</code> part to use this.</p>
-</div>
-<div class="paragraph">
-<p>We do supply an <a href="https://github.com/apache/james-project/tree/master/examples/oidc">example</a> of such a setup.
-It uses the Keycloak OIDC provider, but usage of similar technologies is definitely doable.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_about_open_relays"><a class="anchor" href="#_about_open_relays"></a>About open relays</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Authenticated SMTP is a method of securing your SMTP server. With SMTP AUTH enabled senders who wish to
-relay mail through the SMTP server (that is, send mail that is eventually to be delivered to another SMTP
-server) must authenticate themselves to Apache James Server before sending their message. Mail that is to be delivered
-locally does not require authentication. This method ensures that spammers cannot use your SMTP server
-to send unauthorized mail, while still enabling users who may not have fixed IP addresses to send their
-messages.</p>
-</div>
-<div class="paragraph">
-<p>Mail servers that allow spammers to send unauthorized email are known as open relays. So SMTP AUTH
-is a mechanism for ensuring that your server is not an open relay.</p>
-</div>
-<div class="paragraph">
-<p>It is extremely important that your server not be configured as an open relay. Aside from potential
-costs associated with usage by spammers, connections from servers that are determined to be open relays
-are routinely rejected by SMTP servers. This can severely impede the ability of your mail server to
-send mail.</p>
-</div>
-<div class="paragraph">
-<p>At this time Apache James Server only supports simple user name / password authentication.</p>
-</div>
-<div class="paragraph">
-<p>As mentioned above, SMTP AUTH requires that Apache James Server be able to distinguish between mail intended
-for local delivery and mail intended for remote delivery. Apache James Server makes this determination by matching the
-domain to which the mail was sent against the <strong>DomainList</strong> component, configured by
-<a href="domainlist.html" class="xref page"><strong>domainlist.xml</strong></a>.</p>
-</div>
-<div class="paragraph">
-<p>The Distributed Server is configured out of the box so as to not serve as an open relay for spammers. This is done
-by relayed emails originate from a trusted source. This includes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Authenticated SMTP/JMAP users</p>
-</li>
-<li>
-<p>Mails generated by the server (eg: bounces)</p>
-</li>
-<li>
-<p>Mails originating from a trusted network as configured in <strong>smtpserver.xml</strong></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>If you wish to ensure that authenticated users can only send email from their own account, you may
-optionally set the verifyIdentity element of the smtpserver configuration block to "true".</p>
-</div>
-<div class="sect2">
-<h3 id="_verification"><a class="anchor" href="#_verification"></a>Verification</h3>
-<div class="paragraph">
-<p>Verify that you have not inadvertently configured your server as an open relay. This is most easily
-accomplished by using the service provided at <a href="https://mxtoolbox.com/diagnostic.aspx">mxtoolbox.com</a>. mxtoolbox.com will
-check your mail server and inform you if it is an open relay. This tool further more verifies additional properties like:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Your DNS configuration, especially that you mail server IP has a valid reverse DNS entry</p>
-</li>
-<li>
-<p>That your SMTP connection is secured</p>
-</li>
-<li>
-<p>That you are not an OpenRelay</p>
-</li>
-<li>
-<p>This website also allow a quick lookup to ensure your mail server is not in public blacklists.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Of course it is also necessary to confirm that users and log in and send
-mail through your server. This can be accomplished using any standard mail client (i.e. Thunderbird, Outlook,
-Eudora, Evolution).</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_lmtp_configuration"><a class="anchor" href="#_lmtp_configuration"></a>LMTP Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/lmtpserver.xml">example</a>
-to get some examples and hints.</p>
-</div>
-<div class="paragraph">
-<p>The configuration is the same of for SMTP.</p>
-</div>
-<div class="paragraph">
-<p>By default, it is deactivated. You can activate it alongside SMTP and bind for example on port 24.</p>
-</div>
-<div class="paragraph">
-<p>The default LMTP server stores directly emails in user mailboxes, without further treatment.</p>
-</div>
-<div class="paragraph">
-<p>However we do ship an alternative handler chain allowing to execute the mailet container, thus achieving a behaviour similar
-to the default SMTP protocol. Here is how to achieve this:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><lmtpservers>
- <lmtpserver enabled="true">
- <jmxName>lmtpserver</jmxName>
- <bind>0.0.0.0:24</bind>
- <connectionBacklog>200</connectionBacklog>
- <connectiontimeout>1200</connectiontimeout>
- <connectionLimit>0</connectionLimit>
- <connectionLimitPerIP>0</connectionLimitPerIP>
- <maxmessagesize>0</maxmessagesize>
- <handlerchain coreHandlersPackage="org.apache.james.lmtpserver.MailetContainerCmdHandlerLoader">
- <handler class="org.apache.james.lmtpserver.MailetContainerCmdHandlerLoader"/>
- </handlerchain>
- </lmtpserver>
-</lmtpservers></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note that by default the mailet container is executed with all recipients at once and do not allow per recipient
-error reporting. An option <code>splitExecution</code> allow to execute the mailet container for each recipient separately and mitigate this
-limitation at the cost of performance.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><lmtpservers>
- <lmtpserver enabled="true">
- <jmxName>lmtpserver</jmxName>
- <bind>0.0.0.0:24</bind>
- <connectionBacklog>200</connectionBacklog>
- <connectiontimeout>1200</connectiontimeout>
- <connectionLimit>0</connectionLimit>
- <connectionLimitPerIP>0</connectionLimitPerIP>
- <maxmessagesize>0</maxmessagesize>
- <handlerchain coreHandlersPackage="org.apache.james.lmtpserver.MailetContainerCmdHandlerLoader">
- <handler class="org.apache.james.lmtpserver.MailetContainerCmdHandlerLoader"/>
- <handler class="org.apache.james.lmtpserver.MailetContainerHandler">
- <splitExecution>true</splitExecution>
- </handler>
- </handlerchain>
- </lmtpserver>
-</lmtpservers></pre>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/configure/spam.html b/james-distributed-app/3.8.0/configure/spam.html
deleted file mode 100644
index fecc183..0000000
--- a/james-distributed-app/3.8.0/configure/spam.html
+++ /dev/null
@@ -1,677 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Anti-Spam configuration :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Extensions</li>
- <li><a href="spam.html">Anti-Spam setup</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/spam.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Anti-Spam configuration</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>Anti-Spam system can be configured via two main different mechanisms:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>SMTP Hooks;</p>
-</li>
-<li>
-<p>Mailets;</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_antispam_smtp_hooks"><a class="anchor" href="#_antispam_smtp_hooks"></a>AntiSpam SMTP Hooks</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>"FastFail" SMTP Hooks acts to reject before spooling
-on the SMTP level. The Spam detector hook can be used as a fastfail hook, therefore
-Spam filtering system must run as a server on the same machine as the Apache James Server.</p>
-</div>
-<div class="paragraph">
-<p>SMTP Hooks for non-existent users, DSN filter, domains with invalid MX record,
-can also be configured.</p>
-</div>
-<div class="paragraph">
-<p><strong>SpamAssassinHandler</strong> (experimental) also enables to classify the messages as spam or not
-with a configurable score threshold (<code>0.0</code>, non-configurable). Only a global database is supported. Per user spam
-detection is not supported by this hook.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_antispam_mailets"><a class="anchor" href="#_antispam_mailets"></a>AntiSpam Mailets</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>James' repository provide two AntiSpam mailets: SpamAssassin and RspamdScanner.
-We can select one in them for filtering spam mail.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>SpamAssassin and RspamdScanner</strong> Mailet is designed to classify the messages as spam or not
-with a configurable score threshold. Usually a message will only be
-considered as spam if it matches multiple criteria; matching just a single test
-will not usually be enough to reach the threshold. Note that this mailet is executed on a per-user basis.</p>
-</li>
-</ul>
-</div>
-<div class="sect2">
-<h3 id="_rspamd"><a class="anchor" href="#_rspamd"></a>Rspamd</h3>
-<div class="paragraph">
-<p>The Rspamd extension (optional) requires an extra configuration file <code>rspamd.properties</code> to configure RSpamd connection</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. rspamd.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">rSpamdUrl</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">URL defining the Rspamd’s server. Eg: <a href="http://rspamd:11334" class="bare">http://rspamd:11334</a></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">rSpamdPassword</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Password for pass authentication when request to Rspamd’s server. Eg: admin</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">rspamdTimeout</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Integer. Timeout for http requests to Rspamd. Default to 15 seconds.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">perUserBayes</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Boolean. Whether to scan/learn mails using per-user Bayes. Default to false.</p></td>
-</tr>
-</tbody>
-</table>
-<div class="paragraph">
-<p><code>RspamdScanner</code> supports the following options:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>You can specify the <code>virusProcessor</code> if you want to enable virus scanning for mail. Upon configurable <code>virusProcessor</code>
-you can specify how James process mail virus. We provide a sample Rspamd mailet and <code>virusProcessor</code> configuration:</p>
-</li>
-<li>
-<p>You can specify the <code>rejectSpamProcessor</code>. Emails marked as <code>rejected</code> by Rspamd will be redirected to this
-processor. This corresponds to emails with the highest spam score, thus delivering them to users as marked as spam
-might not even be desirable.</p>
-</li>
-<li>
-<p>The <code>rewriteSubject</code> option allows to rewritte subjects when asked by Rspamd.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This mailet can scan mails against per-user Bayes by configure <code>perUserBayes</code> in <code>rspamd.properties</code>. This is achieved
-through the use of Rspamd <code>Deliver-To</code> HTTP header. If true, Rspamd will be called for each recipient of the mail, which comes at a performance cost. If true, subjects are not rewritten.
-If true <code>virusProcessor</code> and <code>rejectSpamProcessor</code> are honnered per user, at the cost of email copies. Default to false.</p>
-</div>
-<div class="paragraph">
-<p>Here is an example of mailet pipeline conducting out RspamdScanner execution:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><processor state="local-delivery" enableJmx="true">
- <mailet match="All" class="org.apache.james.rspamd.RspamdScanner">
- <rewriteSubject>true</rewriteSubject>
- <virusProcessor>virus</virusProcessor>
- <rejectSpamProcessor>spam</rejectSpamProcessor>
- </mailet>
- <mailet match="IsMarkedAsSpam=org.apache.james.rspamd.status" class="WithStorageDirective">
- <targetFolderName>Spam</targetFolderName>
- </mailet>
- <mailet match="All" class="LocalDelivery"/>
-</processor>
-<!--Choose one between these two following virus processor, or configure a custom one if you want-->
-<!--Hard reject virus mail-->
-<processor state="virus" enableJmx="false">
- <mailet match="All" class="ToRepository">
- <repositoryPath>file://var/mail/virus/</repositoryPath>
- </mailet>
-</processor>
-<!--Soft reject virus mail-->
-<processor state="virus" enableJmx="false">
- <mailet match="All" class="StripAttachment">
- <remove>all</remove>
- <pattern>.*</pattern>
- </mailet>
- <mailet match="All" class="AddSubjectPrefix">
- <subjectPrefix>[VIRUS]</subjectPrefix>
- </mailet>
- <mailet match="All" class="LocalDelivery"/>
-</processor>
-<!--Store rejected spam emails (with a very high score) -->
-<processor state="virus" enableJmx="false">
- <mailet match="All" class="ToRepository">
- <repositoryPath>cassandra://var/mail/spam</repositoryPath>
- </mailet>
-</processor></pre>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_feedback_for_rspamd"><a class="anchor" href="#_feedback_for_rspamd"></a>Feedback for Rspamd</h4>
-<div class="paragraph">
-<p>If enabled, the <code>RspamdListener</code> will base on the Mailbox event to detect the message is a spam or not, then James will send report <code>spam</code> or <code>ham</code> to Rspamd.
-This listener can report mails to per-user Bayes by configure <code>perUserBayes</code> in <code>rspamd.properties</code>.
-The Rspamd listener needs to explicitly be registered with <a href="listeners.html" class="xref page">listeners.xml</a>.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><listeners>
- <listener>
- <class>org.apache.james.rspamd.RspamdListener</class>
- </listener>
-</listeners></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>For more detail about how to use Rspamd’s extension: <code>third-party/rspamd/index.md</code></p>
-</div>
-<div class="paragraph">
-<p>Alternatively, batch reports can be triggered on user mailbox content via webAdmin. <a href="https://github.com/apache/james-project/tree/master/third-party/rspamd#additional-webadmin-endpoints">Read more</a>.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_spamassassin"><a class="anchor" href="#_spamassassin"></a>SpamAssassin</h3>
-<div class="paragraph">
-<p>Here is an example of mailet pipeline conducting out SpamAssassin execution:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="SpamAssassin">
- <onMailetException>ignore</onMailetException>
- <spamdHost>spamassassin</spamdHost>
- <spamdPort>783</spamdPort>
-</mailet>
-<mailet match="All" class="MailAttributesToMimeHeaders">
- <!-- This mailet is not required, but useful to have SpamAssassin score in headers-->
- <simplemapping>org.apache.james.spamassassin.status; X-JAMES-SPAMASSASSIN-STATUS</simplemapping>
- <simplemapping>org.apache.james.spamassassin.flag; X-JAMES-SPAMASSASSIN-FLAG</simplemapping>
-</mailet>
-<mailet match="IsMarkedAsSpam" class="WithStorageDirective">
- <targetFolderName>Spam</targetFolderName>
-</mailet></pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>BayesianAnalysis</strong> (unsupported) in the Mailet uses Bayesian probability to classify mail as
-spam or not spam. It relies on the training data coming from the users’ judgment.
-Users need to manually judge as spam and send to <a href="mailto:spam@thisdomain.com">spam@thisdomain.com</a>, oppositely,
-if not spam they then send to <a href="mailto:not.spam@thisdomain.com">not.spam@thisdomain.com</a>. BayesianAnalysisfeeder learns
-from this training dataset, and build predictive models based on Bayesian probability.
-There will be a certain table for maintaining the frequency of Corpus for keywords
-in the database. Every 10 mins a thread in the BayesianAnalysis will check and update
-the table. Also, the correct approach is to send the original spam or non-spam
-as an attachment to another message sent to the feeder in order to avoid bias from the
-current sender’s email header.</p>
-</li>
-</ul>
-</div>
-<div class="sect3">
-<h4 id="_feedback_for_spamassassin"><a class="anchor" href="#_feedback_for_spamassassin"></a>Feedback for SpamAssassin</h4>
-<div class="paragraph">
-<p>If enabled, the <code>SpamAssassinListener</code> will asynchronously report users mails moved to the <code>Spam</code> mailbox as Spam,
-and other mails as <code>Ham</code>, effectively populating the user database for per user spam detection. This enables a per-user
-Spam categorization to be conducted out by the SpamAssassin mailet, the SpamAssassin hook being unaffected.</p>
-</div>
-<div class="paragraph">
-<p>The SpamAssassin listener requires an extra configuration file <code>spamassassin.properties</code> to configure SpamAssassin connection (optional):</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 2. spamassassin.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">spamassassin.host</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Hostname of the SpamAssassin server. Defaults to 127.0.0.1.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">spamassassin.port</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Port of the SpamAssassin server. Defaults to 783.</p></td>
-</tr>
-</tbody>
-</table>
-<div class="paragraph">
-<p>Note that this configuration file only affects the listener, and not the hook or mailet.</p>
-</div>
-<div class="paragraph">
-<p>The SpamAssassin listener needs to explicitly be registered with <a href="listeners.html" class="xref page">listeners.xml</a>.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><listeners>
- <listener>
- <class>org.apache.james.mailbox.spamassassin.SpamAssassinListener</class>
- <async>true</async>
- </listener>
-</listeners></pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/configure/ssl.html b/james-distributed-app/3.8.0/configure/ssl.html
deleted file mode 100644
index aa218a6..0000000
--- a/james-distributed-app/3.8.0/configure/ssl.html
+++ /dev/null
@@ -1,742 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — SSL & TLS configuration :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Protocols</li>
- <li><a href="ssl.html">SSL & TLS</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/ssl.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — SSL & TLS configuration</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This document explains how to enable James 3.0 servers to use Transport Layer Security (TLS)
-for encrypted client-server communication.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_configure_a_server_to_use_ssltls"><a class="anchor" href="#_configure_a_server_to_use_ssltls"></a>Configure a Server to Use SSL/TLS</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Each of the servers <a href="smtp.html" class="xref page">SMTP - LMTP</a>,
-<a href="pop3.html" class="xref page">POP3</a> and <a href="imap.html" class="xref page">IMAP</a>
-supports use of SSL/TLS.</p>
-</div>
-<div class="paragraph">
-<p>TLS (Transport Layer Security) and SSL (Secure Sockets Layer) are protocols that provide
-data encryption and authentication between applications in scenarios where that data is
-being sent across an insecure network, such as checking your email
-(How does the Secure Socket Layer work?). The terms SSL and TLS are often used
-interchangeably or in conjunction with each other (TLS/SSL),
-but one is in fact the predecessor of the other — SSL 3.0 served as the basis
-for TLS 1.0 which, as a result, is sometimes referred to as SSL 3.1.</p>
-</div>
-<div class="paragraph">
-<p>You need to add a block in the corresponding configuration file (smtpserver.xml, pop3server.xml, imapserver.xml,..)</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><tls socketTLS="false" startTLS="true">
- <keystore>file://conf/keystore</keystore>
- <keystoreType>PKCS12</keystoreType>
- <secret>yoursecret</secret>
- <provider>org.bouncycastle.jce.provider.BouncyCastleProvider</provider>
-</tls></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Alternatively TLS keys can be supplied via PEM files:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><tls socketTLS="true" startTLS="false">
- <privateKey>file://conf/private.key</privateKey>
- <certificates>file://conf/certs.self-signed.csr</certificates>
-</tls></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>An optional secret might be specified for the private key:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><tls socketTLS="true" startTLS="false">
- <privateKey>file://conf/private.key</privateKey>
- <certificates>file://conf/certs.self-signed.csr</certificates>
- <secret>yoursecret</secret>
-</tls></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Optionally, TLS protocols and/or cipher suites can be specified explicitly (smtpserver.xml, pop3server.xml, imapserver.xml,..).
-Otherwise, the default protocols and cipher suites of the used JDK will be used:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><tls socketTLS="true" startTLS="false">
- <supportedProtocols>
- <protocol>TLSv1.2</protocol>
- <protocol>TLSv1.1</protocol>
- <protocol>TLSv1</protocol>
- <protocol>SSLv3</protocol>
- </supportedProtocols>
- <supportedCipherSuites>
- <cipherSuite>TLS_AES_256_GCM_SHA384</cipherSuite>
- <cipherSuite>TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256</cipherSuite>
- </supportedCipherSuites>
-</tls></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Each of these block has an optional boolean configuration element <b>socketTLS</b> and <b>startTLS</b> which is used to toggle
-use of SSL or TLS for the service.</p>
-</div>
-<div class="paragraph">
-<p>With socketTLS (SSL/TLS in Thunderbird), all the communication is encrypted.</p>
-</div>
-<div class="paragraph">
-<p>With startTLS (STARTTLS in Thunderbird), the preamble is readable, but the rest is encrypted.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>* OK JAMES IMAP4rev1 Server Server 192.168.1.4 is ready.
-* CAPABILITY IMAP4rev1 LITERAL+ CHILDREN WITHIN STARTTLS IDLE NAMESPACE UIDPLUS UNSELECT AUTH=PLAIN
-1 OK CAPABILITY completed.
-2 OK STARTTLS Begin TLS negotiation now.
-... rest is encrypted...</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can only enable one of the both at the same time for a service.</p>
-</div>
-<div class="paragraph">
-<p>It is also recommended to change the port number on which the service will listen:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>POP3 - port 110, Secure POP3 - port 995</p>
-</li>
-<li>
-<p>IMAP - port 143, Secure IMAP4 - port 993</p>
-</li>
-<li>
-<p>SMTP - port 25, Secure SMTP - port 465</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>You will now need to create your certificate store and place it in the james/conf/ folder with the name you defined in the keystore tag.</p>
-</div>
-<div class="paragraph">
-<p>Please note <code>JKS</code> keystore format is also supported (default value if no keystore type is specified):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><tls socketTLS="false" startTLS="true">
- <keystore>file://conf/keystore</keystore>
- <keystoreType>JKS</keystoreType>
- <secret>yoursecret</secret>
- <provider>org.bouncycastle.jce.provider.BouncyCastleProvider</provider>
-</tls></pre>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_client_authentication_via_certificates"><a class="anchor" href="#_client_authentication_via_certificates"></a>Client authentication via certificates</h3>
-<div class="paragraph">
-<p>When you enable TLS, you may also configure the server to require a client certificate for authentication:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><tls socketTLS="false" startTLS="true">
- <keystore>file://conf/keystore</keystore>
- <keystoreType>JKS</keystoreType>
- <secret>yoursecret</secret>
-
- <clientAuth>
- <truststore>file://conf/truststore</truststore>
- <truststoreType>JKS</truststoreType>
- <truststoreSecret>yoursecret</truststoreSecret>
- <enableOCSPCRLChecks>false</enableOCSPCRLChecks>
- </clientAuth>
-</tls></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>James verifies client certificates against the provided truststore. You can fill it with trusted peer certificates directly, or an issuer certificate (CA) if you trust all certificates created by it. If you omit the truststore configuration, James will use the Java default truststore instead, effectively trusting any known CA.</p>
-</div>
-<div class="paragraph">
-<p>James can optionally enable OCSP verifications for client certificates against Certificate Revocation List referenced
-in the certificate itself.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_creating_your_own_pem_keys"><a class="anchor" href="#_creating_your_own_pem_keys"></a>Creating your own PEM keys</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The following commands can be used to create self signed PEM keys:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre># Generating your private key
-openssl genrsa -des3 -out private.key 2048
-
-# Creating your certificates
-openssl req -new -key private.key -out certs.csr
-
-# Signing the certificate yourself
-openssl x509 -req -days 365 -in certs.csr -signkey private.key -out certs.self-signed.csr
-
-# Removing the password from the private key
-# Not necessary if you supply the secret in the configuration
-openssl rsa -in private.key -out private.nopass.key</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You may then supply this TLS configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><tls socketTLS="true" startTLS="false">
- <privateKey>file://conf/private.nopass.key</privateKey>
- <certificates>file://conf/certs.self-signed.csr</certificates>
-</tls></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_certificate_keystores"><a class="anchor" href="#_certificate_keystores"></a>Certificate Keystores</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This section gives more indication for users relying on keystores.</p>
-</div>
-<div class="sect2">
-<h3 id="_creating_your_own_certificate_keystore"><a class="anchor" href="#_creating_your_own_certificate_keystore"></a>Creating your own Certificate Keystore</h3>
-<div class="paragraph">
-<p>(Adapted from the Tomcat 4.1 documentation)</p>
-</div>
-<div class="paragraph">
-<p>James currently operates only on JKS or PKCS12 format keystores. This is Java’s standard "Java KeyStore" format, and is
-the format created by the keytool command-line utility. This tool is included in the JDK.</p>
-</div>
-<div class="paragraph">
-<p>To import an existing certificate into a JKS keystore, please read the documentation (in your JDK documentation package)
-about keytool.</p>
-</div>
-<div class="paragraph">
-<p>To create a new keystore from scratch, containing a single self-signed Certificate, execute the following from a terminal
-command line:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>keytool -genkey -alias james -keyalg RSA -storetype PKCS12 -keystore your_keystore_filename</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>(The RSA algorithm should be preferred as a secure algorithm, and this also ensures general compatibility with other
-servers and components.)</p>
-</div>
-<div class="paragraph">
-<p>As a suggested standard, create the keystore in the james/conf directory, with a name like james.keystore.</p>
-</div>
-<div class="paragraph">
-<p>After executing this command, you will first be prompted for the keystore password.</p>
-</div>
-<div class="paragraph">
-<p>Next, you will be prompted for general information about this Certificate, such as company, contact name, and so on.
-This information may be displayed to users when importing into the certificate store of the client, so make sure that
-the information provided here matches what they will expect.</p>
-</div>
-<div class="paragraph">
-<p>Important: in the "distinguished name", set the "common name" (CN) to the DNS name of your James server, the one
-you will use to access it from your mail client (like "mail.xyz.com").</p>
-</div>
-<div class="paragraph">
-<p>Finally, you will be prompted for the key password, which is the password specifically for this Certificate
-(as opposed to any other Certificates stored in the same keystore file).</p>
-</div>
-<div class="paragraph">
-<p>If everything was successful, you now have a keystore file with a Certificate that can be used by your server.</p>
-</div>
-<div class="paragraph">
-<p>You MUST have only one certificate in the keystore file used by James.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_installing_a_certificate_provided_by_a_certificate_authority"><a class="anchor" href="#_installing_a_certificate_provided_by_a_certificate_authority"></a>Installing a Certificate provided by a Certificate Authority</h3>
-<div class="paragraph">
-<p>(Adapted from the Tomcat 4.1 documentation</p>
-</div>
-<div class="paragraph">
-<p>To obtain and install a Certificate from a Certificate Authority (like verisign.com, thawte.com or trustcenter.de)
-you should have read the previous section and then follow these instructions:</p>
-</div>
-<div class="sect3">
-<h4 id="_create_a_local_certificate_signing_request_csr"><a class="anchor" href="#_create_a_local_certificate_signing_request_csr"></a>Create a local Certificate Signing Request (CSR)</h4>
-<div class="paragraph">
-<p>In order to obtain a Certificate from the Certificate Authority of your choice you have to create a so called
-Certificate Signing Request (CSR). That CSR will be used by the Certificate Authority to create a Certificate
-that will identify your James server as "secure". To create a CSR follow these steps:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Create a local Certificate as described in the previous section.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The CSR is then created with:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> keytool -certreq -keyalg RSA -alias james -file certreq.csr -keystore your_keystore_filename</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Now you have a file called certreq.csr. The file is encoded in PEM format. You can submit it to the Certificate Authority
-(look at the documentation of the Certificate Authority website on how to do this). In return you get a Certificate.</p>
-</div>
-<div class="paragraph">
-<p>Now that you have your Certificate you can import it into you local keystore. First of all you may have to import a so
-called Chain Certificate or Root Certificate into your keystore (the major Certificate Authorities are already in place,
-so it’s unlikely that you will need to perform this step). After that you can procede with importing your Certificate.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_optionally_importing_a_so_called_chain_certificate_or_root_certificate"><a class="anchor" href="#_optionally_importing_a_so_called_chain_certificate_or_root_certificate"></a>Optionally Importing a so called Chain Certificate or Root Certificate</h4>
-<div class="paragraph">
-<p>Download a Chain Certificate from the Certificate Authority you obtained the Certificate from.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>For Verisign.com go to: <a href="http://www.verisign.com/support/install/intermediate.html" class="bare">http://www.verisign.com/support/install/intermediate.html</a></p>
-</li>
-<li>
-<p>For Trustcenter.de go to: <a href="http://www.trustcenter.de/certservices/cacerts/en/en.htm#server" class="bare">http://www.trustcenter.de/certservices/cacerts/en/en.htm#server</a></p>
-</li>
-<li>
-<p>For Thawte.com go to: <a href="http://www.thawte.com/certs/trustmap.html" class="bare">http://www.thawte.com/certs/trustmap.html</a> (seems no longer valid)</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_import_the_chain_certificate_into_you_keystore"><a class="anchor" href="#_import_the_chain_certificate_into_you_keystore"></a>Import the Chain Certificate into you keystore</h4>
-<div class="literalblock">
-<div class="content">
-<pre>keytool -import -alias root -keystore your_keystore_filename -trustcacerts -file filename_of_the_chain_certificate</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>And finally import your new Certificate (It must be in X509 format):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>keytool -import -alias james -keystore your_keystore_filename -trustcacerts -file your_certificate_filename</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>See also <a href="http://www.agentbob.info/agentbob/79.html">this page</a></p>
-</div>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/configure/tika.html b/james-distributed-app/3.8.0/configure/tika.html
deleted file mode 100644
index 08f8240..0000000
--- a/james-distributed-app/3.8.0/configure/tika.html
+++ /dev/null
@@ -1,472 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — tika.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Storage dependencies</li>
- <li><a href="tika.html">tika.properties</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/tika.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — tika.properties</h1>
-<div class="paragraph">
-<p>When using OpenSearch, you can configure an external Tika server for extracting and indexing text from attachments.
-Thus you can significantly improve user experience upon text searches.</p>
-</div>
-<div class="paragraph">
-<p>Note: You can launch a tika server using this command line:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>docker run --name tika linagora/docker-tikaserver:1.24</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Here are the different properties:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. tika.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tika.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Should Tika text extractor be used?
-If true, the TikaTextExtractor will be used behind a cache.
-If false, the DefaultTextExtractor will be used (naive implementation only supporting text).
-Defaults to false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tika.host</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">IP or domain name of your Tika server. The default value is 127.0.0.1</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tika.port</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Port of your tika server. The default value is 9998</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tika.timeoutInMillis</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Timeout when issuing request to the tika server. The default value is 3 seconds.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tika.cache.eviction.period</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A cache is used to avoid, when possible, query Tika multiple time for the same attachments.
-This entry determines how long after the last read an entry vanishes.
-Please note that units are supported (ms - millisecond, s - second, m - minute, h - hour, d - day). Default unit is seconds.
-Default value is <strong>1 day</strong></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tika.cache.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Should the cache be used? False by default</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tika.cache.weight.max</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Maximum weight of the cache.
-A value of <strong>0</strong> disables the cache
-Please note that units are supported (K for KB, M for MB, G for GB). Defaults is no units, so in bytes.
-Default value is <strong>100 MB</strong>.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tika.contentType.blacklist</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Blacklist of content type is known-to-be-failing with Tika. Specify the list with comma separator.</p></td>
-</tr>
-</tbody>
-</table>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/configure/usersrepository.html b/james-distributed-app/3.8.0/configure/usersrepository.html
deleted file mode 100644
index d44d96f..0000000
--- a/james-distributed-app/3.8.0/configure/usersrepository.html
+++ /dev/null
@@ -1,588 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — usersrepository.xml :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Core components</li>
- <li><a href="usersrepository.html">usersrepository.xml</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/usersrepository.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — usersrepository.xml</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>User repositories are required to store James user information and authentication data.</p>
-</div>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/usersrepository.xml">example</a>
-to get some examples and hints.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_the_user_data_model"><a class="anchor" href="#_the_user_data_model"></a>The user data model</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>A user has two attributes: username and password.</p>
-</div>
-<div class="paragraph">
-<p>A valid user should satisfy these criteria:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>username and password cannot be null or empty</p>
-</li>
-<li>
-<p>username should not be longer than 255 characters</p>
-</li>
-<li>
-<p>username can not contain '/'</p>
-</li>
-<li>
-<p>username can not contain multiple domain delimiter('@')</p>
-</li>
-<li>
-<p>A username can have only a local part when virtualHosting is disabled. E.g.'myUser'</p>
-</li>
-<li>
-<p>When virtualHosting is enabled, a username should have a domain part, and the domain part should be concatenated
-after a domain delimiter('@'). E.g. '<a href="mailto:myuser@james.org">myuser@james.org</a>'</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>A user is always considered as lower cased, so 'myUser' and 'myuser' are the same user, and can be used as well as
-recipient local part than as login for different protocols.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_configuration"><a class="anchor" href="#_configuration"></a>Configuration</h2>
-<div class="sectionbody">
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. usersrepository.xml content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">enableVirtualHosting</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false. Add domain support for users (default: false, except for Cassandra Users Repository)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">administratorId</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">user’s name. Allow a user to access to the <a href="https://tools.ietf.org/html/rfc4616#section-2">impersonation command</a>,
-acting on the behalf of any user.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">verifyFailureDelay</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Delay after a failed authentication attempt with an invalid user name or password. Duration string defaulting to seconds, e.g. <code>2</code>, <code>2s</code>, <code>2000ms</code>. Default <code>0s</code> (disabled).</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">algorithm</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">use a specific hash algorithm to compute passwords, with optional mode <code>plain</code> (default) or <code>salted</code>; e.g. <code>SHA-512</code>, <code>SHA-512/plain</code>, <code>SHA-512/salted</code>, <code>PBKDF2</code>, <code>PBKDF2-SHA512</code> (default).
-Note: When using <code>PBKDF2</code> or <code>PBKDF2-SHA512</code> one can specify the iteration count and the key size in bytes. You can specify it as part of the algorithm. EG: <code>PBKDF2-SHA512-2000-512</code> will use
-2000 iterations with a key size of 512 bytes.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">hashingMode</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">specify the hashing mode to use if there is none recorded in the database: <code>plain</code> (default) for newer installations or <code>legacy</code> for older ones</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_configuring_a_ldap"><a class="anchor" href="#_configuring_a_ldap"></a>Configuring a LDAP</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Alternatively you can authenticate your users against a LDAP server. You need to configure
-the properties for accessing your LDAP server in this file.</p>
-</div>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/usersrepository.xml">example</a>
-to get some examples and hints.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><usersrepository name="LocalUsers" class="org.apache.james.user.ldap.ReadOnlyUsersLDAPRepository" ldapHost="ldap://myldapserver:389"
- principal="uid=ldapUser,ou=system" credentials="password" userBase="ou=People,o=myorg.com,ou=system" userIdAttribute="uid">
- <enableVirtualHosting>true</enableVirtualHosting>
-</usersrepository></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>SSL can be enabled by using <code>ldaps</code> scheme. <code>trustAllCerts</code> option can be used to trust all LDAP client certificates
-(optional, defaults to false).</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><usersrepository name="LocalUsers" class="org.apache.james.user.ldap.ReadOnlyUsersLDAPRepository" ldapHost="ldaps://myldapserver:636"
- principal="uid=ldapUser,ou=system" credentials="password" userBase="ou=People,o=myorg.com,ou=system" userIdAttribute="uid"
- trustAllCerts="true">
- <enableVirtualHosting>true</enableVirtualHosting>
-</usersrepository></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Moreover, per domain base DN can be configured:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><usersrepository name="LocalUsers" class="org.apache.james.user.ldap.ReadOnlyUsersLDAPRepository" ldapHost="ldap://myldapserver:389"
- principal="uid=ldapUser,ou=system" credentials="password" userBase="ou=People,o=myorg.com,ou=system" userIdAttribute="uid"
- <enableVirtualHosting>true</enableVirtualHosting>
- <domains>
- <domain.tld>ou=People,o=other.com,ou=system</domain.tld>
- </domains>
-</usersrepository></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can connect to multiple LDAP servers for better availability by using <code>ldapHosts</code> option (fallback to <code>ldapHost</code> is supported) to specify the list of LDAP Server URL with the comma <code>,</code> delimiter. We do support different schemas for LDAP servers.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><usersrepository name="LocalUsers" class="org.apache.james.user.ldap.ReadOnlyUsersLDAPRepository" ldapHosts="ldap://ldapServer1:389,ldaps://ldapServer2:636"
- principal="uid=ldapUser,ou=system" credentials="password" userBase="ou=People,o=myorg.com,ou=system" userIdAttribute="uid" trustAllCerts="true">
- <enableVirtualHosting>true</enableVirtualHosting>
-</usersrepository></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>When VirtualHosting is on, you can enable local part as login username by configure the <code>resolveLocalPartAttribute</code>.
-This is the LDAP attribute that allows to retrieve the local part of users. Optional, default to empty, which disables login with local part as username.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><usersrepository name="LocalUsers" class="org.apache.james.user.ldap.ReadOnlyUsersLDAPRepository" ldapHosts="ldap://ldapServer1:389,ldaps://ldapServer2:636"
- principal="uid=ldapUser,ou=system" credentials="password" userBase="ou=People,o=myorg.com,ou=system" resolveLocalPartAttribute="uid" userIdAttribute="mail" trustAllCerts="true">
- <enableVirtualHosting>true</enableVirtualHosting>
-</usersrepository></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The "userListBase" configuration option is used to differentiate users that can login from those that are listed
- as regular users. This is useful for dis-activating users, for instance.</p>
-</div>
-<div class="paragraph">
-<p>A different values from "userBase" can be used for setting up virtual logins,
-for instance in conjunction with "resolveLocalPartAttribute". This can also be used to manage
-disactivated users (in "userListBase" but not in "userBase").</p>
-</div>
-<div class="paragraph">
-<p>Note that "userListBase" can not be specified on a per-domain-basis.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/configure/vault.html b/james-distributed-app/3.8.0/configure/vault.html
deleted file mode 100644
index fefdae0..0000000
--- a/james-distributed-app/3.8.0/configure/vault.html
+++ /dev/null
@@ -1,457 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — deletedMessageVault.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Extensions</li>
- <li><a href="vault.html">deletedMessageVault.properties</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/vault.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — deletedMessageVault.properties</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>Deleted Messages Vault is the component in charge of retaining messages before they are going to be deleted.
-Messages stored in the Deleted Messages Vault could be deleted after exceeding their retentionPeriod (explained below).
-It also supports to restore or export messages matching with defined criteria in
-<a href="../operate/webadmin.html#_deleted_messages_vault" class="xref page">WebAdmin deleted messages vault document</a> by using
-<a href="../operate/webadmin.html#_deleted_messages_vault" class="xref page">WebAdmin endpoints</a>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_deleted_messages_vault_configuration"><a class="anchor" href="#_deleted_messages_vault_configuration"></a>Deleted Messages Vault Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Once the vault is active, James will start moving deleted messages to it asynchronously.</p>
-</div>
-<div class="paragraph">
-<p>The Deleted Messages Vault also stores and manages deleted messages into a BlobStore. The BlobStore can be either
-based on an object storage or on Cassandra. For configuring the BlobStore the vault will use, you can look at
-<a href="blobstore.html" class="xref page"><strong>blobstore.properties</strong></a> BlobStore Configuration section.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_deletedmessagevault_properties"><a class="anchor" href="#_deletedmessagevault_properties"></a>deletedMessageVault.properties</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/deletedMessageVault.properties">example</a>
-to get some examples and hints.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. deletedMessageVault.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">retentionPeriod</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Deleted messages stored in the Deleted Messages Vault are expired after this period (default: 1 year). It can be expressed in <strong>y</strong> years, <strong>d</strong> days, <strong>h</strong> hours, …​</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">restoreLocation</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Messages restored from the Deleted Messages Vault are placed in a mailbox with this name (default: <code>Restored-Messages</code>). The mailbox will be created if it does not exist yet.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/configure/webadmin.html b/james-distributed-app/3.8.0/configure/webadmin.html
deleted file mode 100644
index 67571c4..0000000
--- a/james-distributed-app/3.8.0/configure/webadmin.html
+++ /dev/null
@@ -1,556 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — webadmin.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Protocols</li>
- <li><a href="webadmin.html">webadmin.properties</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/webadmin.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — webadmin.properties</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>The web administration supports for now the CRUD operations on the domains, the users, their mailboxes and their quotas,
-managing mail repositories, performing cassandra migrations, and much more, as described in the following sections.</p>
-</div>
-<div class="paragraph">
-<p><strong>WARNING</strong>: This API allows authentication only via the use of JWT. If not
-configured with JWT, an administrator should ensure an attacker can not
-use this API.</p>
-</div>
-<div class="paragraph">
-<p>By the way, some endpoints are not filtered by authentication. Those endpoints are not related to data stored in James,
-for example: Swagger documentation & James health checks.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_configuration"><a class="anchor" href="#_configuration"></a>Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/webadmin.properties">example</a>
-to get some examples and hints.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. webadmin.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Define if WebAdmin is launched (default: false)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">port</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Define WebAdmin’s port (default: 8080)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">host</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Define WebAdmin’s host (default: localhost, use 0.0.0.0 to listen on all addresses)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cors.enable</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Allow the Cross-origin resource sharing (default: false)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cors.origin</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Specify ths CORS origin (default: null)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jwt.enable</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Allow JSON Web Token as an authentication mechanism (default: false)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">https.enable</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Use https (default: false)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">https.keystore</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Specify a keystore file for https (default: null)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">https.password</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Specify the keystore password (default: null)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">https.trust.keystore</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Specify a truststore file for https (default: null)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">https.trust.password</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Specify the truststore password (default: null)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jwt.publickeypem.url</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. JWT tokens allow request to bypass authentication. Path to the JWT public key.
-Defaults to the <code>jwt.publickeypem.url</code> value of <code>jmap.properties</code> file if unspecified
-(legacy behaviour)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">extensions.routes</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">List of Routes specified as fully qualified class name that should be loaded in addition to your product routes list. Routes
-needs to be on the classpath or in the ./extensions-jars folder. Read mode about
-<a href="../extending/webadmin-routes.html" class="xref page">creating you own webadmin routes</a>.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">maxThreadCount</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Maximum threads used by the underlying Jetty server. Optional.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">minThreadCount</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Minimum threads used by the underlying Jetty server. Optional.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_generating_a_jwt_key_pair"><a class="anchor" href="#_generating_a_jwt_key_pair"></a>Generating a JWT key pair</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The Distributed server enforces the use of RSA-SHA-256.</p>
-</div>
-<div class="paragraph">
-<p>One can use OpenSSL to generate a JWT key pair :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre># private key
-openssl genrsa -out rs256-4096-private.rsa 4096
-# public key
-openssl rsa -in rs256-4096-private.rsa -pubout > rs256-4096-public.pem</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The private key can be used to generate JWT tokens, for instance
-using <a href="https://github.com/vandium-io/jwtgen">jwtgen</a>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>jwtgen -a RS256 -p rs256-4096-private.rsa 4096 -c "sub=bob@domain.tld" -c "admin=true" -e 3600 -V</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>This token can then be passed as <code>Bearer</code> of the <code>Authorization</code> header :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -H "Authorization: Bearer $token" -XGET http://127.0.0.1:8000/domains</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The public key can be referenced as <code>jwt.publickeypem.url</code> of the <code>jmap.properties</code> configuration file.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_reverse_proxy_set_up"><a class="anchor" href="#_reverse_proxy_set_up"></a>Reverse-proxy set up</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>WebAdmin adds the value of <code>X-Real-IP</code> header as part of the logging MDC.</p>
-</div>
-<div class="paragraph">
-<p>This allows for reverse proxies to cary other the IP address of the client down to the JMAP server for diagnostic purpose.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/extending/imap.html b/james-distributed-app/3.8.0/extending/imap.html
deleted file mode 100644
index 9c038b9..0000000
--- a/james-distributed-app/3.8.0/extending/imap.html
+++ /dev/null
@@ -1,471 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Custom IMAP processing :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Extending server behavior</a></li>
- <li><a href="imap.html">Custom IMAP processing</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/extending/imap.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Custom IMAP processing</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>James allows defining your own handler packages.</p>
-</div>
-<div class="paragraph">
-<p>An Imap package is a simple class that bundles IMAP processing components:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>public interface ImapPackage {
- Collection<ClassName> processors();
-
- Collection<ClassName> decoders();
-
- Collection<ClassName> encoders();
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Processors needs to be of class <code>AbstractProcessor</code>, decoders of class <code>AbstractImapCommandParser</code>
-and encoders of class <code>ImapResponseEncoder</code>. Extensions-jar mechanism can be used to load custom classes.</p>
-</div>
-<div class="paragraph">
-<p>Custom configuration can be obtained through <code>ImapConfiguration</code> class via the <code>getCustomProperties</code> method.</p>
-</div>
-<div class="paragraph">
-<p>A full working example is available <a href="https://github.com/apache/james-project/tree/master/examples/custom-imap">here</a>.</p>
-</div>
-<div class="paragraph">
-<p>See this page for <a href="../configure/imap.html#_extending_imap" class="xref page">more details on configuring IMAP extensions</a>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_imap_additional_connection_checks"><a class="anchor" href="#_imap_additional_connection_checks"></a>IMAP additional Connection Checks</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>James allows defining your own additional connection checks to guarantee that the connecting IP is secured.</p>
-</div>
-<div class="paragraph">
-<p>A custom connection check should implement the following functional interface:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">@FunctionalInterface
-public interface ConnectionCheck {
- Publisher<Void> validate(InetSocketAddress remoteAddress);
-}</code></pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>validate</code> method is used to check the connecting IP is secured.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Then the custom defined ConnectionCheck can be added in <code>imapserver.xml</code> file:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs"><additionalConnectionChecks>org.apache.james.CrowdsecImapConnectionCheck</additionalConnectionChecks></code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>An example for configuration is available <a href="https://github.com/apache/james-project/blob/master/third-party/crowdsec/sample-configuration/imapserver.xml">here</a>.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/extending/index.html b/james-distributed-app/3.8.0/extending/index.html
deleted file mode 100644
index c229cdf..0000000
--- a/james-distributed-app/3.8.0/extending/index.html
+++ /dev/null
@@ -1,673 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Extending server behavior :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item is-current-page" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Extending server behavior</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/extending/index.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Extending server behavior</h1>
-<div class="sect1">
-<h2 id="_available_extension_mechanisms"><a class="anchor" href="#_available_extension_mechanisms"></a>Available extension mechanisms</h2>
-<div class="sectionbody">
-<div class="imageblock">
-<div class="content">
-<img src="../_images/james-hexagons-extensions.png" alt="Extension mechanisms for the Distributed Server">
-</div>
-</div>
-<div class="paragraph">
-<p>The Distributed Server exposes several interfaces allowing the user to write custom extensions in
-order to extend the Distributed Server behavior.</p>
-</div>
-<div class="paragraph">
-<p>Writing <strong>Mailets</strong> and <strong>Matchers</strong> allows one to supply custom components for the
-<a href="mail-processing.html" class="xref page">Mail Processing</a> and
-enables to take decisions, and implement your business logic at the transport level.</p>
-</div>
-<div class="paragraph">
-<p>Writing <a href="mailbox-listeners.html" class="xref page">Mailbox listeners</a> enables to
-react to your user interaction with their mailbox. This powerful tool allows build advanced features
-for mail delivery servers.</p>
-</div>
-<div class="paragraph">
-<p>Writing <a href="smtp-hooks.html" class="xref page">SMTP hookd</a> enables to
-add features to your SMTP server.</p>
-</div>
-<div class="paragraph">
-<p>Writing <a href="webadmin-routes.html" class="xref page">WebAdmin routes</a> enables to
-add features to the WebAdmin REST API.</p>
-</div>
-<div class="paragraph">
-<p>Writing <a href="imap.html" class="xref page">IMAP extensions</a>.</p>
-</div>
-<div class="paragraph">
-<p>The <a href="https://github.com/apache/james-project/tree/master/examples">examples</a> are also a good reference.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_handling_injections_for_your_extensions"><a class="anchor" href="#_handling_injections_for_your_extensions"></a>Handling injections for your extensions</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_injecting_core_components"><a class="anchor" href="#_injecting_core_components"></a>Injecting core components</h3>
-<div class="paragraph">
-<p>You can very easily inject core components into your custom extensions.</p>
-</div>
-<div class="paragraph">
-<p>All you need is to pass them via a constructor annotated via <strong>@Inject</strong>.</p>
-</div>
-<div class="paragraph">
-<p>For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>public class MyMailet extends GenericMailet {
- private final UsersRepository usersRepository;
-
- @Inject
- public MyMailet(UsersRepository usersRepository) {
- this.usersRepository = usersRepository;
- }
-
- @Override
- public void service(Mail mail) throws MessagingException {
- // Do something
- }
-}</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_injecting_simple_extension_components"><a class="anchor" href="#_injecting_simple_extension_components"></a>Injecting simple extension components</h3>
-<div class="paragraph">
-<p>Furthermore, concrete implementation, that are part of your extension, can be injected as well.</p>
-</div>
-<div class="paragraph">
-<p>Consider the following example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>public class MyService {
-
-}
-
-public class MyMailet extends GenericMailet {
- private final MyService myService;
-
- @Inject
- public MyMailet(MyService myService) {
- this.usersRepository = myService;
- }
-
- @Override
- public void service(Mail mail) throws MessagingException {
- // Do something
- }
-}</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_defining_custom_injections_for_your_extensions"><a class="anchor" href="#_defining_custom_injections_for_your_extensions"></a>Defining custom injections for your extensions</h3>
-<div class="paragraph">
-<p>However, to inject an interface into your extension, you will need additional injection definitions.</p>
-</div>
-<div class="paragraph">
-<p>To so:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>1. Given an interface defined in an additional JAR:</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>public interface MyService {}</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>2. And an implementation of that interface, in another additional JAR:</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>public class MyServiceImpl extends MyService {}</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>3. We need to define a binding for MyService to be bound to MyServiceImpl</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>public class MyServiceModule extends AbstractModule {
- @Override
- protected void configure() {
- bind(MyServiceImpl.class).in(Scopes.SINGLETON);
- bind(MyService.class).to(MyServiceImpl.class);
- }
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Both <strong>MyService</strong>, <strong>MyServiceImpl</strong> and <strong>MyServiceModule</strong> needs to be in the <strong>extensions-jars</strong>
-folder (potentially different jars).</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>4. <strong>MyServiceModule</strong> needs to be registered in <a href="../configure/extensions.html" class="xref page"><strong>extensions.properties</strong></a></p>
-</li>
-<li>
-<p>5. <strong>MyService</strong> can then be used as part of your extensions</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>public class MyMailet extends GenericMailet {
- private final MyService myService;
-
- @Inject
- public MyMailet(MyService myService) {
- this.usersRepository = myService;
- }
-
- @Override
- public void service(Mail mail) throws MessagingException {
- // Do something
- }
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note that overriding injection definitions of the Distributed Server for your injections is not supported.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_starting_your_components"><a class="anchor" href="#_starting_your_components"></a>Starting your components</h3>
-<div class="paragraph">
-<p>Sometimes you wish to 'start' your extensions. This can be achieved through defining your own <code>UserDefinedStartable</code>:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">public class MyStartable implements UserDefinedStartable {
- @Override
- public void start() {
- // Will be called
- }
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Your startable then needs to be registered within <code>extensions.properties</code>:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">guice.extension.startable=com.company.MyStartable</code></pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_pre_packaged_extensions"><a class="anchor" href="#_pre_packaged_extensions"></a>Pre-packaged extensions</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_rate_limiting_for_mailet_processing"><a class="anchor" href="#_rate_limiting_for_mailet_processing"></a>Rate Limiting for mailet processing</h3>
-<div class="paragraph">
-<p><strong>Vendor</strong>: Apache Foundation (James project), Apache License V2</p>
-</div>
-<div class="paragraph">
-<p><a href="https://github.com/apache/james-project/tree/master/server/mailet/rate-limiter">Project link</a> contains detailed set
-up instructions and configuration examples as well as a pre-configured docker-compose.</p>
-</div>
-<div class="paragraph">
-<p>This extension ships mailets for applying advanced rate limit criteria to the email transiting through your James server.
-It is shipped with two backends implemented:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>in memory</strong>: For single server mode.</p>
-</li>
-<li>
-<p><strong>Redis</strong>: Uses <a href="https://redis.io/">Redis</a> as a shared, fast and scalable in-memory datastore, allowing to apply rate
-limiting in a distributed fashion. Here is the <a href="https://github.com/apache/james-project/tree/master/server/mailet/rate-limiter">link</a> to the Redis extension for rate limiting.</p>
-</li>
-<li>
-<p>Alternative extensions can be written and loaded into James using the <a href="#_handling_injections_for_your_extensions">Guice extension mechanism</a>
-and providing custom injections for the <code>RateLimiterFactoryProvider</code> class.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This extension ships the following mailets:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>PerSenderRateLimit</code> allows defining limits applied to the senders of emails (count of email, count of recipients,
-size, size * recipients)</p>
-</li>
-<li>
-<p><code>PerRecipientRateLimit</code> allows defining limits applied to the recipients of emails (count of email, size)</p>
-</li>
-<li>
-<p><code>GlobalRateLimit</code> allows defining limits applied to all the emails (count of email, count of recipients,
-size, size * recipients)</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Depending on their positions and the matcher they are being combined with, those rate limiting rules could be applied to
-submitted emails, received emails or emitted email being relayed to third parties.</p>
-</div>
-<div class="sect3">
-<h4 id="_throttling"><a class="anchor" href="#_throttling"></a>Throttling</h4>
-<div class="paragraph">
-<p>Can use combine with <code>Requeue</code> mailet for a throttler by re-enqueue mail.
-<a href="https://github.com/apache/james-project/tree/master/server/mailet/rate-limiter#throttling">link</a></p>
-</div>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/extending/mail-processing.html b/james-distributed-app/3.8.0/extending/mail-processing.html
deleted file mode 100644
index 7a31a62..0000000
--- a/james-distributed-app/3.8.0/extending/mail-processing.html
+++ /dev/null
@@ -1,591 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Custom mail processing components :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Extending server behavior</a></li>
- <li><a href="mail-processing.html">Custom mail processing components</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/extending/mail-processing.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Custom mail processing components</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>When none of the matchers and mailets available in James allows us to implement what we want, extension
-developers will have to write our own mailet and matcher in a separated maven project depending on James
-Mailet API.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_writing_custom_mailetsmatchers"><a class="anchor" href="#_writing_custom_mailetsmatchers"></a>Writing custom mailets/matchers</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>We will write a <strong>IsDelayedForMoreThan</strong> matcher with a configurable delay. If the Sent Date of incoming
-emails is older than specified delay, then the emails should be matched (return all mail recipients). Otherwise,
-we just return an empty list of recipients.</p>
-</div>
-<div class="paragraph">
-<p>To ease our Job, we can rely on the <strong>org.apache.james.apache-mailet-base</strong> maven project, which provides us
-a <strong>GenericMatcher</strong> that we can extend.</p>
-</div>
-<div class="paragraph">
-<p>Here is the dependency:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><dependency>
- <groupId>org.apache.james</groupId>
- <artifactId>apache-mailet-base</artifactId>
-</dependency></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The main method of a matcher is the <strong>match</strong> method:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>Collection<MailAddress> match(Mail mail) throws MessagingException;</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>For us, it becomes, with <strong>maxDelay</strong> being previously configured:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>private final Clock clock;
-private Duration maxDelay;
-
-@Override
-public Collection<MailAddress> match(Mail mail) throws MessagingException {
-Date sentDate = mail.getMessage().getSentDate();
-
- if (clock.instant().isAfter(sentDate.toInstant().plusMillis(maxDelay.toMillis()))) {
- return ImmutableList.copyOf(mail.getRecipients());
- }
- return ImmutableList.of();
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>GenericMatcher</strong> exposes us the condition that had been configured. We will use it to compute <strong>maxDelay</strong>.
-We can do it in the <strong>init()</strong> method exposed by the generic matcher:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>public static final TimeConverter.Unit DEFAULT_UNIT = TimeConverter.Unit.HOURS;
-
-@Override
-public void init() {
- String condition = getCondition();
- maxDelay = Duration.ofMillis(TimeConverter.getMilliSeconds(condition, DEFAULT_UNIT));
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Now, let’s take a look at the <strong>SendPromotionCode</strong> mailet. Of course, we want to write a generic mailet
-with a configurable reason (why are we sending the promotion code). To keep things simple, only one promotion
-code will be used, and will be written in the configuration. We can here also simply extend the
-<strong>GenericMailet</strong> helper class.</p>
-</div>
-<div class="paragraph">
-<p>The main method of a mailet is the <strong>service</strong> method:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>void service(Mail mail) throws MessagingException;</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>For us, it becomes, with <strong>reason</strong> and <strong>promotionCode</strong> being previously configured:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>public static final boolean REPLY_TO_SENDER_ONLY = false;
-
-private String reason;
-private String promotionCode;
-
-@Override
-public void service(Mail mail) throws MessagingException {
-MimeMessage response = (MimeMessage) mail.getMessage()
-.reply(REPLY_TO_SENDER_ONLY);
-
- response.setText(reason + "\n\n" +
- "Here is the following promotion code that you can use on your next order: " + promotionCode);
-
- MailAddress sender = getMailetContext().getPostmaster();
- ImmutableList<MailAddress> recipients = ImmutableList.of(mail.getSender());
-
- getMailetContext()
- .sendMail(sender, recipients, response);
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note that we can interact with the mail server through the mailet context for sending mails, knowing postmaster, etc…​</p>
-</div>
-<div class="paragraph">
-<p><strong>GenericMailet</strong> exposes us the 'init parameters' that had been configured for this mailet. We will
-use it to retrieve <strong>reason</strong> and <strong>promotionCode</strong>.
-We can do it in the <strong>init()</strong> method exposed by the generic mailet:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>@Override
-public void init() throws MessagingException {
- reason = getInitParameter("reason");
- promotionCode = getInitParameter("promotionCode");
-
- if (Strings.isNullOrEmpty(reason)) {
- throw new MessagingException("'reason' is compulsory");
- }
- if (Strings.isNullOrEmpty(promotionCode)) {
- throw new MessagingException("'promotionCode' is compulsory");
- }
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can retrieve the sources of this mini-project on <a href="https://github.com/apache/james-project/tree/master/examples/custom-mailets">GitHub</a></p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_loading_custom_mailets_with_james"><a class="anchor" href="#_loading_custom_mailets_with_james"></a>Loading custom mailets with James</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Now is the time we will run James with our awesome matcher and mailet configured.</p>
-</div>
-<div class="paragraph">
-<p>First, we will need to compile our project with <strong>mvn clean install</strong>. A jar will be outputted in the target directory.</p>
-</div>
-<div class="paragraph">
-<p>Then, we will write the <strong>mailetcontainer.xml</strong> file expressing the logic we want:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailetcontainer enableJmx="true">
-
-<context>
- <postmaster>postmaster@localhost</postmaster>
-</context>
-
-<spooler>
- <threads>20</threads>
-</spooler>
-
-<processors>
- <processor state="root" enableJmx="true">
- <mailet match="All" class="PostmasterAlias"/>
- <mailet match="org.apache.james.examples.custom.mailets.IsDelayedForMoreThan=1 day"
- class="org.apache.james.examples.custom.mailets.SendPromotionCode">
- <reason>Your email had been delayed for a long time. Because we are sorry about it, please find the
- following promotion code.</reason>
- <promotionCode>1542-2563-5469</promotionCode>
- </mailet>
- <!-- Rest of the configuration -->
-</processor>
-
-<!-- Other processors -->
-</processors>
-</mailetcontainer></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Finally, we will start a James server using that. We will rely on docker default image for simplicity.
-We need to be using the <strong>mailetcontainer.xml</strong> configuration that we had been writing and position
-the jar in the <strong>extensions-jars</strong> folder (specific to guice).</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/extending/mailbox-listeners.html b/james-distributed-app/3.8.0/extending/mailbox-listeners.html
deleted file mode 100644
index 9491312..0000000
--- a/james-distributed-app/3.8.0/extending/mailbox-listeners.html
+++ /dev/null
@@ -1,501 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Custom Mailbox Listeners :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Extending server behavior</a></li>
- <li><a href="mailbox-listeners.html">Custom Mailbox Listeners</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/extending/mailbox-listeners.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Custom Mailbox Listeners</h1>
-<div class="sect1">
-<h2 id="_writing_additional_listener"><a class="anchor" href="#_writing_additional_listener"></a>Writing additional listener</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>An extension writer can write new additional mailbox listeners.</p>
-</div>
-<div class="paragraph">
-<p>To do so, extend the <strong>GroupMailboxListener</strong> defined in the <strong>mailbox-api</strong>.</p>
-</div>
-<div class="paragraph">
-<p>Here is the dependency:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><dependency>
- <groupId>org.apache.james</groupId>
- <artifactId>apache-james-mailbox-api</artifactId>
-</dependency></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Here are the methods you can implement:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> void event(Event event) throws Exception;</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>allows you to specify the business logic you want to execute upon new events generation.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> boolean isHandling(Event event);</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Allows to know if this event is worth execution, and should be sent on the EventBus. This avoids execution of non
-handled events and can save some IOs.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_registration_of_custom_additional_listeners"><a class="anchor" href="#_registration_of_custom_additional_listeners"></a>Registration of custom additional listeners</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Your custom additional listener needs to be in the <strong>extensions-jars</strong> folder.</p>
-</div>
-<div class="paragraph">
-<p>You need to register its fully qualified class name in <a href="../configure/listeners.html" class="xref page">listeners.xml</a></p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_events"><a class="anchor" href="#_events"></a>Events</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Your listener will be called for the following events:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>MailboxAdded</strong>: A new mailbox had been created</p>
-</li>
-<li>
-<p><strong>MailboxDeletion</strong>: A new mailbox had been deleted</p>
-</li>
-<li>
-<p><strong>MailboxRenamed</strong>: A mailbox was renamed</p>
-</li>
-<li>
-<p><strong>MailboxACLUpdated</strong>: The rights of a mailbox had been changed</p>
-</li>
-<li>
-<p><strong>Expunged</strong>: Some messages had been deleted</p>
-</li>
-<li>
-<p><strong>FlagsUpdated</strong>: Some message flags had been updated</p>
-</li>
-<li>
-<p><strong>Added</strong>: New messages had been added to a mailbox</p>
-</li>
-<li>
-<p><strong>QuotaUsageUpdatedEvent</strong>: The quota of a given account had changed</p>
-</li>
-<li>
-<p><strong>MessageMoveEvent</strong>: A message was moved between mailboxes. This carries an account wide information. Spoecific
-mailboxes event (Added & Expunged) will be emitted as well.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_example"><a class="anchor" href="#_example"></a>Example</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p><a href="http://james.apache.org/howTo/custom-listeners.html">This page</a> provides a working example for writing additional custom mailbox listeners.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/extending/smtp-hooks.html b/james-distributed-app/3.8.0/extending/smtp-hooks.html
deleted file mode 100644
index 2580e27..0000000
--- a/james-distributed-app/3.8.0/extending/smtp-hooks.html
+++ /dev/null
@@ -1,524 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Custom SMTP hooks :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Extending server behavior</a></li>
- <li><a href="smtp-hooks.html">Custom SMTP hooks</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/extending/smtp-hooks.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Custom SMTP hooks</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>SMTP hooks enable extending capabilities of the SMTP server and are run synchronously upon email reception, before the email is
-enqueued in the MailQueue, and before any mail processing takes place.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_available_generic_hooks"><a class="anchor" href="#_available_generic_hooks"></a>Available generic hooks</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The following interfaces allows interacting with the following commands:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>AuthHook</strong>: Implement this interfaces to hook in the AUTH Command.</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> HookResult doAuth(SMTPSession session, Username username, String password);</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>HeloHook</strong>: Implement this interfaces to hook in the HELO Command</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> HookResult doHelo(SMTPSession session, String helo);</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>MailHook</strong>: Implement this interfaces to hook in the MAIL Command</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> HookResult doMail(SMTPSession session, MaybeSender sender);</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>MailParametersHook</strong>: Implement this interfaces to hook in the MAIL Command, this is called for specific mail arguments</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> HookResult doMailParameter(SMTPSession session, String paramName, String paramValue);</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>QuitHook</strong>: Implement this interfaces to hook in the QUIT Command</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> HookResult doQuit(SMTPSession session);</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>RcptHook</strong>: Implement this interfaces to hook in the RCPT Command</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> HookResult doRcpt(SMTPSession session, MaybeSender sender, MailAddress rcpt);</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>UnknownHook</strong>: Hook for unknown commands</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> HookResult doUnknown(SMTPSession session, String command);</pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_custom_hook_registration"><a class="anchor" href="#_custom_hook_registration"></a>Custom hook registration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Register you hooks using <a href="../configure/smtp.html" class="xref page"><strong>smtpserver.xml</strong></a> handlerchain property.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_writing_additional_smtp_commands"><a class="anchor" href="#_writing_additional_smtp_commands"></a>Writing additional SMTP commands</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>What to do if the Hook API is not enough for you ?</p>
-</div>
-<div class="paragraph">
-<p>You want for example to write a code which handles a new command like "YOURCOOLCOMMAND: whatever@example".</p>
-</div>
-<div class="paragraph">
-<p>For this kind of needs you should implement the CommandHandler interface. This gives you a lower-level API
-to handle this kind of tasks. If you want to support a custom Hook in your CommandHandler its the best to
-just extend AbstractHookableCmdHandler.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/extending/webadmin-routes.html b/james-distributed-app/3.8.0/extending/webadmin-routes.html
deleted file mode 100644
index 52df608..0000000
--- a/james-distributed-app/3.8.0/extending/webadmin-routes.html
+++ /dev/null
@@ -1,457 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Custom WebAdmin routes :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Extending server behavior</a></li>
- <li><a href="webadmin-routes.html">Custom WebAdmin routes</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/extending/webadmin-routes.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Custom WebAdmin routes</h1>
-<div class="sect1">
-<h2 id="_writing_custom_webadmin_routes"><a class="anchor" href="#_writing_custom_webadmin_routes"></a>Writing custom WebAdmin routes</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>An extension writer can write additional WebAdmin routes, effectively exposed over the WebAdmin API.</p>
-</div>
-<div class="paragraph">
-<p>To do so, extend the <strong>Routes</strong> defined in the <strong>james-server-webadmin-core</strong>.</p>
-</div>
-<div class="paragraph">
-<p>Here is the dependency:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><dependency>
- <groupId>org.apache.james</groupId>
- <artifactId>james-server-webadmin-core</artifactId>
-</dependency></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Here is the interface:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>public interface Routes {
- String getBasePath();
-
- void define(Service service);
-}</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>getBasePath</strong> enables to know the prefix of your route</p>
-</li>
-<li>
-<p><strong>define</strong> enables you to register endpoint is the <a href="http://sparkjava.com/">sparkjava</a> Service instance. HTTP <strong>GET</strong>, <strong>POST</strong>,
-<strong>PUT</strong>, <strong>PATCH</strong>, etc.. verbs are supported.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_registration"><a class="anchor" href="#_registration"></a>Registration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Your custom WebAdmin routes needs to be in the <strong>extensions-jars</strong> folder.</p>
-</div>
-<div class="paragraph">
-<p>You need to register its fully qualified class name in <a href="../configure/webadmin.html" class="xref page">webadmin.properties</a>
-using the <strong>extensions.routes</strong> property.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/index.html b/james-distributed-app/3.8.0/index.html
deleted file mode 100644
index 4c98274..0000000
--- a/james-distributed-app/3.8.0/index.html
+++ /dev/null
@@ -1,451 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>James Distributed Mail Server :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="index.html">Apache James Distributed Server</a></li>
- <li><a href="index.html">Distributed James Application</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/index.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">James Distributed Mail Server</h1>
-<div class="paragraph">
-<p>The Distributed server offers an easy way to scale email server. Based on
-noSQL solutions, it is intended to be easy to operate for large
-deployments, without needing sharding and protocol aware load balancing.</p>
-</div>
-<div class="paragraph">
-<p>The Distributed Server does assume that you have advanced
-technical knowledge and is the most complex and feature-rich option.</p>
-</div>
-<div class="paragraph">
-<p>This server is:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Intended for use by experts only</p>
-</li>
-<li>
-<p>Used for large-scale distributed deployments</p>
-</li>
-<li>
-<p>Is designed for Mail Delivery use cases but can also carry out mail processing</p>
-</li>
-<li>
-<p>The most feature-rich server, but also by far the most complex</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>In this section of the documentation, we will introduce you to:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="objectives.html" class="xref page">Objectives and motivation of the Distributed Server</a></p>
-</li>
-<li>
-<p><a href="architecture/index.html" class="xref page">Overview of architecture</a></p>
-</li>
-<li>
-<p><a href="run/index.html" class="xref page">Run the Distributed Server</a></p>
-</li>
-<li>
-<p><a href="configure/index.html" class="xref page">Configure the Distributed Server</a></p>
-</li>
-<li>
-<p><a href="operate/index.html" class="xref page">Operation of the Distributed Server</a></p>
-</li>
-<li>
-<p><a href="extending/index.html" class="xref page">How to extend the server</a></p>
-</li>
-</ul>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../_/js/site.js" data-ui-root-path="../../_"></script>
-<script async src="../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/objectives.html b/james-distributed-app/3.8.0/objectives.html
deleted file mode 100644
index 7c35516..0000000
--- a/james-distributed-app/3.8.0/objectives.html
+++ /dev/null
@@ -1,461 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Objectives and motivation :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="2">
- <a class="nav-link" href="objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="index.html">Apache James Distributed Server</a></li>
- <li><a href="index.html">Distributed James Application</a></li>
- <li><a href="objectives.html">Objectives and motivation</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/objectives.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Objectives and motivation</h1>
-<div class="paragraph">
-<p>The objective of the Distributed Server is to provided facilities to execute
-an advanced, extendable, and distributed email system. It is intended for
-organization with serious requirements, such as high-throughput or very large
-data sets.</p>
-</div>
-<div class="paragraph">
-<p>Scaling emails infrastructure is a notoriously hard problem. The intent of the Distributed server is
-to implement a mail server using modern NoSQL technologies. It relies on:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Object Storage enables scalable yet cheap storage of large amount of data</p>
-</li>
-<li>
-<p>The use of NoSQL for metadata storage enables vertical scalability</p>
-</li>
-<li>
-<p>Finally a Distributed search engine enables quick and efficient search</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Replication, data availability are thus handled by battle tested technologies.</p>
-</div>
-<div class="paragraph">
-<p>Such a data storage strategy enables:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>A centralized management of all server components, as each Distributed James server hold the same view on data.</p>
-</li>
-<li>
-<p>A better load and data repartition between email servers, as each James servers can cary out any tasks.</p>
-</li>
-<li>
-<p>Easy scaling. Handling more users or more data is as easy as adding James instances and scaling the underlying
-databases.</p>
-</li>
-<li>
-<p>Easier load-balancing, as any email server can handle requests from any user. No sharding is involved.</p>
-</li>
-<li>
-<p>Rich feature, especially regarding <strong>sharing</strong>. Every user can delegate access to any over users.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Furthermore, this server is intended to be easily customisable so that it can easily be adapted to ones needs.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Several packaged extensions can be <a href="configure/index.html#_for_extensions" class="xref page">configured</a></p>
-</li>
-<li>
-<p>It is easy to write and load <a href="extending/index.html" class="xref page">your own extensions</a></p>
-</li>
-</ul>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../_/js/site.js" data-ui-root-path="../../_"></script>
-<script async src="../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/operate/cassandra-migration.html b/james-distributed-app/3.8.0/operate/cassandra-migration.html
deleted file mode 100644
index e972c02..0000000
--- a/james-distributed-app/3.8.0/operate/cassandra-migration.html
+++ /dev/null
@@ -1,436 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Cassandra migration :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Operate</a></li>
- <li><a href="cassandra-migration.html">Cassandra migration</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/operate/cassandra-migration.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Cassandra migration</h1>
-<div class="paragraph">
-<p>Cassandra upgrades implies the creation of a new table. Thus restarting James is needed, as new tables are created on restart.</p>
-</div>
-<div class="paragraph">
-<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>
-</div>
-<div class="paragraph">
-<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>
-</div>
-<div class="paragraph">
-<p>These schema updates can be triggered by <a href="webadmin.html#_cassandra_schema_upgrades" class="xref page">webadmin</a>.</p>
-</div>
-<div class="paragraph">
-<p>Note that currently the progress can be tracked by logs.</p>
-</div>
-<div class="paragraph">
-<p>Here are the implemented migrations:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>From V8 to V9</strong> : Adopt a more compact representation for message properties.</p>
-</li>
-<li>
-<p><strong>From V9 to V10</strong> : Handles Mailbox ACL transactionality with event-sourcing. We got read of SERIAL consistency upon
-reads thus unlocking a major performance enhancement.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The <a href="guide.html#_updating_cassandra_schema_version" class="xref page">Operator guide</a> further details the migration process.</p>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/operate/cli.html b/james-distributed-app/3.8.0/operate/cli.html
deleted file mode 100644
index 8ed5e2f..0000000
--- a/james-distributed-app/3.8.0/operate/cli.html
+++ /dev/null
@@ -1,887 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Command Line Interface :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Operate</a></li>
- <li><a href="cli.html">Command Line Interface</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/operate/cli.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Command Line Interface</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>The distributed server is packed with a command line client.</p>
-</div>
-<div class="paragraph">
-<p>To run this command line client simply execute:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>java -jar /root/james-cli.jar -h 127.0.0.1 -p 9999 COMMAND</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The following document will explain you which are the available options
-for <strong>COMMAND</strong>.</p>
-</div>
-<div class="paragraph">
-<p>Note: the above command line before <strong>COMMAND</strong> will be documented as <em>{cli}</em>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_manage_domains"><a class="anchor" href="#_manage_domains"></a>Manage Domains</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Domains represent the domain names handled by your server.</p>
-</div>
-<div class="paragraph">
-<p>You can add a domain:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} AddDomain domain.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can remove a domain:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} RemoveDomain domain.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>(Note: associated users are not removed automatically)</p>
-</div>
-<div class="paragraph">
-<p>Check if a domain is handled:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} ContainsDomain domain.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>And list your domains:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} ListDomains</pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_managing_users"><a class="anchor" href="#_managing_users"></a>Managing users</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Note: the following commands are explained with virtual hosting turned
-on.</p>
-</div>
-<div class="paragraph">
-<p>Users are accounts on the mail server. James can maintain mailboxes for
-them.</p>
-</div>
-<div class="paragraph">
-<p>You can add a user:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} AddUser user@domain.tld password</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note: the domain used should have been previously created.</p>
-</div>
-<div class="paragraph">
-<p>You can delete a user:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} RemoveUser user@domain.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>(Note: associated mailboxes are not removed automatically)</p>
-</div>
-<div class="paragraph">
-<p>And change a user password:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} SetPassword user@domain.tld password</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note: All these write operations can not be performed on LDAP backend,
-as the implementation is read-only.</p>
-</div>
-<div class="paragraph">
-<p>Finally, you can list users:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} ListUsers</pre>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_virtual_hosting"><a class="anchor" href="#_virtual_hosting"></a>Virtual hosting</h3>
-<div class="paragraph">
-<p>James supports virtualhosting.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>If set to true in the configuration, then the username is the full
-mail address.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The domains then become a part of the user.</p>
-</div>
-<div class="paragraph">
-<p><em>usera@domaina.com and</em> <em>usera@domainb.com</em> on a mail server with
-<em>domaina.com</em> and <em>domainb.com</em> configured are mail addresses that
-belongs to different users.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>If set to false in the configurations, then the username is the mail
-address local part.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>It means that a user is automatically created for all the domains
-configured on your server.</p>
-</div>
-<div class="paragraph">
-<p><em>usera@domaina.com and</em> <em>usera@domainb.com</em> on a mail server with
-<em>domaina.com</em> and <em>domainb.com</em> configured are mail addresses that
-belongs to the same users.</p>
-</div>
-<div class="paragraph">
-<p>Here are some sample commands for managing users when virtual hosting is
-turned off:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} AddUser user password
-{cli} RemoveUser user
-{cli} SetPassword user password</pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_managing_mailboxes"><a class="anchor" href="#_managing_mailboxes"></a>Managing mailboxes</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>An administrator can perform some basic operation on user mailboxes.</p>
-</div>
-<div class="paragraph">
-<p>Note on mailbox formatting: mailboxes are composed of three parts.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>The namespace, indicating what kind of mailbox it is. (Shared or
-not?). The value for users mailboxes is #private . Note that for now no
-other values are supported as James do not support shared mailboxes.</p>
-</li>
-<li>
-<p>The username as stated above, depending on the virtual hosting value.</p>
-</li>
-<li>
-<p>And finally mailbox name. Be aware that `.' serves as mailbox
-hierarchy delimiter.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<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>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} DeleteUserMailboxes user@domain.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>He can delete a specific mailbox:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} DeleteMailbox #private user@domain.tld INBOX.toBeDeleted</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>He can list the mailboxes of a specific user:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} ListUserMailboxes user@domain.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>And finally can create a specific mailbox:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} CreateMailbox #private user@domain.tld INBOX.newFolder</pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_adding_a_message_in_a_mailbox"><a class="anchor" href="#_adding_a_message_in_a_mailbox"></a>Adding a message in a mailbox</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The administrator can use the CLI to add a message in a mailbox. this
-can be done using:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} ImportEml #private user@domain.tld INBOX.newFolder /full/path/to/file.eml</pre>
-</div>
-</div>
-<div class="paragraph">
-<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 href="mailto:user@domain.tld">user@domain.tld</a>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_managing_mappings"><a class="anchor" href="#_managing_mappings"></a>Managing mappings</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>A mapping is a recipient rewriting rule. There is several kind of
-rewriting rules:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>address mapping: rewrite a given mail address into an other one.</p>
-</li>
-<li>
-<p>regex mapping.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>You can manage address mapping like (redirects email from
-<a href="mailto:fromUser@fromDomain.tld">fromUser@fromDomain.tld</a> to <a href="mailto:redirected@domain.new">redirected@domain.new</a>, then deletes the
-mapping):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} AddAddressMapping fromUser fromDomain.tld redirected@domain.new
-{cli} RemoveAddressMapping fromUser fromDomain.tld redirected@domain.new</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can manage regex mapping like this:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} AddRegexMapping redirected domain.new .*@domain.tld
-{cli} RemoveRegexMapping redirected domain.new .*@domain.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can view mapping for a mail address:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} ListUserDomainMappings user domain.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>And all mappings defined on the server:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} ListMappings</pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_manage_quotas"><a class="anchor" href="#_manage_quotas"></a>Manage quotas</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Quotas are limitations on a group of mailboxes. They can limit the
-<strong>size</strong> or the <strong>messages count</strong> in a group of mailboxes.</p>
-</div>
-<div class="paragraph">
-<p>James groups by defaults mailboxes by user (but it can be overridden),
-and labels each group with a quotaroot.</p>
-</div>
-<div class="paragraph">
-<p>To get the quotaroot a given mailbox belongs to:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} GetQuotaroot #private user@domain.tld INBOX</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Then you can get the specific quotaroot limitations.</p>
-</div>
-<div class="paragraph">
-<p>For the number of messages:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} GetMessageCountQuota quotaroot</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>And for the storage space available:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} GetStorageQuota quotaroot</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You see the maximum allowed for these values:</p>
-</div>
-<div class="paragraph">
-<p>For the number of messages:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} GetMaxMessageCountQuota quotaroot</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>And for the storage space available:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} GetMaxStorageQuota quotaroot</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can also specify maximum for these values.</p>
-</div>
-<div class="paragraph">
-<p>For the number of messages:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} SetMaxMessageCountQuota quotaroot value</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>And for the storage space available:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} SetMaxStorageQuota quotaroot value</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>With value being an integer. Please note the use of units for storage
-(K, M, G). For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} SetMaxStorageQuota someone@apache.org 4G</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Moreover, James allows to specify global maximum values, at the server
-level. Note: syntax is similar to what was exposed previously.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} SetGlobalMaxMessageCountQuota value
-{cli} GetGlobalMaxMessageCountQuota
-{cli} SetGlobalMaxStorageQuota value
-{cli} GetGlobalMaxStorageQuota</pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_re_indexing"><a class="anchor" href="#_re_indexing"></a>Re-indexing</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>James allow you to index your emails in a search engine, for making
-search faster.</p>
-</div>
-<div class="paragraph">
-<p>For some reasons, you might want to re-index your mails (inconsistencies
-across datastore, migrations).</p>
-</div>
-<div class="paragraph">
-<p>To re-index all mails of all mailboxes of all users, type:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} ReindexAll</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>And for a specific mailbox:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} Reindex #private user@domain.tld INBOX</pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_sieve_scripts_quota"><a class="anchor" href="#_sieve_scripts_quota"></a>Sieve scripts quota</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>James implements Sieve (RFC-5228). Your users can then write 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>
-</div>
-<div class="paragraph">
-<p>You can define quota for the total size of Sieve scripts, per user.</p>
-</div>
-<div class="paragraph">
-<p>Syntax is similar to what was exposed for quotas. For defaults values:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} GetSieveQuota
-{cli} SetSieveQuota value
-{cli} RemoveSieveQuota</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>And for specific user quotas:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} GetSieveUserQuota user@domain.tld
-{cli} SetSieveQuota user@domain.tld value
-{cli} RemoveSieveUserQuota user@domain.tld</pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_switching_of_mailbox_implementation"><a class="anchor" href="#_switching_of_mailbox_implementation"></a>Switching of mailbox implementation</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Migration is experimental for now. You would need to customize <strong>Spring</strong>
-configuration to add a new mailbox manager with a different bean name.</p>
-</div>
-<div class="paragraph">
-<p>You can then copy data across mailbox managers using:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} CopyMailbox srcBean dstBean</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You will then need to reconfigure James to use the new mailbox manager.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/operate/guide.html b/james-distributed-app/3.8.0/operate/guide.html
deleted file mode 100644
index 60a5090..0000000
--- a/james-distributed-app/3.8.0/operate/guide.html
+++ /dev/null
@@ -1,1267 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Operator guide :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Operate</a></li>
- <li><a href="guide.html">Operator guide</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/operate/guide.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Operator guide</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This guide aims to be an entry-point to the James documentation for user
-managing a distributed Guice James server.</p>
-</div>
-<div class="paragraph">
-<p>It includes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Simple architecture explanations</p>
-</li>
-<li>
-<p>Propose some diagnostics for some common issues</p>
-</li>
-<li>
-<p>Present procedures that can be set up to address these issues</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>In order to not duplicate information, existing documentation will be
-linked.</p>
-</div>
-<div class="paragraph">
-<p>Please note that this product is under active development, should be
-considered experimental and thus targets advanced users.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_basic_monitoring"><a class="anchor" href="#_basic_monitoring"></a>Basic Monitoring</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>A toolbox is available to help an administrator diagnose issues:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="logging.html" class="xref page">Structured logging into Kibana</a></p>
-</li>
-<li>
-<p><a href="metrics.html" class="xref page">Metrics graphs into Grafana</a></p>
-</li>
-<li>
-<p><a href="webadmin.html#_healthcheck" class="xref page">WebAdmin HealthChecks</a></p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_mail_processing"><a class="anchor" href="#_mail_processing"></a>Mail processing</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Currently, an administrator can monitor mail processing failure through <code>ERROR</code> log
-review. We also recommend watching in Kibana INFO logs using the
-<code>org.apache.james.transport.mailets.ToProcessor</code> value as their <code>logger</code>. Metrics about
-mail repository size, and the corresponding Grafana boards are yet to be contributed.</p>
-</div>
-<div class="paragraph">
-<p>Furthermore, given the default mailet container configuration, we recommend monitoring
-<code>cassandra://var/mail/error/</code> to be empty.</p>
-</div>
-<div class="paragraph">
-<p>WebAdmin exposes all utilities for
-<a href="webadmin.html#_reprocessing_mails_from_a_mail_repository" class="xref page">reprocessing
-all mails in a mail repository</a> or
-<a href="webadmin.html#_reprocessing_a_specific_mail_from_a_mail_repository" class="xref page">reprocessing
-a single mail in a mail repository</a>.</p>
-</div>
-<div class="paragraph">
-<p>In order to prevent unbounded processing that could consume unbounded resources. We can provide a CRON with <code>limit</code> parameter.
-Ex: 10 reprocessed per minute
-Note that it only support the reprocessing all mails.</p>
-</div>
-<div class="paragraph">
-<p>Also, one can decide to
-<a href="webadmin.html#_removing_all_mails_from_a_mail_repository" class="xref page">delete
-all the mails of a mail repository</a> or
-<a href="webadmin.html#_removing_a_mail_from_a_mail_repository" class="xref page">delete
-a single mail of a mail repository</a>.</p>
-</div>
-<div class="paragraph">
-<p>Performance of mail processing can be monitored via the
-<a href="https://github.com/apache/james-project/blob/d2cf7c8e229d9ed30125871b3de5af3cb1553649/server/grafana-reporting/es-datasource/MAILET-1490071694187-dashboard.json">mailet
-grafana board</a> and
-<a href="https://github.com/apache/james-project/blob/d2cf7c8e229d9ed30125871b3de5af3cb1553649/server/grafana-reporting/es-datasource/MATCHER-1490071813409-dashboard.json">matcher
-grafana board</a>.</p>
-</div>
-<div class="sect2">
-<h3 id="_recipient_rewriting"><a class="anchor" href="#_recipient_rewriting"></a>Recipient rewriting</h3>
-<div class="paragraph">
-<p>Given the default configuration, errors (like loops) uopn recipient rewritting will lead
-to emails being stored in <code>cassandra://var/mail/rrt-error/</code>.</p>
-</div>
-<div class="paragraph">
-<p>We recommend monitoring the content of this mail repository to be empty.</p>
-</div>
-<div class="paragraph">
-<p>If it is not empty, we recommend
-verifying user mappings via <a href="webadmin.html#<em>listing_user_mappings</em>" class="xref page">User Mappings webadmin API</a> then once identified break the loop by removing
-some Recipient Rewrite Table entry via the
-<a href="webadmin.html#_removing_an_alias_of_an_user" class="xref page">Delete Alias</a>,
-<a href="webadmin.html#_removing_a_group_member" class="xref page">Delete Group member</a>,
-<a href="webadmin.html#_removing_a_destination_of_a_forward" class="xref page">Delete forward</a>,
-<a href="webadmin.html#_remove_an_address_mapping" class="xref page">Delete Address mapping</a>,
-<a href="webadmin.html#_removing_a_domain_mapping" class="xref page">Delete Domain mapping</a>
-or <a href="webadmin.html#_removing_a_regex_mapping" class="xref page">Delete Regex mapping</a>
-APIs (as needed).</p>
-</div>
-<div class="paragraph">
-<p>The <code>Mail.error</code> field can help diagnose the issue as well. Then once
-the root cause has been addressed, the mail can be reprocessed.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_mailbox_event_bus"><a class="anchor" href="#_mailbox_event_bus"></a>Mailbox Event Bus</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>It is possible for the administrator of James to define the mailbox
-listeners he wants to use, by adding them in the
-<a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/listeners.xml">listeners.xml</a>
-configuration file. It’s possible also to add your own custom mailbox
-listeners. This enables to enhance capabilities of James as a Mail
-Delivery Agent. You can get more information about those
-<a href="config-listeners.html">here</a>.</p>
-</div>
-<div class="paragraph">
-<p>Currently, an administrator can monitor listeners failures through
-<code>ERROR</code> log review. Metrics regarding mailbox listeners can be monitored
-via
-<a href="https://github.com/apache/james-project/blob/d2cf7c8e229d9ed30125871b3de5af3cb1553649/server/grafana-reporting/es-datasource/MailboxListeners-1528958667486-dashboard.json">mailbox_listeners
-grafana board</a> and
-<a href="https://github.com/apache/james-project/blob/d2cf7c8e229d9ed30125871b3de5af3cb1553649/server/grafana-reporting/es-datasource/MailboxListeners%20rate-1552903378376.json">mailbox_listeners_rate
-grafana board</a>.</p>
-</div>
-<div class="paragraph">
-<p>Upon exceptions, a bounded number of retries are performed (with
-exponential backoff delays). If after those retries the listener is
-still failing to perform its operation, then the event will be stored in
-the <a href="webadmin.html#_event_dead_letter" class="xref page">Event Dead Letter</a>. This
-API allows diagnosing issues, as well as redelivering the events.</p>
-</div>
-<div class="paragraph">
-<p>To check that you have undelivered events in your system, you can first
-run the associated with
-<a href="webadmin.html#_healthcheck" class="xref page">event dead letter health check</a> .
-You can explore Event DeadLetter content through WebAdmin. For
-this, <a href="webadmin.html#_listing_mailbox_listener_groups" class="xref page">list mailbox listener groups</a>
-you will get a list of groups back, allowing
-you to check if those contain registered events in each by
-<a href="webadmin.html#_listing_failed_events" class="xref page">listing their failed events</a>.</p>
-</div>
-<div class="paragraph">
-<p>If you get failed events IDs back, you can as well
-<a href="webadmin.html#_getting_event_details" class="xref page">check their details</a>.</p>
-</div>
-<div class="paragraph">
-<p>An easy way to solve this is just to trigger then the
-<a href="webadmin.html#_redeliver_all_events" class="xref page">redeliver all events</a>
-task. It will start reprocessing all the failed events registered in
-event dead letters.</p>
-</div>
-<div class="paragraph">
-<p>In order to prevent unbounded processing that could consume unbounded resources. We can provide a CRON with <code>limit</code> parameter.
-Ex: 10 redelivery per minute</p>
-</div>
-<div class="paragraph">
-<p>If for some other reason you don’t need to redeliver all events, you
-have more fine-grained operations allowing you to
-<a href="webadmin.html#_redeliver_group_events" class="xref page">redeliver group events</a>
-or even just
-<a href="webadmin.html#_redeliver_a_single_event" class="xref page">redeliver a single event</a>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_opensearch_indexing"><a class="anchor" href="#_opensearch_indexing"></a>OpenSearch Indexing</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>A projection of messages is maintained in OpenSearch via a listener
-plugged into the mailbox event bus in order to enable search features.</p>
-</div>
-<div class="paragraph">
-<p>You can find more information about OpenSearch configuration
-<a href="config-opensearch.html">here</a>.</p>
-</div>
-<div class="sect2">
-<h3 id="_usual_troubleshooting_procedures"><a class="anchor" href="#_usual_troubleshooting_procedures"></a>Usual troubleshooting procedures</h3>
-<div class="paragraph">
-<p>As explained in the <a href="#_mailbox_event_bus">Mailbox Event Bus</a> section,
-processing those events can fail sometimes.</p>
-</div>
-<div class="paragraph">
-<p>Currently, an administrator can monitor indexation failures through
-<code>ERROR</code> log review. You can as well
-<a href="webadmin.html#_listing_failed_events" class="xref page">list failed events</a> by
-looking with the group called
-<code>org.apache.james.mailbox.opensearch.events.OpenSearchListeningMessageSearchIndex$OpenSearchListeningMessageSearchIndexGroup</code>.
-A first on-the-fly solution could be to just
-<a href="#_mailbox_event_bus">redeliver those group events with event dead letter</a>.</p>
-</div>
-<div class="paragraph">
-<p>If the event storage in dead-letters fails (for instance in the face of
-Cassandra storage exceptions), then you might need to use our WebAdmin
-reIndexing tasks.</p>
-</div>
-<div class="paragraph">
-<p>From there, you have multiple choices. You can
-<a href="webadmin.html#_reindexing_all_mails" class="xref page">reIndex all mails</a>,
-<a href="webadmin.html#_reindexing_a_mailbox_mails" class="xref page">reIndex mails from a mailbox</a> or even just
-<a href="webadmin.html#_reindexing_a_single_mail_by_messageid" class="xref page">reIndex a single mail</a>.</p>
-</div>
-<div class="paragraph">
-<p>When checking the result of a reIndexing task, you might have failed
-reprocessed mails. You can still use the task ID to
-<a href="webadmin.html#_fixing_previously_failed_reindexing" class="xref page">reprocess previously failed reIndexing mails</a>.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_on_the_fly_opensearch_index_setting_update"><a class="anchor" href="#_on_the_fly_opensearch_index_setting_update"></a>On the fly OpenSearch Index setting update</h3>
-<div class="paragraph">
-<p>Sometimes you might need to update index settings. Cases when an
-administrator might want to update index settings include:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Scaling out: increasing the shard count might be needed.</p>
-</li>
-<li>
-<p>Changing string analysers, for instance to target another language</p>
-</li>
-<li>
-<p>etc.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>In order to achieve such a procedure, you need to:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://www.elastic.co/guide/en/elasticsearch/reference/7.10/indices-create-index.html">Create
-the new index</a> with the right settings and mapping</p>
-</li>
-<li>
-<p>James uses two aliases on the mailbox index: one for reading
-(<code>mailboxReadAlias</code>) and one for writing (<code>mailboxWriteAlias</code>). First
-<a href="https://www.elastic.co/guide/en/elasticsearch/reference/7.10/indices-aliases.html">add
-an alias</a> <code>mailboxWriteAlias</code> to that new index, so that now James
-writes on the old and new indexes, while only keeping reading on the
-first one</p>
-</li>
-<li>
-<p>Now trigger a
-<a href="https://www.elastic.co/guide/en/elasticsearch/reference/7.10/docs-reindex.html">reindex</a>
-from the old index to the new one (this actively relies on <code>_source</code>
-field being present)</p>
-</li>
-<li>
-<p>When this is done, add the <code>mailboxReadAlias</code> alias to the new index</p>
-</li>
-<li>
-<p>Now that the migration to the new index is done, you can
-<a href="https://www.elastic.co/guide/en/elasticsearch/reference/7.10/indices-delete-index.html">drop
-the old index</a></p>
-</li>
-<li>
-<p>You might want as well modify the James configuration file
-<a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/opensearch.properties">elasticsearch.properties</a>
-by setting the parameter <code>opensearch.index.mailbox.name</code> to the name
-of your new index. This is to avoid that James re-creates index upon
-restart</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p><em>Note</em>: keep in mind that reindexing can be a very long operation
-depending on the volume of mails you have stored.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_solving_cassandra_inconsistencies"><a class="anchor" href="#_solving_cassandra_inconsistencies"></a>Solving cassandra inconsistencies</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Cassandra backend uses data duplication to workaround Cassandra query
-limitations. However, Cassandra is not doing transaction when writing in
-several tables, this can lead to consistency issues for a given piece of
-data. The consequence could be that the data is in a transient state
-(that should never appear outside of the system).</p>
-</div>
-<div class="paragraph">
-<p>Because of the lack of transactions, it’s hard to prevent these kind of
-issues. We had developed some features to fix some existing cassandra
-inconsistency issues that had been reported to James.</p>
-</div>
-<div class="sect2">
-<h3 id="_jmap_message_fast_view_projections"><a class="anchor" href="#_jmap_message_fast_view_projections"></a>Jmap message fast view projections</h3>
-<div class="paragraph">
-<p>When you read a Jmap message, some calculated properties are expected to
-be fast to retrieve, like <code>preview</code>, <code>hasAttachment</code>. James achieves it
-by pre-calculating and storing them into a caching table
-(<code>message_fast_view_projection</code>). Missing caches are populated on
-message reads and will temporarily decrease the performance.</p>
-</div>
-<div class="sect3">
-<h4 id="_how_to_detect_the_outdated_projections"><a class="anchor" href="#_how_to_detect_the_outdated_projections"></a>How to detect the outdated projections</h4>
-<div class="paragraph">
-<p>You can watch the <code>MessageFastViewProjection</code> health check at
-<a href="webadmin.html#_check_all_components" class="xref page">webadmin documentation</a>.
-It provides a check based on the ratio of missed projection reads.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_how_to_solve"><a class="anchor" href="#_how_to_solve"></a>How to solve</h4>
-<div class="paragraph">
-<p>Since the MessageFastViewProjection is self healing, you should be
-concerned only if the health check still returns <code>degraded</code> for a while,
-there’s a possible thing you can do is looking at James logs for more
-clues.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_mailboxes"><a class="anchor" href="#_mailboxes"></a>Mailboxes</h3>
-<div class="paragraph">
-<p><code>mailboxPath</code> and <code>mailbox</code> tables share common fields like <code>mailboxId</code>
-and mailbox <code>name</code>. A successful operation of creating/renaming/delete
-mailboxes has to succeed at updating <code>mailboxPath</code> and <code>mailbox</code> table.
-Any failure on creating/updating/delete records in <code>mailboxPath</code> or
-<code>mailbox</code> can produce inconsistencies.</p>
-</div>
-<div class="sect3">
-<h4 id="_how_to_detect_the_inconsistencies"><a class="anchor" href="#_how_to_detect_the_inconsistencies"></a>How to detect the inconsistencies</h4>
-<div class="paragraph">
-<p>If you found the suspicious <code>MailboxNotFoundException</code> in your logs.
-Currently, there’s no dedicated tool for that, we recommend scheduling
-the SolveInconsistencies task below for the mailbox object on a regular
-basis, avoiding peak traffic in order to address both inconsistencies
-diagnostic and fixes.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_how_to_solve_2"><a class="anchor" href="#_how_to_solve_2"></a>How to solve</h4>
-<div class="paragraph">
-<p>An admin can run offline webadmin
-<a href="webadmin.html#_fixing_mailboxes_inconsistencies" class="xref page">solve Cassandra mailbox object inconsistencies task</a>
-in order to sanitize his
-mailbox denormalization.</p>
-</div>
-<div class="paragraph">
-<p>In order to ensure being offline, stop the traffic on SMTP, JMAP and
-IMAP ports, for example via re-configuration or firewall rules.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_mailboxes_counters"><a class="anchor" href="#_mailboxes_counters"></a>Mailboxes Counters</h3>
-<div class="paragraph">
-<p>James maintains a per mailbox projection for message count and unseen
-message count. Failures during the denormalization process will lead to
-incorrect results being returned.</p>
-</div>
-<div class="sect3">
-<h4 id="_how_to_detect_the_inconsistencies_2"><a class="anchor" href="#_how_to_detect_the_inconsistencies_2"></a>How to detect the inconsistencies</h4>
-<div class="paragraph">
-<p>Incorrect message count/message unseen count could be seen in the
-<code>Mail User Agent</code> (IMAP or JMAP). Invalid values are reported in the
-logs as warning with the following class
-<code>org.apache.james.mailbox.model.MailboxCounters</code> and the following
-message prefix: <code>Invalid mailbox counters</code>.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_how_to_solve_3"><a class="anchor" href="#_how_to_solve_3"></a>How to solve</h4>
-<div class="paragraph">
-<p>Execute the
-<a href="webadmin.html#_recomputing_mailbox_counters" class="xref page">recompute Mailbox counters task</a>.
-This task is not concurrent-safe. Concurrent
-increments & decrements will be ignored during a single mailbox
-processing. Re-running this task may eventually return the correct
-result.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_messages"><a class="anchor" href="#_messages"></a>Messages</h3>
-<div class="paragraph">
-<p>Messages are denormalized and stored in both <code>imapUidTable</code> (source of
-truth) and <code>messageIdTable</code>. Failure in the denormalization process will
-cause inconsistencies between the two tables.</p>
-</div>
-<div class="sect3">
-<h4 id="_how_to_detect_the_inconsistencies_3"><a class="anchor" href="#_how_to_detect_the_inconsistencies_3"></a>How to detect the inconsistencies</h4>
-<div class="paragraph">
-<p>User can see a message in JMAP but not in IMAP, or mark a message as
-`SEEN' in JMAP but the message flag is still unchanged in IMAP.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_how_to_solve_4"><a class="anchor" href="#_how_to_solve_4"></a>How to solve</h4>
-<div class="paragraph">
-<p>Execute the
-<a href="webadmin.html#_fixing_message_inconsistencies" class="xref page">solve Cassandra message inconsistencies task</a>. This task is not
-concurrent-safe. User actions concurrent to the inconsistency fixing
-task could result in new inconsistencies being created. However the
-source of truth <code>imapUidTable</code> will not be affected and thus re-running
-this task may eventually fix all issues.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_quotas"><a class="anchor" href="#_quotas"></a>Quotas</h3>
-<div class="paragraph">
-<p>User can monitor the amount of space and message count he is allowed to
-use, and that he is effectively using. James relies on an event bus and
-Cassandra to track the quota of an user. Upon Cassandra failure, this
-value can be incorrect.</p>
-</div>
-<div class="sect3">
-<h4 id="_how_to_detect_the_inconsistencies_4"><a class="anchor" href="#_how_to_detect_the_inconsistencies_4"></a>How to detect the inconsistencies</h4>
-<div class="paragraph">
-<p>Incorrect quotas could be seen in the <code>Mail User Agent</code> (IMAP or JMAP).</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_how_to_solve_5"><a class="anchor" href="#_how_to_solve_5"></a>How to solve</h4>
-<div class="paragraph">
-<p>Execute the
-<a href="webadmin.html#_recomputing_current_quotas_for_users" class="xref page">recompute Quotas counters task</a>. This task is not concurrent-safe. Concurrent
-operations will result in an invalid quota to be persisted. Re-running
-this task may eventually return the correct result.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_rrt_recipientrewritetable_mapping_sources"><a class="anchor" href="#_rrt_recipientrewritetable_mapping_sources"></a>RRT (RecipientRewriteTable) mapping sources</h3>
-<div class="paragraph">
-<p><code>rrt</code> and <code>mappings_sources</code> tables store information about address
-mappings. The source of truth is <code>rrt</code> and <code>mappings_sources</code> is the
-projection table containing all mapping sources.</p>
-</div>
-<div class="sect3">
-<h4 id="_how_to_detect_the_inconsistencies_5"><a class="anchor" href="#_how_to_detect_the_inconsistencies_5"></a>How to detect the inconsistencies</h4>
-<div class="paragraph">
-<p>Right now there’s no tool for detecting that, we’re proposing a
-<a href="https://issues.apache.org/jira/browse/JAMES-3069">development plan</a>. By
-the mean time, the recommendation is to execute the
-<code>SolveInconsistencies</code> task below in a regular basis.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_how_to_solve_6"><a class="anchor" href="#_how_to_solve_6"></a>How to solve</h4>
-<div class="paragraph">
-<p>Execute the Cassandra mapping <code>SolveInconsistencies</code> task described in
-<a href="webadmin.html#_operations_on_mappings_sources" class="xref page">webadmin documentation</a></p>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_setting_cassandra_user_permissions"><a class="anchor" href="#_setting_cassandra_user_permissions"></a>Setting Cassandra user permissions</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>When a Cassandra cluster is serving more than a James cluster, the
-keyspaces need isolation. It can be achieved by configuring James server
-with credentials preventing access or modification of other keyspaces.</p>
-</div>
-<div class="paragraph">
-<p>We recommend you to not use the initial admin user of Cassandra and
-provide a different one with a subset of permissions for each
-application.</p>
-</div>
-<div class="sect2">
-<h3 id="_prerequisites"><a class="anchor" href="#_prerequisites"></a>Prerequisites</h3>
-<div class="paragraph">
-<p>We’re gonna use the Cassandra super users to create roles and grant
-permissions for them. To do that, Cassandra requires you to login via
-username/password authentication and enable granting in cassandra
-configuration file.</p>
-</div>
-<div class="paragraph">
-<p>For example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>echo -e "\nauthenticator: PasswordAuthenticator" >> /etc/cassandra/cassandra.yaml
-echo -e "\nauthorizer: org.apache.cassandra.auth.CassandraAuthorizer" >> /etc/cassandra/cassandra.yaml</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_prepare_cassandra_roles_keyspaces_for_james"><a class="anchor" href="#_prepare_cassandra_roles_keyspaces_for_james"></a>Prepare Cassandra roles & keyspaces for James</h3>
-<div class="sect3">
-<h4 id="_create_a_role"><a class="anchor" href="#_create_a_role"></a>Create a role</h4>
-<div class="paragraph">
-<p>Have a look at
-<a href="http://cassandra.apache.org/doc/3.11.11/cql/security.html">cassandra documentation</a> section <code>CREATE ROLE</code> for more information</p>
-</div>
-<div class="paragraph">
-<p>E.g.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>CREATE ROLE james_one WITH PASSWORD = 'james_one' AND LOGIN = true;</pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_create_a_keyspace"><a class="anchor" href="#_create_a_keyspace"></a>Create a keyspace</h4>
-<div class="paragraph">
-<p>Have a look at
-<a href="http://cassandra.apache.org/doc/3.11.11/cql/ddl.html">cassandra documentation</a> section <code>CREATE KEYSPACE</code> for more information</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_grant_permissions_on_created_keyspace_to_the_role"><a class="anchor" href="#_grant_permissions_on_created_keyspace_to_the_role"></a>Grant permissions on created keyspace to the role</h4>
-<div class="paragraph">
-<p>The role to be used by James needs to have full rights on the keyspace
-that James is using. Assuming the keyspace name is <code>james_one_keyspace</code>
-and the role be <code>james_one</code>.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>GRANT CREATE ON KEYSPACE james_one_keyspace TO james_one; // Permission to create tables on the appointed keyspace
-GRANT SELECT ON KEYSPACE james_one_keyspace TO james_one; // Permission to select from tables on the appointed keyspace
-GRANT MODIFY ON KEYSPACE james_one_keyspace TO james_one; // Permission to update data in tables on the appointed keyspace</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>Warning</strong>: The granted role doesn’t have the right to create keyspaces,
-thus, if you haven’t created the keyspace, James server will fail to
-start is expected.</p>
-</div>
-<div class="paragraph">
-<p><strong>Tips</strong></p>
-</div>
-<div class="paragraph">
-<p>Since all of Cassandra roles used by different James are supposed to
-have a same set of permissions, you can reduce the works by creating a
-base role set like <code>typical_james_role</code> with all of necessary
-permissions. After that, with each James, create a new role and grant
-the <code>typical_james_role</code> to the newly created one. Note that, once a
-base role set is updated ( granting or revoking rights) all granted
-roles are automatically updated.</p>
-</div>
-<div class="paragraph">
-<p>E.g.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>CREATE ROLE james1 WITH PASSWORD = 'james1' AND LOGIN = true;
-GRANT typical_james_role TO james1;
-
-CREATE ROLE james2 WITH PASSWORD = 'james2' AND LOGIN = true;
-GRANT typical_james_role TO james2;</pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_revoke_harmful_permissions_from_the_created_role"><a class="anchor" href="#_revoke_harmful_permissions_from_the_created_role"></a>Revoke harmful permissions from the created role</h4>
-<div class="paragraph">
-<p>We want a specific role that cannot describe or query the information of
-other keyspaces or tables used by another application. By default,
-Cassandra allows every role created to have the right to describe any
-keyspace and table. There’s no configuration that can make effect on
-that topic. Consequently, you have to accept that your data models are
-still being exposed to anyone having credentials to Cassandra.</p>
-</div>
-<div class="paragraph">
-<p>For more information, have a look at
-<a href="http://cassandra.apache.org/doc/3.11.11/cql/security.html">cassandra documentation</a> section <code>REVOKE PERMISSION</code>.</p>
-</div>
-<div class="paragraph">
-<p>Except for the case above, the permissions are not auto available for a
-specific role unless they are granted by <code>GRANT</code> command. Therefore, if
-you didn’t provide more permissions than
-<a href="#_grant_permissions_on_created_keyspace_to_the_role">granting
-section</a>, there’s no need to revoke.</p>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_cassandra_table_level_configuration"><a class="anchor" href="#_cassandra_table_level_configuration"></a>Cassandra table level configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>While <em>Distributed James</em> is shipped with default table configuration
-options, these settings should be refined depending of your usage.</p>
-</div>
-<div class="paragraph">
-<p>These options are:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>The <a href="https://cassandra.apache.org/doc/latest/operating/compaction.html">compaction algorithms</a></p>
-</li>
-<li>
-<p>The <a href="https://cassandra.apache.org/doc/latest/operating/bloom_filters.html">bloom filter sizing</a></p>
-</li>
-<li>
-<p>The <a href="https://cassandra.apache.org/doc/latest/operating/compression.html?highlight=chunk%20size">chunk size</a></p>
-</li>
-<li>
-<p>The <a href="https://www.datastax.com/blog/2011/04/maximizing-cache-benefit-cassandra">cachingoptions</a></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The compaction algorithms allow a tradeoff between background IO upon
-writes and reads. We recommend:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Using <strong>Leveled Compaction Strategy</strong> on
-read intensive tables subject to updates. This limits the count of
-SStables being read at the cost of more background IO. High garbage
-collections can be caused by an inappropriate use of Leveled Compaction
-Strategy.</p>
-</li>
-<li>
-<p>Otherwise use the default <strong>Size Tiered Compaction Strategy</strong>.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Bloom filters help avoiding unnecessary reads on SSTables. This
-probabilistic data structure can tell an entry absence from a SSTable,
-as well as the presence of an entry with an associated probability. If a
-lot of false positives are noticed, the size of the bloom filters can be
-increased.</p>
-</div>
-<div class="paragraph">
-<p>As explained in
-<a href="https://thelastpickle.com/blog/2018/08/08/compression_performance.html">this post</a>,
-chunk size used upon compression allows a tradeoff between reads
-and writes. A smaller size will mean decreasing compression, thus it
-increases data being stored on disk, but allow lower chunks to be read
-to access data, and will favor reads. A bigger size will mean better
-compression, thus writing less, but it might imply reading bigger
-chunks.</p>
-</div>
-<div class="paragraph">
-<p>Cassandra enables a key cache and a row cache. Key cache enables to skip
-reading the partition index upon reads, thus performing 1 read to the
-disk instead of 2. Enabling this cache is globally advised. Row cache
-stores the entire row in memory. It can be seen as an optimization, but
-it might actually use memory no longer available for instance for file
-system cache. We recommend turning it off on modern SSD hardware.</p>
-</div>
-<div class="paragraph">
-<p>A review of your usage can be conducted using
-<a href="https://cassandra.apache.org/doc/latest/tools/nodetool/nodetool.html">nodetool</a>
-utility. For example <code>nodetool tablestats {keyspace}</code> allows reviewing
-the number of SSTables, the read/write ratios, bloom filter efficiency.
-<code>nodetool tablehistograms {keyspace}.{table}</code> might give insight about
-read/write performance.</p>
-</div>
-<div class="paragraph">
-<p>Table level options can be changed using <strong>ALTER TABLE</strong> for example with
-the <a href="https://cassandra.apache.org/doc/latest/tools/cqlsh.html">cqlsh</a>
-utility. A full compaction might be needed in order for the changes to
-be taken into account.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_mail_queue"><a class="anchor" href="#_mail_queue"></a>Mail Queue</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_fine_tune_configuration_for_rabbitmq"><a class="anchor" href="#_fine_tune_configuration_for_rabbitmq"></a>Fine tune configuration for RabbitMQ</h3>
-<div class="paragraph">
-<p>In order to adapt mail queue settings to the actual traffic load, an
-administrator needs to perform fine configuration tunning as explained
-in
-<a href="https://github.com/apache/james-project/blob/master/src/site/xdoc/server/config-rabbitmq.xml">rabbitmq.properties</a>.</p>
-</div>
-<div class="paragraph">
-<p>Be aware that <code>MailQueue::getSize</code> is currently performing a browse and
-thus is expensive. Size recurring metric reporting thus introduces
-performance issues. As such, we advise setting
-<code>mailqueue.size.metricsEnabled=false</code>.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_managing_email_queues"><a class="anchor" href="#_managing_email_queues"></a>Managing email queues</h3>
-<div class="paragraph">
-<p>Managing an email queue is an easy task if you follow this procedure:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>First, <a href="webadmin.html#_listing_mail_queues" class="xref page">List mail queues</a>
-and <a href="webadmin.html#_getting_a_mail_queue_details" class="xref page">get a mail queue details</a>.</p>
-</li>
-<li>
-<p>And then
-<a href="webadmin.html#_listing_the_mails_of_a_mail_queue" class="xref page">List the mails of a mail queue</a>.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>In case, you need to clear an email queue because there are only spam or
-trash emails in the email queue you have this procedure to follow:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>All mails from the given mail queue will be deleted with
-<a href="webadmin.html#_clearing_a_mail_queue" class="xref page">Clearing a mail queue</a>.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_updating_cassandra_schema_version"><a class="anchor" href="#_updating_cassandra_schema_version"></a>Updating Cassandra schema version</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>A schema version indicates you which schema your James server is relying
-on. The schema version number tracks if a migration is required. For
-instance, when the latest schema version is 2, and the current schema
-version is 1, you might think that you still have data in the deprecated
-Message table in the database. Hence, you need to migrate these messages
-into the MessageV2 table. Once done, you can safely bump the current
-schema version to 2.</p>
-</div>
-<div class="paragraph">
-<p>Relying on outdated schema version prevents you to benefit from the
-newest performance and safety improvements. Otherwise, there’s something
-very unexpected in the way we manage cassandra schema: we create new
-tables without asking the admin about it. That means your James version
-is always using the last tables but may also take into account the old
-ones if the migration is not done yet.</p>
-</div>
-<div class="sect2">
-<h3 id="_how_to_detect_when_we_should_update_cassandra_schema_version"><a class="anchor" href="#_how_to_detect_when_we_should_update_cassandra_schema_version"></a>How to detect when we should update Cassandra schema version</h3>
-<div class="paragraph">
-<p>When you see in James logs
-<code>org.apache.james.modules.mailbox.CassandraSchemaVersionStartUpCheck</code>
-showing a warning like <code>Recommended version is versionX</code>, you should
-perform an update of the Cassandra schema version.</p>
-</div>
-<div class="paragraph">
-<p>Also, we keep track of changes needed when upgrading to a newer version.
-You can read this
-<a href="https://github.com/apache/james-project/blob/master/upgrade-instructions.md">upgrade
-instructions</a>.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_how_to_update_cassandra_schema_version"><a class="anchor" href="#_how_to_update_cassandra_schema_version"></a>How to update Cassandra schema version</h3>
-<div class="paragraph">
-<p>These schema updates can be triggered by webadmin using the Cassandra
-backend. Following steps are for updating Cassandra schema version:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>At the very first step, you need to
-<a href="webadmin.html#_retrieving_current_cassandra_schema_version" class="xref page">retrieve
-current Cassandra schema version</a></p>
-</li>
-<li>
-<p>And then, you
-<a href="webadmin.html#_retrieving_latest_available_cassandra_schema_version" class="xref page">retrieve
-latest available Cassandra schema version</a> to make sure there is a
-latest available version</p>
-</li>
-<li>
-<p>Eventually, you can update the current schema version to the one you
-got with
-<a href="webadmin.html#_upgrading_to_the_latest_version" class="xref page">upgrading to
-the latest version</a></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Otherwise, if you need to run the migrations to a specific version, you
-can use
-<a href="webadmin.html#_upgrading_to_a_specific_version" class="xref page">Upgrading to a
-specific version</a></p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_deleted_message_vault"><a class="anchor" href="#_deleted_message_vault"></a>Deleted Message Vault</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>We recommend the administrator to
-<a href="#_cleaning_expired_deleted_messages">run it</a> in cron job to save
-storage volume.</p>
-</div>
-<div class="sect2">
-<h3 id="_how_to_configure_deleted_messages_vault"><a class="anchor" href="#_how_to_configure_deleted_messages_vault"></a>How to configure deleted messages vault</h3>
-<div class="paragraph">
-<p>To setup James with Deleted Messages Vault, you need to follow those
-steps:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Enable Deleted Messages Vault by configuring Pre Deletion Hooks.</p>
-</li>
-<li>
-<p>Configuring the retention time for the Deleted Messages Vault.</p>
-</li>
-</ul>
-</div>
-<div class="sect3">
-<h4 id="_enable_deleted_messages_vault_by_configuring_pre_deletion_hooks"><a class="anchor" href="#_enable_deleted_messages_vault_by_configuring_pre_deletion_hooks"></a>Enable Deleted Messages Vault by configuring Pre Deletion Hooks</h4>
-<div class="paragraph">
-<p>You need to configure this hook in
-<a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/listeners.xml">listeners.xml</a>
-configuration file. More details about configuration & example can be
-found at <a href="http://james.apache.org/server/config-listeners.html">Pre
-Deletion Hook Configuration</a></p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_configuring_the_retention_time_for_the_deleted_messages_vault"><a class="anchor" href="#_configuring_the_retention_time_for_the_deleted_messages_vault"></a>Configuring the retention time for the Deleted Messages Vault</h4>
-<div class="paragraph">
-<p>In order to configure the retention time for the Deleted Messages Vault,
-an administrator needs to perform fine configuration tunning as
-explained in
-<a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/deletedMessageVault.properties">deletedMessageVault.properties</a>.
-Mails are not retained forever as you have to configure a retention
-period (by <code>retentionPeriod</code>) before using it (with one-year retention
-by default if not defined).</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_restore_deleted_messages_after_deletion"><a class="anchor" href="#_restore_deleted_messages_after_deletion"></a>Restore deleted messages after deletion</h3>
-<div class="paragraph">
-<p>After users deleted their mails and emptied the trash, the admin can use
-<a href="webadmin.html#_restore_deleted_messages" class="xref page">Restore Deleted Messages</a>
-to restore all the deleted mails.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_cleaning_expired_deleted_messages"><a class="anchor" href="#_cleaning_expired_deleted_messages"></a>Cleaning expired deleted messages</h3>
-<div class="paragraph">
-<p>You can delete all deleted messages older than the configured
-<code>retentionPeriod</code> by using
-<a href="webadmin.html#_deleted_messages_vault" class="xref page">Purge Deleted Messages</a>.
-We recommend calling this API in CRON job on 1st day each
-month.</p>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/operate/index.html b/james-distributed-app/3.8.0/operate/index.html
deleted file mode 100644
index 4044c0b..0000000
--- a/james-distributed-app/3.8.0/operate/index.html
+++ /dev/null
@@ -1,494 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Operate the Distributed server :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item is-current-page" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Operate</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/operate/index.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Operate the Distributed server</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>The following pages detail how to operate the Distributed server.</p>
-</div>
-<div class="paragraph">
-<p>Once you have a Distributed James server up and running you then need to ensure it operates correctly and has a decent performance.
-You may also need to perform some operation maintenance or recover from incidents. This section covers
-these topics.</p>
-</div>
-<div class="paragraph">
-<p>Read more about <a href="logging.html" class="xref page">Logging</a>.</p>
-</div>
-<div class="paragraph">
-<p>The <a href="webadmin.html" class="xref page">WebAdmin Restfull administration API</a> is the
-recommended way to operate the Distributed James server. It allows managing and interacting with most
-server components.</p>
-</div>
-<div class="paragraph">
-<p>The <a href="cli.html" class="xref page">Command line interface</a> allows to interact with some
-server components. However it relies on JMX technologies and its use is discouraged.</p>
-</div>
-<div class="paragraph">
-<p>The <a href="metrics.html" class="xref page">metrics</a> allows to build latency and throughput
-graphs, that can be visualized, for instance in <strong>Grafana</strong>.</p>
-</div>
-<div class="paragraph">
-<p>We did put together a <a href="guide.html" class="xref page">detailed guide</a> for
-distributed James operators. We also propose a <a href="performanceChecklist.html" class="xref page">performance checklist</a>.</p>
-</div>
-<div class="paragraph">
-<p>We also included a guide for <a href="migrating.html" class="xref page">migrating existing data</a> into the distributed server.</p>
-</div>
-<div class="paragraph">
-<p>Read more about <a href="cassandra-migration.html" class="xref page">Cassandra data migration</a>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_upgrading"><a class="anchor" href="#_upgrading"></a>Upgrading</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This section sums up and links upgrade instructions for people willing to upgrade their Distributed server to newer versions.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. Upgrade path</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Upgrade from</th>
-<th class="tableblock halign-left valign-top">Recommended upgrade path to 3.7.4</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">3.7.0 - 3.7.4</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Upgrade, and apply <a href="https://github.com/apache/james-project/blob/master/upgrade-instructions.md#380-version">3.8.0 upgrade instructions</a></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">3.6.0 - 3.6.2</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">1. Upgrade, and apply <a href="https://github.com/apache/james-project/blob/master/upgrade-instructions.md#370-version">3.7.0 upgrade instructions</a></p>
-<p class="tableblock">2. Upgrade, and apply <a href="https://github.com/apache/james-project/blob/master/upgrade-instructions.md#380-version">3.8.0 upgrade instructions</a></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">3.5.0</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">1. Upgrade, and apply <a href="https://github.com/apache/james-project/blob/master/upgrade-instructions.md#360-version">3.6.0 upgrade instructions</a></p>
-<p class="tableblock">Note: Because of ElasticSearch upgrade (6.3 → 7.10) this migration cannot be done in a rolling fashion manner.</p>
-<p class="tableblock">2. Upgrade, and apply <a href="https://github.com/apache/james-project/blob/master/upgrade-instructions.md#370-version">3.7.0 upgrade instructions</a></p>
-<p class="tableblock">3. Upgrade, and apply <a href="https://github.com/apache/james-project/blob/master/upgrade-instructions.md#380-version">3.8.0 upgrade instructions</a></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">3.4.0</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">1. Rolling upgrade to 3.5.0, and apply <a href="https://github.com/apache/james-project/blob/master/upgrade-instructions.md#350-version">3.5.0 upgrade instructions</a></p>
-<p class="tableblock">2. Upgrade to 3.6.0, and apply <a href="https://github.com/apache/james-project/blob/master/upgrade-instructions.md#360-version">3.6.0 upgrade instructions</a></p>
-<p class="tableblock">Note: Because of ElasticSearch upgrade (6.3 → 7.10) this migration cannot be done in a rolling fashion manner.</p>
-<p class="tableblock">3. Upgrade, and apply <a href="https://github.com/apache/james-project/blob/master/upgrade-instructions.md#370-version">3.7.0 upgrade instructions</a></p>
-<p class="tableblock">4. Upgrade, and apply <a href="https://github.com/apache/james-project/blob/master/upgrade-instructions.md#380-version">3.8.0 upgrade instructions</a></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">3.3.0</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">1. upgrade to 3.4.0, and apply <a href="https://github.com/apache/james-project/blob/master/upgrade-instructions.md#340-version">3.4.0 upgrade instructions</a></p>
-<p class="tableblock">Note: Because of ElasticSearch upgrade (2.2 → 6.3) this migration cannot be done in a rolling fashion manner.</p>
-<p class="tableblock">2. Rolling upgrade to 3.5.0, and apply <a href="https://github.com/apache/james-project/blob/master/upgrade-instructions.md#350-version">3.5.0 upgrade instructions</a></p>
-<p class="tableblock">3. Upgrade to 3.6.0, and apply <a href="https://github.com/apache/james-project/blob/master/upgrade-instructions.md#360-version">3.6.0 upgrade instructions</a></p>
-<p class="tableblock">Note: Because of ElasticSearch upgrade (6.3 → 7.10) this migration cannot be done in a rolling fashion manner.</p>
-<p class="tableblock">4. Upgrade, and apply <a href="https://github.com/apache/james-project/blob/master/upgrade-instructions.md#370-version">3.7.0 upgrade instructions</a></p>
-<p class="tableblock">5. Upgrade, and apply <a href="https://github.com/apache/james-project/blob/master/upgrade-instructions.md#380-version">3.8.0 upgrade instructions</a></p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/operate/logging.html b/james-distributed-app/3.8.0/operate/logging.html
deleted file mode 100644
index f8502f7..0000000
--- a/james-distributed-app/3.8.0/operate/logging.html
+++ /dev/null
@@ -1,794 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Logging :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Operate</a></li>
- <li><a href="logging.html">Logging</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/operate/logging.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Logging</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>We recommend to closely monitoring <strong>ERROR</strong> and <strong>WARNING</strong> logs. Those
-logs should be considered not normal.</p>
-</div>
-<div class="paragraph">
-<p>If you encounter some suspicious logs:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>If you have any doubt about the log being caused by a bug in James
-source code, please reach us via the bug tracker, the user mailing list or our Gitter channel (see our
-<a href="http://james.apache.org/#second">community page</a>)</p>
-</li>
-<li>
-<p>They can be due to insufficient performance from tier applications (eg
-Cassandra timeouts). In such case we advise you to conduct a close
-review of performances at the tier level.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Leveraging filters in Kibana discover view can help to filter out
-''already known'' frequently occurring logs.</p>
-</div>
-<div class="paragraph">
-<p>When reporting ERROR or WARNING logs, consider adding the full logs, and
-related data (eg the raw content of a mail triggering an issue) to the
-bug report in order to ease resolution.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_logging_configuration"><a class="anchor" href="#_logging_configuration"></a>Logging configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Distributed James uses <a href="http://logback.qos.ch/">logback</a> as a logging library
-and <a href="https://docs.fluentbit.io/">FluentBit</a> as centralize logging.</p>
-</div>
-<div class="paragraph">
-<p>Information about logback configuration can be found
-<a href="http://logback.qos.ch/manual/configuration.html">here</a>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_structured_logging"><a class="anchor" href="#_structured_logging"></a>Structured logging</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_pushing_logs_to_elasticsearch"><a class="anchor" href="#_pushing_logs_to_elasticsearch"></a>Pushing logs to ElasticSearch</h3>
-<div class="paragraph">
-<p>Distributed Server leverages the use of MDC in order to achieve structured logging,
-and better add context to the logged information. We furthermore ship
-<a href="https://github.com/linagora/logback-elasticsearch-appender">Logback Elasticsearch Appender</a>
-on the classpath to easily allow direct log indexation in
-<a href="https://www.elastic.co/elasticsearch">ElasticSearch</a>.</p>
-</div>
-<div class="paragraph">
-<p>Here is a sample <code>conf/logback.xml</code> configuration file for logback with the following
-pre-requisites:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Logging both in an unstructured fashion on the console and in a structured fashion in ElasticSearch</p>
-</li>
-<li>
-<p>Logging ElasticSearch Log appender logs in the console</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Configuration for pushing log direct to ElasticSearch</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Logging ElasticSearch Log appender logs in the console</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><?xml version="1.0" encoding="UTF-8"?>
-<configuration scan="true" scanPeriod="30 seconds">
-
- <contextListener class="ch.qos.logback.classic.jul.LevelChangePropagator">
- <resetJUL>true</resetJUL>
- </contextListener>
-
- <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
- <encoder>
- <pattern>%d{yyyy.MM.dd HH:mm:ss.SSS} %highlight([%-5level]) %logger{15} - %msg%n%rEx</pattern>
- <immediateFlush>false</immediateFlush>
- </encoder>
- </appender>
-
- <appender name="ELASTIC" class="com.linagora.logback.elasticsearch.ElasticsearchAppender">
- <url>http://elasticsearch:9200/_bulk</url>
- <index>logs-james-%date{yyyy.MM.dd}</index>
- <type>tester</type>
- <includeMdc>true</includeMdc>
- <excludedMdcKeys>host</excludedMdcKeys>
- <errorLoggerName>es-error-logger</errorLoggerName>
- <properties>
- <property>
- <name>host</name>
- <value>${HOSTNAME}</value>
- <allowEmpty>false</allowEmpty>
- </property>
- <property>
- <name>severity</name>
- <value>%level</value>
- </property>
- <property>
- <name>thread</name>
- <value>%thread</value>
- </property>
- <property>
- <name>stacktrace</name>
- <value>%ex</value>
- </property>
- <property>
- <name>logger</name>
- <value>%logger</value>
- </property>
- </properties>
- <headers>
- <header>
- <name>Content-Type</name>
- <value>application/json</value>
- </header>
- </headers>
- </appender>
-
- <root level="WARN">
- <appender-ref ref="ELASTIC" />
- </root>
-
- <logger name="es-error-logger" level="DEBUG" additivity="false">
- <appender-ref ref="CONSOLE" />
- </logger>
-
- <logger name="org.apache.james" level="INFO" />
-
-</configuration></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_using_fluentbit_as_a_log_forwarder"><a class="anchor" href="#_using_fluentbit_as_a_log_forwarder"></a>Using FluentBit as a log forwarder</h3>
-<div class="sect3">
-<h4 id="_using_docker"><a class="anchor" href="#_using_docker"></a>Using Docker</h4>
-<div class="paragraph">
-<p>Distributed Server leverages the use of MDC in order to achieve structured logging, and better add context to the logged information. We furthermore ship json logs to file with RollingFileAppender on the classpath to easily allow FluentBit to directly tail the log file.
-Here is a sample conf/logback.xml configuration file for logback with the following pre-requisites:</p>
-</div>
-<div class="paragraph">
-<p>Logging in a structured json fashion and write to file for centralizing logging.
-Centralize logging third party like FluentBit can tail from logging’s file then filter/process and put in to ElastichSearch</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><?xml version="1.0" encoding="UTF-8"?>
-<configuration>
-
- <contextListener class="ch.qos.logback.classic.jul.LevelChangePropagator">
- <resetJUL>true</resetJUL>
- </contextListener>
-
- <appender name="LOG_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
- <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
- <fileNamePattern>logs/james.%d{yyyy-MM-dd}.%i.log</fileNamePattern>
- <maxHistory>1</maxHistory>
- <totalSizeCap>200MB</totalSizeCap>
- <maxFileSize>100MB</maxFileSize>
- </rollingPolicy>
-
- <encoder class="ch.qos.logback.core.encoder.LayoutWrappingEncoder">
- <layout class="ch.qos.logback.contrib.json.classic.JsonLayout">
- <timestampFormat>yyyy-MM-dd'T'HH:mm:ss.SSSX</timestampFormat>
- <timestampFormatTimezoneId>Etc/UTC</timestampFormatTimezoneId>
-
- <!-- Importance for handling multiple lines log -->
- <appendLineSeparator>true</appendLineSeparator>
-
- <jsonFormatter class="ch.qos.logback.contrib.jackson.JacksonJsonFormatter">
- <prettyPrint>false</prettyPrint>
- </jsonFormatter>
- </layout>
- </encoder>
- </appender>
-
- <root level="INFO">
- <appender-ref ref="LOG_FILE" />
- </root>
-
-</configuration></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>First you need to create a <code>logs</code> folder, then mount it to James container and to FluentBit.</p>
-</div>
-<div class="paragraph">
-<p>docker-compose:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>version: "3"
-
-services:
- james:
- depends_on:
- - elasticsearch
- - cassandra
- - rabbitmq
- - s3
- entrypoint: bash -c "java -cp 'james-server.jar:extension-jars/*:james-server-memory-guice.lib/*' -Dworking.directory=/root/ -Dlogback.configurationFile=/root/conf/logback.xml org.apache.james.CassandraRabbitMQJamesServerMain"
- image: linagora/james-rabbitmq-project:branch-master
- container_name: james
- hostname: james.local
- volumes:
- - ./extension-jars:/root/extension-jars
- - ./conf/logback.xml:/root/conf/logback.xml
- - ./logs:/root/logs
- ports:
- - "80:80"
- - "25:25"
- - "110:110"
- - "143:143"
- - "465:465"
- - "587:587"
- - "993:993"
- - "8080:8000"
-
- elasticsearch:
- image: docker.elastic.co/elasticsearch/elasticsearch:7.10.2
- ports:
- - "9200:9200"
- environment:
- - discovery.type=single-node
-
- cassandra:
- image: cassandra:4.1.3
- ports:
- - "9042:9042"
-
- rabbitmq:
- image: rabbitmq:3.12.1-management
- ports:
- - "5672:5672"
- - "15672:15672"
-
- s3:
- image: registry.scality.com/cloudserver/cloudserver:8.7.25
- container_name: s3.docker.test
- environment:
- - SCALITY_ACCESS_KEY_ID=accessKey1
- - SCALITY_SECRET_ACCESS_KEY=secretKey1
- - S3BACKEND=mem
- - LOG_LEVEL=trace
- - REMOTE_MANAGEMENT_DISABLE=1
-
- fluent-bit:
- image: fluent/fluent-bit:1.5.7
- volumes:
- - ./fluentbit/fluent-bit.conf:/fluent-bit/etc/fluent-bit.conf
- - ./fluentbit/parsers.conf:/fluent-bit/etc/parsers.conf
- - ./logs:/fluent-bit/log
- ports:
- - "24224:24224"
- - "24224:24224/udp"
- depends_on:
- - elasticsearch
-
- kibana:
- image: docker.elastic.co/kibana/kibana:7.10.2
- environment:
- ELASTICSEARCH_HOSTS: http://elasticsearch:9200
- ports:
- - "5601:5601"
- depends_on:
- - elasticsearch</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>FluentBit config as:
-the <code>Host elasticsearch</code> pointing to <code>elasticsearch</code> service in docker-compose file.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[SERVICE]
- Parsers_File /fluent-bit/etc/parsers.conf
-
-[INPUT]
- name tail
- path /fluent-bit/log/*.log
- Parser docker
- docker_mode on
- buffer_chunk_size 1MB
- buffer_max_size 1MB
- mem_buf_limit 64MB
- Refresh_Interval 30
-
-[OUTPUT]
- Name stdout
- Match *
-
-
-[OUTPUT]
- Name es
- Match *
- Host elasticsearch
- Port 9200
- Index fluentbit
- Logstash_Format On
- Logstash_Prefix fluentbit-james
- Type docker</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>FluentBit Parser config:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[PARSER]
- Name docker
- Format json
- Time_Key timestamp
- Time_Format %Y-%m-%dT%H:%M:%S.%LZ
- Time_Keep On
- Decode_Field_As escaped_utf8 log do_next
- Decode_Field_As escaped log do_next
- Decode_Field_As json log</pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_using_kubernetes"><a class="anchor" href="#_using_kubernetes"></a>Using Kubernetes</h4>
-<div class="paragraph">
-<p>If using James in a Kubernetes environment, you can just append the logs to the console in a JSON formatted way
-using Jackson to easily allow FluentBit to directly tail them.</p>
-</div>
-<div class="paragraph">
-<p>Here is a sample conf/logback.xml configuration file for achieving this:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><?xml version="1.0" encoding="UTF-8"?>
-<configuration>
-
- <contextListener class="ch.qos.logback.classic.jul.LevelChangePropagator">
- <resetJUL>true</resetJUL>
- </contextListener>
-
- <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
- <encoder class="ch.qos.logback.core.encoder.LayoutWrappingEncoder">
- <layout class="ch.qos.logback.contrib.json.classic.JsonLayout">
- <timestampFormat>yyyy-MM-dd'T'HH:mm:ss.SSSX</timestampFormat>
- <timestampFormatTimezoneId>Etc/UTC</timestampFormatTimezoneId>
-
- <!-- Importance for handling multiple lines log -->
- <appendLineSeparator>true</appendLineSeparator>
-
- <jsonFormatter class="ch.qos.logback.contrib.jackson.JacksonJsonFormatter">
- <prettyPrint>false</prettyPrint>
- </jsonFormatter>
- </layout>
- </encoder>
- </appender>
-
- <root level="INFO">
- <appender-ref ref="CONSOLE" />
- </root>
-
-</configuration></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Regarding FluentBit on Kubernetes, you need to install it as a DaemonSet. Some official template exist
-with FluentBit outputting logs to ElasticSearch. For more information on how to install it,
-with your cluster, you can look at this <a href="https://docs.fluentbit.io/manual/installation/kubernetes">documentation</a>.</p>
-</div>
-<div class="paragraph">
-<p>As stated by the <a href="https://docs.fluentbit.io/manual/installation/kubernetes#details">detail</a> of the
-official documentation, FluentBit is configured to consume out of the box logs from containers
-on the same running node. So it should scrap your James logs without extra configuration.</p>
-</div>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/operate/metrics.html b/james-distributed-app/3.8.0/operate/metrics.html
deleted file mode 100644
index e03da4c..0000000
--- a/james-distributed-app/3.8.0/operate/metrics.html
+++ /dev/null
@@ -1,739 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Metrics :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Operate</a></li>
- <li><a href="metrics.html">Metrics</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/operate/metrics.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Metrics</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>James relies on the <a href="https://metrics.dropwizard.io/4.1.2/manual/core.html">Dropwizard metric library</a>
-for keeping track of some core metrics of James.</p>
-</div>
-<div class="paragraph">
-<p>Such metrics are made available via JMX. You can connect for instance using VisualVM and the associated
-mbean plugins.</p>
-</div>
-<div class="paragraph">
-<p>We also support displaying them via <a href="https://grafana.com/">Grafana</a>. Two methods can be used to back grafana display:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Prometheus metric collection - Data are exposed on a HTTP endpoint for Prometheus scrape.</p>
-</li>
-<li>
-<p>ElasticSearch metric collection - This method is depreciated and will be removed in next version.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_expose_metrics_for_prometheus_collection"><a class="anchor" href="#_expose_metrics_for_prometheus_collection"></a>Expose metrics for Prometheus collection</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>To enable James metrics, add <code>extensions.routes</code> to <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/webadmin.adoc">webadmin.properties</a> file:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">extensions.routes=org.apache.james.webadmin.dropwizard.MetricsRoutes</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Connect to james-admin url to test the result:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>http://james-admin-url/metrics</pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_configure_prometheus_data_source"><a class="anchor" href="#_configure_prometheus_data_source"></a>Configure Prometheus Data source</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>You need to set up <a href="https://prometheus.io/docs/prometheus/latest/getting_started/">Prometheus</a> first to scrape James metrics.<br>
-Add Apache James WebAdmin Url or IP address to <code>prometheus.yaml</code> configuration file:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>scrape_configs:
- # The job name is added as a label `job=<job_name>` to any timeseries scraped from this config.
- - job_name: 'WebAdmin url Example'
- scrape_interval: 5s
- metrics_path: /metrics
- static_configs:
- - targets: ['james-webamin-url']
- - job_name: 'WebAdmin IP Example'
- scrape_interval: 5s
- metrics_path: /metrics
- static_configs:
- - targets: ['192.168.100.10:8000']</pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_connect_prometheus_to_grafana"><a class="anchor" href="#_connect_prometheus_to_grafana"></a>Connect Prometheus to Grafana</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>You can do this either from <a href="https://prometheus.io/docs/visualization/grafana/">Grafana UI</a> or from a <a href="https://grafana.com/docs/grafana/latest/datasources/prometheus/">configuration file</a>.<br>
-The following <code>docker-compose.yaml</code> will help you install a simple Prometheus/ Grafana stack :</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">version: '3'
-#Metric monitoring
- grafana:
- image: grafana/grafana:latest
- container_name: grafana
- ports:
- - "3000:3000"
-
- prometheus:
- image: prom/prometheus:latest
- restart: unless-stopped
- ports:
- - "9090:9090"
- volumes:
- - ./conf/prometheus.yml:/etc/prometheus/prometheus.yml</code></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_getting_dashboards"><a class="anchor" href="#_getting_dashboards"></a>Getting dashboards</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Now that the Promtheus/Grafana servers are up, go to this <a href="https://github.com/apache/james-project/tree/master/server/grafana-reporting/prometheus-datasource/">link</a> to get all dashboards JSON file. Import the different JSON files in this directory to Grafana via UI.</p>
-</div>
-<div class="imageblock">
-<div class="content">
-<img src="../_images/preload-dashboards.png" alt="Pre-loaded dashboards">
-</div>
-</div>
-<div class="paragraph">
-<p>*Note: For communication between multiple docker-compose projects, see <a href="https://stackoverflow.com/questions/38088279/communication-between-multiple-docker-compose-projects">here</a> for example. An easier approach is to merge James and Metric docker-compose files together.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_available_metrics"><a class="anchor" href="#_available_metrics"></a>Available metrics</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Here are the available metrics :</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>James JVM metrics</p>
-</li>
-<li>
-<p>Number of active SMTP connections</p>
-</li>
-<li>
-<p>Number of SMTP commands received</p>
-</li>
-<li>
-<p>Number of active IMAP connections</p>
-</li>
-<li>
-<p>Number of IMAP commands received</p>
-</li>
-<li>
-<p>Number of active LMTP connections</p>
-</li>
-<li>
-<p>Number of LMTP commands received</p>
-</li>
-<li>
-<p>Number of per queue number of enqueued mails</p>
-</li>
-<li>
-<p>Number of sent emails</p>
-</li>
-<li>
-<p>Number of delivered emails</p>
-</li>
-<li>
-<p>Diverse Response time percentiles, counts and rates for JMAP</p>
-</li>
-<li>
-<p>Diverse Response time percentiles, counts and rates for IMAP</p>
-</li>
-<li>
-<p>Diverse Response time percentiles, counts and rates for SMTP</p>
-</li>
-<li>
-<p>Diverse Response time percentiles, counts and rates for WebAdmin</p>
-</li>
-<li>
-<p>Diverse Response time percentiles, counts and rates for each Mail Queue</p>
-</li>
-<li>
-<p>Per mailet and per matcher Response time percentiles</p>
-</li>
-<li>
-<p>Diverse Response time percentiles, counts and rates for DNS</p>
-</li>
-<li>
-<p>Cassandra Java driver metrics</p>
-</li>
-<li>
-<p>Tika HTTP client statistics</p>
-</li>
-<li>
-<p>SpamAssassin TCP client statistics</p>
-</li>
-<li>
-<p>Mailbox listeners statistics time percentiles</p>
-</li>
-<li>
-<p>Mailbox listeners statistics requests rate</p>
-</li>
-<li>
-<p>Pre-deletion hooks execution statistics time percentiles</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_available_grafana_boards"><a class="anchor" href="#_available_grafana_boards"></a>Available Grafana boards</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Here are the various relevant Grafana boards for the Distributed Server:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://github.com/apache/james-project/tree/master/server/grafana-reporting/prometheus-datasource/James_BlobStore.json">BlobStore</a> :
-Rates and percentiles for the BlobStore component</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/tree/master/server/grafana-reporting/prometheus-datasource/James_DNS_Dashboard.json">DNS</a> :
-Latencies and query counts for DNS resolution.</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/tree/master/server/grafana-reporting/prometheus-datasource/James_IMAP_Board.json">IMAP</a> :
-Latencies for the IMAP protocol</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/tree/master/server/grafana-reporting/prometheus-datasource/James_IMAP_CountBoard.json">IMAP counts</a> :
-Request counts for the IMAP protocol</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/tree/master/server/grafana-reporting/prometheus-datasource/James_JMAP_Board.json">JMAP</a> :
-Latencies for the JMAP protocol</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/tree/master/server/grafana-reporting/prometheus-datasource/James_JMAP_CountBoard.json">JMAP counts</a> :
-Request counts for the JMAP protocol</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/tree/master/server/grafana-reporting/prometheus-datasource/James_JVM.json">JVM</a> :
-JVM statistics (heap, gcs, etc…​)</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/tree/master/server/grafana-reporting/prometheus-datasource/James_MAILET.json">Mailets</a> :
-Per-mailet execution timings.</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/tree/master/server/grafana-reporting/prometheus-datasource/James_MATCHER.json">Matchers</a> :
-Per-matcher execution timings</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/tree/master/server/grafana-reporting/prometheus-datasource/James_MailQueue.json">MailQueue</a> :
-MailQueue statistics</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/tree/master/server/grafana-reporting/prometheus-datasource/James_SMTP_Board.json">SMTP</a> :
-SMTP latencies reports</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/tree/master/server/grafana-reporting/prometheus-datasource/James_SMTP_CountBoard.json">SMTP count</a> :
-Request count for the SMTP protocol</p>
-</li>
-</ul>
-</div>
-<div class="sect2">
-<h3 id="_dashboard_samples"><a class="anchor" href="#_dashboard_samples"></a>Dashboard samples</h3>
-<div class="paragraph">
-<p>Latencies for the JMAP protocol<br></p>
-</div>
-<div class="imageblock">
-<div class="content">
-<img src="../_images/JMAP_board.png" alt="JMAP">
-</div>
-</div>
-<div class="paragraph">
-<p>Latencies for the IMAP protocol<br></p>
-</div>
-<div class="imageblock">
-<div class="content">
-<img src="../_images/IMAP_board.png" alt="IMAP">
-</div>
-</div>
-<div class="paragraph">
-<p>JVM Statistics<br></p>
-</div>
-<div class="imageblock">
-<div class="content">
-<img src="../_images/JVM_board.png" alt="JVM">
-</div>
-</div>
-<div class="paragraph">
-<p>BlobStore Statistics<br></p>
-</div>
-<div class="imageblock">
-<div class="content">
-<img src="../_images/BlobStore.png" alt="BlobStore">
-</div>
-</div>
-<div class="paragraph">
-<p>webAdmin Statistics<br></p>
-</div>
-<div class="imageblock">
-<div class="content">
-<img src="../_images/webAdmin.png" alt="webAdmin">
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_expose_metrics_for_elasticsearch_collection"><a class="anchor" href="#_expose_metrics_for_elasticsearch_collection"></a>Expose metrics for Elasticsearch collection</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The following command allow you to run a fresh grafana server :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>docker run -i -p 3000:3000 grafana/grafana</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Once running, you need to set up an ElasticSearch data-source : - select
-proxy mode - Select version 2.x of ElasticSearch - make the URL point
-your ES node - Specify the index name. By default, it should be :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[james-metrics-]YYYY-MM</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Import the different dashboards you want.</p>
-</div>
-<div class="paragraph">
-<p>You then need to enable reporting through ElasticSearch. Modify your
-James ElasticSearch configuration file accordingly. To help you doing
-this, you can take a look to
-<a href="https://github.com/apache/james-project/blob/3.7.x/server/apps/distributed-app/sample-configuration/elasticsearch.properties">elasticsearch.properties</a>.</p>
-</div>
-<div class="paragraph">
-<p>If some metrics seem abnormally slow despite in depth database
-performance tuning, feedback is appreciated as well on the bug tracker,
-the user mailing list or our Gitter channel (see our
-<a href="http://james.apache.org/#second">community page</a>) . Any additional
-details categorizing the slowness are appreciated as well (details of
-the slow requests for instance).</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/operate/migrating.html b/james-distributed-app/3.8.0/operate/migrating.html
deleted file mode 100644
index de84959..0000000
--- a/james-distributed-app/3.8.0/operate/migrating.html
+++ /dev/null
@@ -1,461 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Migrating existing data :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="metrics.html">Metrics</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Operate</a></li>
- <li><a href="migrating.html">Migrating existing data</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/operate/migrating.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Migrating existing data</h1>
-<div class="paragraph">
-<p>This page presents how operators can migrate your user mailbox and mails into the Distributed Server in order to adopt it.</p>
-</div>
-<div class="paragraph">
-<p>We assume you have a <a href="../configure/index.html" class="xref page">well configured</a> running Distributed server
-at hand. We also assume existing mails are hosted on a tier mail server which can be accessed via IMAP and supports
-impersonation.</p>
-</div>
-<div class="paragraph">
-<p>First, you want to create the domains handled by your server, as well as the users you will be hosting. This operation
-can be performed via WebAdmin or the CLI.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Using webadmin :</p>
-<div class="ulist">
-<ul>
-<li>
-<p>Read <a href="webadmin.html#_create_a_domain" class="xref page">this section</a> for creating domains</p>
-</li>
-<li>
-<p>Read <a href="webadmin.html#_create_a_user" class="xref page">this section</a> for creating users</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p>Using the CLI :</p>
-<div class="ulist">
-<ul>
-<li>
-<p>Read <a href="cli.html#_manage_domains" class="xref page">this section</a> for creating domains</p>
-</li>
-<li>
-<p>Read <a href="cli.html#_managing_users" class="xref page">this section</a> for creating users</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Second, you want to allow an administrator account of your Distributed Server to have write access on other user mailboxes.
-This can be setted up this the <strong>administratorId</strong> configuration option of the <a href="../configure/usersrepository.html" class="xref page">usersrepository.xml</a> configuration file.</p>
-</div>
-<div class="paragraph">
-<p>Then, it is time to run <a href="https://github.com/imapsync/imapsync">imapsync</a> script to copy the emails from the previous mail server
-into the Distributed Server. Here is an example migrating a single user, relying on impersonation:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>imapsync --host1 previous.server.domain.tld \
- --user1 user@domain.tld --authuser1 adminOldServer@domain.tld \
- --proxyauth1 --password1 passwordOfTheOldAdmin \
- --host2 distributed.james.domain.tld \
- --user2 use1@domain.tld \
- --authuser2 adminNewServer@domain.tld --proxyauth2 \
- --password2 passwordOfTheNewAdmin</pre>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/operate/performanceChecklist.html b/james-distributed-app/3.8.0/operate/performanceChecklist.html
deleted file mode 100644
index 28beb88..0000000
--- a/james-distributed-app/3.8.0/operate/performanceChecklist.html
+++ /dev/null
@@ -1,639 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Performance checklist :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="guide.html">Operator guide</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Operate</a></li>
- <li><a href="performanceChecklist.html">Performance checklist</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/operate/performanceChecklist.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Performance checklist</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This guide aims to help James operators refine their James configuration and set up to achieve better performance.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_database_setup"><a class="anchor" href="#_database_setup"></a>Database setup</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Cassandra, OpenSearch, RabbitMQ is a large topic in itself that we do not intend to cover here. Yet, here are some
-very basic recommendation that are always beneficial to keep in mind.</p>
-</div>
-<div class="paragraph">
-<p>We recommend:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Running Cassandra, OpenSearch on commodity hardware with attached SSD. SAN disks are known to cause performance
-issues for these technologies. HDD disks are to be banned for these performance related applications.</p>
-</li>
-<li>
-<p>We recommend getting an Object Storage SaaS offering that suites your needs. Most generalist S3 offers will suite
-James needs.</p>
-</li>
-<li>
-<p>We do provide a guide on xref:[Database benchmarks] that can help identify and fix issues.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_james_configuration"><a class="anchor" href="#_james_configuration"></a>James configuration</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_cassandra"><a class="anchor" href="#_cassandra"></a>Cassandra</h3>
-<div class="paragraph">
-<p>People tunning for performance would likely accept relaxing their consistency needs. James allows doing this.</p>
-</div>
-<div class="paragraph">
-<p><strong>LightWeight Transactions (LWT)</strong> can be disabled where they are not essential. This can be done within
-xref:[cassandra.properties]:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>mailbox.read.strong.consistency=false
-message.read.strong.consistency=false
-message.write.strong.consistency.unsafe=false
-mailrepository.strong.consistency=false</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Also, James allows for <strong>Read repairs</strong> where consistency checks are piggy backed on reads randomly. This of course
-comes at a performance cost as it generates extre reads, thus minimizing read repair probability can help improving
-performance. This can be done within
-xref:[cassandra.properties]:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>mailbox.read.repair.chance=0.00
-mailbox.counters.read.repair.chance.max=0.000
-mailbox.counters.read.repair.chance.one.hundred=0.000</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>One can also avoid some Cassandra requests by disabling ACLs (meaning users will only access to the mailboxes they own,
-all mailbox-sharing features will thus not be achievable). This can be done within
-xref:[cassandra.properties]:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>acl.enabled=false</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Important settings in the `` file includes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Throttling: if too low then the Cassandra cluster is under-utilized. If too high, request bursts can cause significant
-Cassandra overload.</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> advanced.throttler {
- class = org.apache.james.backends.cassandra.utils.LockLessConcurrencyLimitingRequestThrottler
-
- max-queue-size = 10000
-
- max-concurrent-requests = 192
- }</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_object_storage"><a class="anchor" href="#_object_storage"></a>Object storage</h3>
-<div class="paragraph">
-<p>We recommend the use of the blob store cache, which will be populated by email headers which shall be treated as metadata.</p>
-</div>
-<div class="paragraph">
-<p><code>blob.properties</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>cache.enable=true
-cache.cassandra.ttl=1year
-cache.sizeThresholdInBytes=16 KiB</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_rabbitmq"><a class="anchor" href="#_rabbitmq"></a>RabbitMQ</h3>
-<div class="paragraph">
-<p>We recommend against the use of the CassandraMailQueueView, as browsing and advanced queue management features
-is unnecessary for Mail Delivery Agent and are not meaningful in the absence of delays.</p>
-</div>
-<div class="paragraph">
-<p>Similarly, we recommend turning off queue size metrics, which are expensive to compute.</p>
-</div>
-<div class="paragraph">
-<p>We also recommend against the use of publish confirms, which comes at a high performance price.</p>
-</div>
-<div class="paragraph">
-<p>In <code>rabbitmq.properties</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>cassandra.view.enabled=false
-
-mailqueue.size.metricsEnabled=false
-
-event.bus.publish.confirm.enabled=false
-mailqueue.publish.confirm.enabled=false</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_jmap_protocol"><a class="anchor" href="#_jmap_protocol"></a>JMAP protocol</h3>
-<div class="paragraph">
-<p>If you are not using JMAP, disabling it will avoid you the cost of populating related projections and thus is recommended.
-Within <code>jmap.properties</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>enabled=false</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>We recommend turning on EmailQueryView as it enables resolution of mailbox listing against Cassandra, thus unlocking massive
-stability / performance gains. Within <code>jmap.properties</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>view.email.query.enabled=true</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_imap_smtp"><a class="anchor" href="#_imap_smtp"></a>IMAP / SMTP</h3>
-<div class="paragraph">
-<p>We recommend against resolving client connection DNS names. This behaviour can be disabled via a system property within
-<code>jvm.properties</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>james.protocols.mdc.hostname=false</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Concurrent IMAP request count is the critical setting. In <code>imapServer.xml</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><concurrentRequests>200</concurrentRequests>
-<maxQueueSize>4096</maxQueueSize></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Other recommendation includes avoiding unecessary work upon IMAP IDLE, not starting dedicated BOSS threads:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><ignoreIDLEUponProcessing>false</ignoreIDLEUponProcessing>
-<bossWorkerCount>0</bossWorkerCount></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_other_generic_recommendations"><a class="anchor" href="#_other_generic_recommendations"></a>Other generic recommendations</h3>
-<div class="ulist">
-<ul>
-<li>
-<p>Remove unneeded listeners / mailets</p>
-</li>
-<li>
-<p>Reduce duplication of Matchers within mailetcontainer.xml</p>
-</li>
-<li>
-<p>Limit usage of "DEBUG" loglevel. INFO should be more than decent in most cases.</p>
-</li>
-<li>
-<p>While GC tunning is a science in itself, we had good results with G1GC and a low pause time:</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>-Xlog:gc*:file=/root/gc.log -XX:MaxGCPauseMillis=20 -XX:ParallelGCThreads=2</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>We recommand tunning bach sizes: <code>batchsizes.properties</code>. This allows, limiting parallel S3 reads, while loading many
-messages concurrently on Cassandra, and improves IMAP massive operations support.</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>fetch.metadata=200
-fetch.headers=30
-fetch.body=30
-fetch.full=30
-
-copy=8192
-
-move=8192</pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/operate/security.html b/james-distributed-app/3.8.0/operate/security.html
deleted file mode 100644
index b279e27..0000000
--- a/james-distributed-app/3.8.0/operate/security.html
+++ /dev/null
@@ -1,758 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Security checklist :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Operate</a></li>
- <li><a href="security.html">Security checklist</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/operate/security.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Security checklist</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This document aims as summarizing threats, security best practices as well as recommendations.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_threats"><a class="anchor" href="#_threats"></a>Threats</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Operating an email server exposes you to the following threats:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Spammers might attempt to use your servers to send their spam messages on their behalf. We speak of
-<strong>open relay</strong>. In addition to the resources consumed being an open relay will affect the trust other mail
-installations have in you, and thus will cause legitimate traffic to be rejected.</p>
-</li>
-<li>
-<p>Emails mostly consist of private data, which shall only be accessed by their legitimate user. Failure
-to do so might result in <strong>information disclosure</strong>.</p>
-</li>
-<li>
-<p><strong>Email forgery</strong>. An attacker might craft an email on the behalf of legitimate users.</p>
-</li>
-<li>
-<p>Email protocols allow user to authenticate and thus can be used as <strong>oracles</strong> to guess user passwords.</p>
-</li>
-<li>
-<p><strong>Spam</strong>. Non legitimate traffic can be a real burden to your users.</p>
-</li>
-<li>
-<p><strong>Phishing</strong>: Crafted emails that tricks the user into doing unintended actions.</p>
-</li>
-<li>
-<p><strong>Viruses</strong>: An attacker sends an attachment that contains an exploit that could run if a user opens it.</p>
-</li>
-<li>
-<p><strong>Denial of service</strong>: A small request may result in a very large response and require considerable work on the server…​</p>
-</li>
-<li>
-<p><strong>Denial of service</strong>: A malicious JMAP client may use the JMAP push subscription to attempt to flood a third party
-server with requests, creating a denial-of-service attack and masking the attacker’s true identity.</p>
-</li>
-<li>
-<p><strong>Dictionary Harvest Attacks</strong>: An attacker can rely on SMTP command reply code to know if a user exists or not. This
-can be used to obtain the list of local users and later use those address as targets for other attacks.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_best_practices"><a class="anchor" href="#_best_practices"></a>Best practices</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The following sections ranks best practices.</p>
-</div>
-<div class="sect2">
-<h3 id="_best_practices_must"><a class="anchor" href="#_best_practices_must"></a>Best practices: Must</h3>
-<div class="ulist">
-<ul>
-<li>
-<p>1. Configure James in order not to be an <a href="../configure/smtp.html#_about_open_relays" class="xref page">open relay</a>. This should be the
-case with the default configuration.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Be sure in <a href="../configure/smtp.html" class="xref page">smtpserver.xml</a> to activate the following options: <code>verifyIdentity</code>.</p>
-</div>
-<div class="paragraph">
-<p>We then recommend to manually test your installation in order to ensure that:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Unauthenticated SMTP users cannot send mails to external email addresses (they are not relayed)</p>
-</li>
-<li>
-<p>Unauthenticated SMTP users can send mails to internal email addresses</p>
-</li>
-<li>
-<p>Unauthenticated SMTP users cannot use local addresses in their mail from, and send emails both locally and to distant targets.</p>
-</li>
-<li>
-<p>2. Avoid <strong>STARTTLS</strong> usage and favor SSL. Upgrade from a non encrypted channel into an encrypted channel is an opportunity
-for additional vulnerabilities. This is easily prevented by requiring SSL connection upfront. <a href="https://nostarttls.secvuln.info/">Read more…​</a></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Please note that STARTTLS is still beneficial in the context of email relaying, which happens on SMTP port 25 unencrypted,
-and enable opportunistic encryption upgrades that would not overwise be possible. We recommend keeping STARTTLS activated
-for SMTP port 25.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>3. Use SSL for <a href="../configure/mailets.html#_remotedelivery" class="xref page">remote delivery</a> whenever you are using a gateway relaying SMTP server.</p>
-</li>
-<li>
-<p>4. Rely on an external identity service, dedicated to user credential storage. James supports <a href="../configure/usersrepository.html#_configuring_a_ldap" class="xref page">LDAP</a>. If you are
-forced to store users in James be sure to choose <code>PBKDF2</code> as a hashing algorithm. Also, delays on authentication failures
-are supported via the <code>verifyFailureDelay</code> property. Note that IMAP / SMTP connections are closed after 3 authentication
-failures.</p>
-</li>
-<li>
-<p>5. Ensure that <a href="../configure/webadmin.html" class="xref page">WebAdmin</a> is not exposed unencrypted to the outer world. Doing so trivially
-exposes yourself. You can either disable it, activate JWT security, or restrict it to listen only on localhost.</p>
-</li>
-<li>
-<p>6. Set up <code>HTTPS</code> for http based protocols, namely <strong>JMAP</strong> and <strong>WebAdmin</strong>. We recommend the use of a reverse proxy like Nginx.</p>
-</li>
-<li>
-<p>7. Set up <a href="https://james.apache.org/howTo/spf.html">SPF</a> and <a href="https://james.apache.org/howTo/dkim.html">DKIM</a>
-for your outgoing emails to be trusted.</p>
-</li>
-<li>
-<p>8. Prevent access to JMX. This can be achieved through a strict firewalling policy
-(<a href="https://nickbloor.co.uk/2017/10/22/analysis-of-cve-2017-12628/">blocking port 9999 is not enough</a>)
-or <a href="../configure/jmx.html" class="xref page">disabling JMX</a>. JMX is needed to use the existing CLI application but webadmin do offer similar
-features. Set the <code>jmx.remote.x.mlet.allow.getMBeansFromURL</code> to <code>false</code> to disable JMX remote code execution feature.</p>
-</li>
-<li>
-<p>9. If JMAP is enabled, be sure that JMAP PUSH cannot be used for server side request forgery. This can be
-<a href="../configure/jmap.html" class="xref page">configured</a> using the <code>push.prevent.server.side.request.forgery=true</code> property,
-forbidding push to private addresses.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_best_practice_should"><a class="anchor" href="#_best_practice_should"></a>Best practice: Should</h3>
-<div class="ulist">
-<ul>
-<li>
-<p>1. Avoid advertising login/authenticate capabilities in clear channels. This might prevent some clients to attempt login
-on clear channels, and can be configured for both <a href="../configure/smtp.html" class="xref page">SMTP</a> and <a href="../configure/imap.html" class="xref page">IMAP</a>
-using <code>auth.plainAuthEnabled=false</code>.</p>
-</li>
-<li>
-<p>2. Verify <a href="https://james.apache.org/howTo/spf.html">SPF</a> and <a href="../configure/mailets.html#_dkimverify" class="xref page">DKIM</a> for your incoming emails.</p>
-</li>
-<li>
-<p>3. Set up reasonable <a href="webadmin.html#_administrating_quotas" class="xref page">storage quota</a> for your users.</p>
-</li>
-<li>
-<p>4. We recommend setting up anti-spam and anti-virus solutions. James comes with some <a href="../configure/spam.html" class="xref page">Rspamd and SpamAssassin</a>
-integration, and some <a href="../configure/mailets.html#_clamavscan" class="xref page">ClamAV</a> tooling exists.
-Rspamd supports anti-phishing modules.
-Filtering with third party systems upstream is also possible.</p>
-</li>
-<li>
-<p>5. In order to limit your attack surface, disable protocols you or your users do not use. This includes the JMAP protocol,
-POP3, ManagedSieve, etc…​ Be conservative on what you expose.</p>
-</li>
-<li>
-<p>6. If operating behind a load-balancer, set up the <a href="https://www.haproxy.org/download/1.8/doc/proxy-protocol.txt">PROXY protocol</a> for
-TCP based protocols (IMAP and SMTP <code>proxyRequired</code> option)</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_best_practice_could"><a class="anchor" href="#_best_practice_could"></a>Best practice: Could</h3>
-<div class="ulist">
-<ul>
-<li>
-<p>1. Set up <a href="https://openid.net/connect/">OIDC</a> for IMAP, SMTP and JMAP. Disable login/plain/basic authentication.</p>
-</li>
-<li>
-<p>2. You can configure <a href="../configure/ssl.html#_client_authentication_via_certificates" class="xref page">Client authentication via certificates</a>.</p>
-</li>
-<li>
-<p>3. You can <a href="../configure/mailets.html#_smimesign" class="xref page">sign</a>, <a href="../configure/mailets.html#_smimechecksignature" class="xref page">verify</a>
-and <a href="../configure/mailets.html#_smimedecrypt" class="xref page">decrypt</a> your email traffic using <a href="https://datatracker.ietf.org/doc/html/rfc5751">SMIME</a>.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_known_vulnerabilities"><a class="anchor" href="#_known_vulnerabilities"></a>Known vulnerabilities</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Several vulnerabilities have had been reported for previous releases of Apache James server.</p>
-</div>
-<div class="paragraph">
-<p>Be sure not to run those! We highly recommend running the latest release, which we put great effort in not to use
-outdated dependencies.</p>
-</div>
-<div class="sect2">
-<h3 id="_reporting_vulnerabilities"><a class="anchor" href="#_reporting_vulnerabilities"></a>Reporting vulnerabilities</h3>
-<div class="paragraph">
-<p>We follow the standard procedures within the ASF regarding <a href="https://apache.org/security/committers.html#vulnerability-handling">vulnerability handling</a></p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_cve_2023_26269_privilege_escalation_through_unauthenticated_jmx"><a class="anchor" href="#_cve_2023_26269_privilege_escalation_through_unauthenticated_jmx"></a>CVE-2023-26269: Privilege escalation through unauthenticated JMX</h3>
-<div class="paragraph">
-<p>Apache James distribution prior to release 3.7.4 allows privilege escalation through the use of JMX.</p>
-</div>
-<div class="paragraph">
-<p><strong>Severity</strong>: Moderate</p>
-</div>
-<div class="paragraph">
-<p><strong>Mitigation</strong>: We recommend turning on authentication on. If the CLI is unused we recommend turning JMX off.</p>
-</div>
-<div class="paragraph">
-<p>Release 3.7.4 set up implicitly JMX authentication for Guice based products and addresses the underlying JMX exploits.</p>
-</div>
-<div class="paragraph">
-<p>Upgrading to Apache James 3.7.4 is thus advised.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_cve_2022_45935_temporary_file_information_disclosure_in_apache_james"><a class="anchor" href="#_cve_2022_45935_temporary_file_information_disclosure_in_apache_james"></a>CVE-2022-45935: Temporary File Information Disclosure in Apache JAMES</h3>
-<div class="paragraph">
-<p>Apache James distribution prior to release 3.7.3 is vulnerable to a temporary File Information Disclosure.</p>
-</div>
-<div class="paragraph">
-<p><strong>Severity</strong>: Moderate</p>
-</div>
-<div class="paragraph">
-<p><strong>Mitigation</strong>: We recommend to upgrade to Apache James 3.7.3 or higher, which fixes this vulnerability.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_cve_2021_44228_starttls_command_injection_in_apache_james"><a class="anchor" href="#_cve_2021_44228_starttls_command_injection_in_apache_james"></a>CVE-2021-44228: STARTTLS command injection in Apache JAMES</h3>
-<div class="paragraph">
-<p>Apache James distribution prior to release 3.7.1 is vulnerable to a buffering attack relying on the use of the STARTTLS command.</p>
-</div>
-<div class="paragraph">
-<p>Fix of CVE-2021-38542, which solved similar problem from Apache James 3.6.1, is subject to a parser differential and do not take into account concurrent requests.</p>
-</div>
-<div class="paragraph">
-<p><strong>Severity</strong>: Moderate</p>
-</div>
-<div class="paragraph">
-<p><strong>Mitigation</strong>: We recommend to upgrade to Apache James 3.7.1 or higher, which fixes this vulnerability.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_cve_2021_38542_apache_james_vulnerable_to_starttls_command_injection_imap_and_pop3"><a class="anchor" href="#_cve_2021_38542_apache_james_vulnerable_to_starttls_command_injection_imap_and_pop3"></a>CVE-2021-38542: Apache James vulnerable to STARTTLS command injection (IMAP and POP3)</h3>
-<div class="paragraph">
-<p>Apache James prior to release 3.6.1 is vulnerable to a buffering attack relying on the use of the STARTTLS
-command. This can result in Man-in -the-middle command injection attacks, leading potentially to leakage
-of sensible information.</p>
-</div>
-<div class="paragraph">
-<p><strong>Severity</strong>: Moderate</p>
-</div>
-<div class="paragraph">
-<p>This issue is being tracked as <a href="https://issues.apache.org/jira/browse/JAMES-1862">JAMES-1862</a></p>
-</div>
-<div class="paragraph">
-<p><strong>Mitigation</strong>: We recommend upgrading to Apache James 3.6.1, which fixes this vulnerability.</p>
-</div>
-<div class="paragraph">
-<p>Furthermore, we recommend, if possible to dis-activate STARTTLS and rely solely on explicit TLS for mail protocols, including SMTP, IMAP and POP3.</p>
-</div>
-<div class="paragraph">
-<p>Read more <a href="https://nostarttls.secvuln.info/">about STARTTLS security here</a>.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_cve_2021_40110_apache_james_imap_vulnerable_to_a_redos"><a class="anchor" href="#_cve_2021_40110_apache_james_imap_vulnerable_to_a_redos"></a>CVE-2021-40110: Apache James IMAP vulnerable to a ReDoS</h3>
-<div class="paragraph">
-<p>Using Jazzer fuzzer, we identified that an IMAP user can craft IMAP LIST commands to orchestrate a Denial
-Of Service using a vulnerable Regular expression. This affected Apache James prior to 3.6.1</p>
-</div>
-<div class="paragraph">
-<p><strong>Severity</strong>: Moderate</p>
-</div>
-<div class="paragraph">
-<p>This issue is being tracked as <a href="https://issues.apache.org/jira/browse/JAMES-3635">JAMES-3635</a></p>
-</div>
-<div class="paragraph">
-<p><strong>Mitigation</strong>: We recommend upgrading to Apache James 3.6.1, which enforce the use of RE2J regular
-expression engine to execute regex in linear time without back-tracking.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_cve_2021_40111_apache_james_imap_parsing_denial_of_service"><a class="anchor" href="#_cve_2021_40111_apache_james_imap_parsing_denial_of_service"></a>CVE-2021-40111: Apache James IMAP parsing Denial Of Service</h3>
-<div class="paragraph">
-<p>While fuzzing with Jazzer the IMAP parsing stack we discover that crafted APPEND and STATUS IMAP command
-could be used to trigger infinite loops resulting in expensive CPU computations and OutOfMemory exceptions.
-This can be used for a Denial Of Service attack. The IMAP user needs to be authenticated to exploit this
-vulnerability. This affected Apache James prior to version 3.6.1.</p>
-</div>
-<div class="paragraph">
-<p><strong>Severity</strong>: Moderate</p>
-</div>
-<div class="paragraph">
-<p>This issue is being tracked as <a href="https://issues.apache.org/jira/browse/JAMES-3634">JAMES-3634</a></p>
-</div>
-<div class="paragraph">
-<p><strong>Mitigation</strong>: We recommend upgrading to Apache James 3.6.1, which fixes this vulnerability.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_cve_2021_40525_apache_james_sieve_file_storage_vulnerable_to_path_traversal_attacks"><a class="anchor" href="#_cve_2021_40525_apache_james_sieve_file_storage_vulnerable_to_path_traversal_attacks"></a>CVE-2021-40525: Apache James: Sieve file storage vulnerable to path traversal attacks</h3>
-<div class="paragraph">
-<p>Apache James ManagedSieve implementation alongside with the file storage for sieve scripts is vulnerable
-to path traversal, allowing reading and writing any file.</p>
-</div>
-<div class="paragraph">
-<p><strong>Severity</strong>: Moderate</p>
-</div>
-<div class="paragraph">
-<p>This issue is being tracked as <a href="https://issues.apache.org/jira/browse/JAMES-3646">JAMES-3646</a></p>
-</div>
-<div class="paragraph">
-<p><strong>Mitigation</strong>:This vulnerability had been patched in Apache James 3.6.1 and higher. We recommend the upgrade.</p>
-</div>
-<div class="paragraph">
-<p>This could also be mitigated by ensuring manageSieve is disabled, which is the case by default.</p>
-</div>
-<div class="paragraph">
-<p>Distributed and Cassandra based products are also not impacted.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_cve_2017_12628_privilege_escalation_using_jmx"><a class="anchor" href="#_cve_2017_12628_privilege_escalation_using_jmx"></a>CVE-2017-12628 Privilege escalation using JMX</h3>
-<div class="paragraph">
-<p>The Apache James Server prior version 3.0.1 is vulnerable to Java deserialization issues.
-One can use this for privilege escalation.
-This issue can be mitigated by:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Upgrading to James 3.0.1 onward</p>
-</li>
-<li>
-<p>Using a recent JRE (Exploit could not be reproduced on OpenJdk 8 u141)</p>
-</li>
-<li>
-<p>Exposing JMX socket only to localhost (default behaviour)</p>
-</li>
-<li>
-<p>Possibly running James in a container</p>
-</li>
-<li>
-<p>Disabling JMX all-together (Guice only)</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Read more <a href="http://james.apache.org//james/update/2017/10/20/james-3.0.1.html">here</a>.</p>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/operate/webadmin.html b/james-distributed-app/3.8.0/operate/webadmin.html
deleted file mode 100644
index 6f4821c..0000000
--- a/james-distributed-app/3.8.0/operate/webadmin.html
+++ /dev/null
@@ -1,8354 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — WebAdmin REST administration API :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="logging.html">Logging</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Operate</a></li>
- <li><a href="webadmin.html">WebAdmin REST administration API</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/operate/webadmin.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — WebAdmin REST administration API</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>The web administration supports for now the CRUD operations on the domains, the users, their mailboxes and their quotas,
- managing mail repositories, performing cassandra migrations, and much more, as described in the following sections.</p>
-</div>
-<div class="paragraph">
-<p><strong>WARNING</strong>: 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>
-</div>
-<div class="paragraph">
-<p>By the way, some endpoints are not filtered by authentication. Those endpoints are not related to data stored in James,
-for example: Swagger documentation & James health checks.</p>
-</div>
-<div class="paragraph">
-<p>In case of any error, the system will return an error message which is
-json format like this:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- statusCode: <error_code>,
- type: <error_type>,
- message: <the_error_message>
- cause: <the_detail_message_from_throwable>
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Also be aware that, in case things go wrong, all endpoints might return
-a 500 internal error (with a JSON body formatted as exposed above). To
-avoid information duplication, this is omitted on endpoint specific
-documentation.</p>
-</div>
-<div class="paragraph">
-<p>Finally, please note that in case of a malformed URL the 400 bad request
-response will contain an HTML body.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_healthcheck"><a class="anchor" href="#_healthcheck"></a>HealthCheck</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_check_all_components"><a class="anchor" href="#_check_all_components"></a>Check all components</h3>
-<div class="paragraph">
-<p>This endpoint is simple for now and is just returning the http status
-code corresponding to the state of checks (see below). The user has to
-check in the logs in order to have more information about failing
-checks.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/healthcheck</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return a list of healthChecks execution result, with an aggregated
-result:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "status": "healthy",
- "checks": [
- {
- "componentName": "Cassandra backend",
- "escapedComponentName": "Cassandra%20backend",
- "status": "healthy"
- "cause": null
- }
- ]
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>status</strong> field can be:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>healthy</strong>: Component works normally</p>
-</li>
-<li>
-<p><strong>degraded</strong>: Component works in degraded mode. Some non-critical
-services may not be working, or latencies are high, for example. Cause
-contains explanations.</p>
-</li>
-<li>
-<p><strong>unhealthy</strong>: The component is currently not working. Cause contains
-explanations.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Supported health checks include:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>Cassandra backend</strong>: Cassandra storage.</p>
-</li>
-<li>
-<p><strong>OpenSearch Backend</strong>: OpenSearch storage.</p>
-</li>
-<li>
-<p><strong>EventDeadLettersHealthCheck</strong></p>
-</li>
-<li>
-<p><strong>Guice application lifecycle</strong></p>
-</li>
-<li>
-<p><strong>JPA Backend</strong>: JPA storage.</p>
-</li>
-<li>
-<p><strong>MailReceptionCheck</strong> We rely on a configured user, send an email to him and
-assert that the email is well received, and can be read within the given configured
-period. Unhealthy means that the email could not be received before reacing the timeout.</p>
-</li>
-<li>
-<p><strong>MessageFastViewProjection</strong> Health check of the component storing JMAP properties
-which are fast to retrieve. Those properties are computed in advance
-from messages and persisted in order to archive a better performance.
-There are some latencies between a source update and its projections
-updates. Incoherency problems arise when reads are performed in this
-time-window. We piggyback the projection update on missed JMAP read in
-order to decrease the outdated time window for a given entry. The health
-is determined by the ratio of missed projection reads. (lower than 10%
-causes <code>degraded</code>)</p>
-</li>
-<li>
-<p><strong>RabbitMQ backend</strong>: RabbitMQ messaging.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: All checks have answered with a Healthy or Degraded status. James
-services can still be used.</p>
-</li>
-<li>
-<p>503: At least one check have answered with a Unhealthy status</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_check_single_component"><a class="anchor" href="#_check_single_component"></a>Check single component</h3>
-<div class="paragraph">
-<p>Performs a health check for the given component. The component is
-referenced by its URL encoded name.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/healthcheck/checks/Cassandra%20backend</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the component’s name, the component’s escaped name, the
-health status and a cause.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "componentName": "Cassandra backend",
- "escapedComponentName": "Cassandra%20backend",
- "status": "healthy"
- "cause": null
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The check has answered with a Healthy or Degraded status.</p>
-</li>
-<li>
-<p>404: A component with the given name was not found.</p>
-</li>
-<li>
-<p>503: The check has answered with an Unhealthy status.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_list_all_health_checks"><a class="anchor" href="#_list_all_health_checks"></a>List all health checks</h3>
-<div class="paragraph">
-<p>This endpoint lists all the available health checks.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/healthcheck/checks</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the list of all available health checks.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[
- {
- "componentName": "Cassandra backend",
- "escapedComponentName": "Cassandra%20backend"
- }
-]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: List of available health checks</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_task_management"><a class="anchor" href="#_task_management"></a>Task management</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Some webadmin features schedule tasks. The task management API allow to
-monitor and manage the execution of the following tasks.</p>
-</div>
-<div class="paragraph">
-<p>Note that the <code>taskId</code> used in the following APIs is returned by other
-WebAdmin APIs scheduling tasks.</p>
-</div>
-<div class="sect2">
-<h3 id="_getting_a_task_details"><a class="anchor" href="#_getting_a_task_details"></a>Getting a task details</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/tasks/3294a976-ce63-491e-bd52-1b6f465ed7a2</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>An Execution Report will be returned:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<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": "type-of-the-task"
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note that:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>status</code> can have the value:</p>
-<div class="ulist">
-<ul>
-<li>
-<p><code>waiting</code>: The task is scheduled but its execution did not start yet</p>
-</li>
-<li>
-<p><code>inProgress</code>: The task is currently executed</p>
-</li>
-<li>
-<p><code>cancelled</code>: The task had been cancelled</p>
-</li>
-<li>
-<p><code>completed</code>: The task execution is finished, and this execution is a
-success</p>
-</li>
-<li>
-<p><code>failed</code>: The task execution is finished, and this execution is a
-failure</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p><code>additionalInformation</code> is a task specific object giving additional
-information and context about that task. The structure of this
-<code>additionalInformation</code> field is provided along the specific task
-submission endpoint.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The specific task was found and the execution report exposed
-above is returned</p>
-</li>
-<li>
-<p>400: Invalid task ID</p>
-</li>
-<li>
-<p>404: Task ID was not found</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_awaiting_a_task"><a class="anchor" href="#_awaiting_a_task"></a>Awaiting a task</h3>
-<div class="paragraph">
-<p>One can await the end of a task, then receive its final execution
-report.</p>
-</div>
-<div class="paragraph">
-<p>That feature is especially usefully for testing purpose but still can
-serve real-life scenario.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/tasks/3294a976-ce63-491e-bd52-1b6f465ed7a2/await?timeout=duration</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>An Execution Report will be returned.</p>
-</div>
-<div class="paragraph">
-<p><code>timeout</code> is optional. By default it is set to 365 days (the maximum
-value). The expected value is expressed in the following format:
-<code>Nunit</code>. <code>N</code> should be strictly positive. <code>unit</code> could be either in the
-short form (<code>s</code>, <code>m</code>, <code>h</code>, etc.), or in the long form (<code>day</code>, <code>week</code>,
-<code>month</code>, etc.).</p>
-</div>
-<div class="paragraph">
-<p>Examples:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>30s</code></p>
-</li>
-<li>
-<p><code>5m</code></p>
-</li>
-<li>
-<p><code>7d</code></p>
-</li>
-<li>
-<p><code>1y</code></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The specific task was found and the execution report exposed
-above is returned</p>
-</li>
-<li>
-<p>400: Invalid task ID or invalid timeout</p>
-</li>
-<li>
-<p>404: Task ID was not found</p>
-</li>
-<li>
-<p>408: The timeout has been reached</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_cancelling_a_task"><a class="anchor" href="#_cancelling_a_task"></a>Cancelling a task</h3>
-<div class="paragraph">
-<p>You can cancel a task by calling:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/tasks/3294a976-ce63-491e-bd52-1b6f465ed7a2</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Task had been cancelled</p>
-</li>
-<li>
-<p>400: Invalid task ID</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_listing_tasks"><a class="anchor" href="#_listing_tasks"></a>Listing tasks</h3>
-<div class="paragraph">
-<p>A list of all tasks can be retrieved:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/tasks</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return a list of Execution reports</p>
-</div>
-<div class="paragraph">
-<p>One can filter the above results by status. For example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/tasks?status=inProgress</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return a list of Execution reports that are currently in progress. This list is sorted by
-reverse submitted date (recent tasks goes first).</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: A list of corresponding tasks is returned</p>
-</li>
-<li>
-<p>400: Invalid status value</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Additional optional task parameters are supported:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>status</code> one of <code>waiting</code>, <code>inProgress</code>, <code>canceledRequested</code>, <code>completed</code>, <code>canceled</code>, <code>failed</code>. Only
-tasks with the given status are returned.</p>
-</li>
-<li>
-<p><code>type</code>: only tasks with the given type are returned.</p>
-</li>
-<li>
-<p><code>submittedBefore</code>: Date. Returns only tasks submitted before this date.</p>
-</li>
-<li>
-<p><code>submittedAfter</code>: Date. Returns only tasks submitted after this date.</p>
-</li>
-<li>
-<p><code>startedBefore</code>: Date. Returns only tasks started before this date.</p>
-</li>
-<li>
-<p><code>startedAfter</code>: Date. Returns only tasks started after this date.</p>
-</li>
-<li>
-<p><code>completedBefore</code>: Date. Returns only tasks completed before this date.</p>
-</li>
-<li>
-<p><code>completedAfter</code>: Date. Returns only tasks completed after this date.</p>
-</li>
-<li>
-<p><code>failedBefore</code>: Date. Returns only tasks failed before this date.</p>
-</li>
-<li>
-<p><code>failedAfter</code>: Date. Returns only tasks faield after this date.</p>
-</li>
-<li>
-<p><code>offset</code>: Integer, number of tasks to skip in the response. Useful for paging.</p>
-</li>
-<li>
-<p><code>limit</code>: Integer, maximum number of tasks to return in one call</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Example of date format: <code>2023-04-15T07:23:27.541254+07:00</code> and <code>2023-04-15T07%3A23%3A27.541254%2B07%3A00</code> once URL encoded.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_endpoints_returning_a_task"><a class="anchor" href="#_endpoints_returning_a_task"></a>Endpoints returning a task</h3>
-<div class="paragraph">
-<p>Many endpoints do generate a task.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /endpoint?action={action}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The response to these requests will be the scheduled <code>taskId</code> :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"taskId":"5641376-02ed-47bd-bcc7-76ff6262d92a"}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Positionned headers:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Location header indicates the location of the resource associated with
-the scheduled task. Example:</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>Location: /tasks/3294a976-ce63-491e-bd52-1b6f465ed7a2</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Task generation succeeded. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>Other response codes might be returned depending on the endpoint</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The additional information returned depends on the scheduled task type
-and is documented in the endpoint documentation.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_administrating_domains"><a class="anchor" href="#_administrating_domains"></a>Administrating domains</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_create_a_domain"><a class="anchor" href="#_create_a_domain"></a>Create a domain</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/domains/domainToBeCreated</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name domainToBeCreated:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>can not be null or empty</p>
-</li>
-<li>
-<p>can not contain `@'</p>
-</li>
-<li>
-<p>can not be more than 255 characters</p>
-</li>
-<li>
-<p>can not contain `/'</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The domain was successfully added</p>
-</li>
-<li>
-<p>400: The domain name is invalid</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_delete_a_domain"><a class="anchor" href="#_delete_a_domain"></a>Delete a domain</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/domains/{domainToBeDeleted}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note: Deletion of an auto-detected domain, default domain or of an
-auto-detected ip is not supported. We encourage you instead to review
-your <a href="https://james.apache.org/server/config-domainlist.html">domain list
-configuration</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The domain was successfully removed</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_test_if_a_domain_exists"><a class="anchor" href="#_test_if_a_domain_exists"></a>Test if a domain exists</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/domains/{domainName}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The domain exists</p>
-</li>
-<li>
-<p>404: The domain does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_get_the_list_of_domains"><a class="anchor" href="#_get_the_list_of_domains"></a>Get the list of domains</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/domains</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Possible response:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>["domain1", "domain2"]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The domain list was successfully retrieved</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_get_the_list_of_aliases_for_a_domain"><a class="anchor" href="#_get_the_list_of_aliases_for_a_domain"></a>Get the list of aliases for a domain</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/domains/destination.domain.tld/aliases</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Possible response:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[
- {"source": "source1.domain.tld"},
- {"source": "source2.domain.tld"}
-]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>When sending an email to an email address having <code>source1.domain.tld</code> or
-<code>source2.domain.tld</code> as a domain part (example:
-<code>user@source1.domain.tld</code>), then the domain part will be rewritten into
-destination.domain.tld (so into <code>user@destination.domain.tld</code>).</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The domain aliases was successfully retrieved</p>
-</li>
-<li>
-<p>400: destination.domain.tld has an invalid syntax</p>
-</li>
-<li>
-<p>404: destination.domain.tld is not part of handled domains and does
-not have local domains as aliases.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_create_an_alias_for_a_domain"><a class="anchor" href="#_create_an_alias_for_a_domain"></a>Create an alias for a domain</h3>
-<div class="paragraph">
-<p>To create a domain alias execute the following query:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/domains/destination.domain.tld/aliases/source.domain.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>When sending an email to an email address having <code>source.domain.tld</code> as
-a domain part (example: <code>user@source.domain.tld</code>), then the domain part
-will be rewritten into <code>destination.domain.tld</code> (so into
-<code>user@destination.domain.tld</code>).</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The redirection now exists</p>
-</li>
-<li>
-<p>400: <code>source.domain.tld</code> or <code>destination.domain.tld</code> have an invalid
-syntax</p>
-</li>
-<li>
-<p>400: <code>source, domain</code> and <code>destination domain</code> are the same</p>
-</li>
-<li>
-<p>404: <code>source.domain.tld</code> are not part of handled domains.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Be aware that no checks to find possible loops that would result of this creation will be performed.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_delete_an_alias_for_a_domain"><a class="anchor" href="#_delete_an_alias_for_a_domain"></a>Delete an alias for a domain</h3>
-<div class="paragraph">
-<p>To delete a domain alias execute the following query:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/domains/destination.domain.tld/aliases/source.domain.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>When sending an email to an email address having <code>source.domain.tld</code> as
-a domain part (example: <code>user@source.domain.tld</code>), then the domain part
-will be rewritten into <code>destination.domain.tld</code> (so into
-<code>user@destination.domain.tld</code>).</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The redirection now no longer exists</p>
-</li>
-<li>
-<p>400: <code>source.domain.tld</code> or destination.domain.tld have an invalid
-syntax</p>
-</li>
-<li>
-<p>400: source, domain and destination domain are the same</p>
-</li>
-<li>
-<p>404: <code>source.domain.tld</code> are not part of handled domains.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_delete_all_users_data_of_a_domain"><a class="anchor" href="#_delete_all_users_data_of_a_domain"></a>Delete all users data of a domain</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/domains/{domainToBeUsed}?action=deleteData</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Would create a task that deletes data of all users of the domain.</p>
-</div>
-<div class="paragraph">
-<p>[More details about endpoints returning a task](#_endpoints_returning_a_task).</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Error in the request. Details can be found in the reported error.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>DeleteUsersDataOfDomainTask</code> and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type": "DeleteUsersDataOfDomainTask",
- "domain": "domain.tld",
- "successfulUsersCount": 2,
- "failedUsersCount": 1,
- "failedUsers": ["faileduser@domain.tld"],
- "timestamp": "2023-05-22T08:52:47.076261Z"
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Notes: <code>failedUsers</code> only lists maximum 100 failed users.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_administrating_users"><a class="anchor" href="#_administrating_users"></a>Administrating users</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_create_a_user"><a class="anchor" href="#_create_a_user"></a>Create a user</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/users/usernameToBeUsed \
- -d '{"password":"passwordToBeUsed"}' \
- -H "Content-Type: application/json"</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name usernameToBeUsed representing valid users, hence it should
-match the criteria at <a href="../configure/usersrepository.html" class="xref page">User Repositories documentation</a></p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The user was successfully created</p>
-</li>
-<li>
-<p>400: The user name or the payload is invalid</p>
-</li>
-<li>
-<p>409: The user name already exists</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Note: If the user exists already, its password cannot be updated using this.
-If you want to update a user’s password, please have a look at <strong>Update a user password</strong> below.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_updating_a_user_password"><a class="anchor" href="#_updating_a_user_password"></a>Updating a user password</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/users/usernameToBeUsed?force \
- -d '{"password":"passwordToBeUsed"}' \
- -H "Content-Type: application/json"</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The user’s password was successfully updated</p>
-</li>
-<li>
-<p>400: The user name or the payload is invalid</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This also can be used to create a new user.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_verifying_a_user_password"><a class="anchor" href="#_verifying_a_user_password"></a>Verifying a user password</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/users/usernameToBeUsed/verify \
- -d '{"password":"passwordToBeVerified"}' \
- -H "Content-Type: application/json"</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The user’s password was correct</p>
-</li>
-<li>
-<p>401: Wrong password or user does not exist</p>
-</li>
-<li>
-<p>400: The user name or the payload is invalid</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This intentionally treats non-existing users as unauthenticated, to prevent a username oracle attack.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_testing_a_user_existence"><a class="anchor" href="#_testing_a_user_existence"></a>Testing a user existence</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XHEAD http://ip:port/users/usernameToBeUsed</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name ``usernameToBeUsed'' represents a valid user, hence it
-should match the criteria at <a href="../configure/usersrepository.html" class="xref page">User Repositories documentation</a></p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The user exists</p>
-</li>
-<li>
-<p>400: The user name is invalid</p>
-</li>
-<li>
-<p>404: The user does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_deleting_a_user"><a class="anchor" href="#_deleting_a_user"></a>Deleting a user</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/users/{userToBeDeleted}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The user was successfully deleted</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_retrieving_the_user_list"><a class="anchor" href="#_retrieving_the_user_list"></a>Retrieving the user list</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/users</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[{"username":"username@domain-jmapauthentication.tld"},{"username":"username@domain.tld"}]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The user name list was successfully retrieved</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_retrieving_the_list_of_allowed_from_headers_for_a_given_user"><a class="anchor" href="#_retrieving_the_list_of_allowed_from_headers_for_a_given_user"></a>Retrieving the list of allowed <code>From</code> headers for a given user</h3>
-<div class="paragraph">
-<p>This endpoint allows to know which From headers a given user is allowed to use when sending mails.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/users/givenUser/allowedFromHeaders</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>["user@domain.tld","alias@domain.tld"]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The list was successfully retrieved</p>
-</li>
-<li>
-<p>400: The user is invalid</p>
-</li>
-<li>
-<p>404: The user is unknown</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_add_a_delegated_user_of_a_base_user"><a class="anchor" href="#_add_a_delegated_user_of_a_base_user"></a>Add a delegated user of a base user</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/users/baseUser/authorizedUsers/delegatedUser</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Addition of the delegated user succeeded</p>
-</li>
-<li>
-<p>404: The base user does not exist</p>
-</li>
-<li>
-<p>400: The delegated user does not exist</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Note: Delegation is only available on top of Cassandra products and not implemented yet on top of JPA backends.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_remove_a_delegated_user_of_a_base_user"><a class="anchor" href="#_remove_a_delegated_user_of_a_base_user"></a>Remove a delegated user of a base user</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/users/baseUser/authorizedUsers/delegatedUser</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Removal of the delegated user succeeded</p>
-</li>
-<li>
-<p>404: The base user does not exist</p>
-</li>
-<li>
-<p>400: The delegated user does not exist</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Note: Delegation is only available on top of Cassandra products and not implemented yet on top of JPA backends.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_retrieving_the_list_of_delegated_users_of_a_base_user"><a class="anchor" href="#_retrieving_the_list_of_delegated_users_of_a_base_user"></a>Retrieving the list of delegated users of a base user</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/users/baseUser/authorizedUsers</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>["alice@domain.tld","bob@domain.tld"]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The list was successfully retrieved</p>
-</li>
-<li>
-<p>404: The base user does not exist</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Note: Delegation is only available on top of Cassandra products and not implemented yet on top of JPA backends.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_remove_all_delegated_users_of_a_base_user"><a class="anchor" href="#_remove_all_delegated_users_of_a_base_user"></a>Remove all delegated users of a base user</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/users/baseUser/authorizedUsers</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Removal of the delegated users succeeded</p>
-</li>
-<li>
-<p>404: The base user does not exist</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Note: Delegation is only available on top of Cassandra products and not implemented yet on top of JPA backends.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_change_a_username"><a class="anchor" href="#_change_a_username"></a>Change a username</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/users/oldUser/rename/newUser?action=rename</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Would migrate account data from <code>oldUser</code> to <code>newUser</code>.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Implemented migration steps are:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>ForwardUsernameChangeTaskStep</code>: creates forward from old user to new user and migrates existing forwards</p>
-</li>
-<li>
-<p><code>FilterUsernameChangeTaskStep</code>: migrates users filtering rules</p>
-</li>
-<li>
-<p><code>DelegationUsernameChangeTaskStep</code>: migrates delegations where the impacted user is either delegatee or delegator</p>
-</li>
-<li>
-<p><code>MailboxUsernameChangeTaskStep</code>: migrates mailboxes belonging to the old user to the account of the new user. It also
-migrates user’s mailbox subscriptions.</p>
-</li>
-<li>
-<p><code>ACLUsernameChangeTaskStep</code>: migrates ACLs on mailboxes the migrated user has access to and updates subscriptions accordingly.</p>
-</li>
-<li>
-<p><code>QuotaUsernameChangeTaskStep</code>: migrates quotas user from old user to new user.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Error in the request. Details can be found in the reported error.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The <code>fromStep</code> query parameter allows skipping previous steps, allowing to resume the username change from a failed step.</p>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>UsernameChangeTask</code> and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type": "UsernameChangeTask",
- "oldUser": "jessy.jones@domain.tld",
- "newUser": "jessy.smith@domain.tld",
- "status": {
- "A": "DONE",
- "B": "FAILED",
- "C": "ABORTED"
- },
- "fromStep": null,
- "timestamp": "2023-02-17T02:54:01.246477Z"
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Valid status includes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>SKIPPED</code>: bypassed via <code>fromStep</code> setting</p>
-</li>
-<li>
-<p><code>WAITING</code>: Awaits execution</p>
-</li>
-<li>
-<p><code>IN_PROGRESS</code>: Currently executed</p>
-</li>
-<li>
-<p><code>FAILED</code>: Error encountered while executing this step. Check the logs.</p>
-</li>
-<li>
-<p><code>ABORTED</code>: Won’t be executed because of previous step failures.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_delete_data_of_a_user"><a class="anchor" href="#_delete_data_of_a_user"></a>Delete data of a user</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/users/usernameToBeUsed?action=deleteData</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Would create a task that deletes data of the user.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Implemented deletion steps are:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>RecipientRewriteTableUserDeletionTaskStep</code>: deletes all rewriting rules related to this user.</p>
-</li>
-<li>
-<p><code>FilterUserDeletionTaskStep</code>: deletes all filters belonging to the user.</p>
-</li>
-<li>
-<p><code>DelegationUserDeletionTaskStep</code>: deletes all delegations from / to the user.</p>
-</li>
-<li>
-<p><code>MailboxUserDeletionTaskStep</code>: deletes mailboxes of this user, all ACLs of this user, as well as his subscriptions.</p>
-</li>
-<li>
-<p><code>WebPushUserDeletionTaskStep</code>: deletes push data registered for this user.</p>
-</li>
-<li>
-<p><code>IdentityUserDeletionTaskStep</code>: deletes identities registered for this user.</p>
-</li>
-<li>
-<p><code>VacationUserDeletionTaskStep</code>: deletes vacations registered for this user.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Error in the request. Details can be found in the reported error.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The <code>fromStep</code> query parameter allows skipping previous steps, allowing to resume the user data deletion from a failed step.</p>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>DeleteUserDataTask</code> and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type": "DeleteUserDataTask",
- "username": "jessy.jones@domain.tld",
- "status": {
- "A": "DONE",
- "B": "FAILED",
- "C": "ABORTED"
- },
- "fromStep": null,
- "timestamp": "2023-02-17T02:54:01.246477Z"
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Valid status includes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>SKIPPED</code>: bypassed via <code>fromStep</code> setting</p>
-</li>
-<li>
-<p><code>WAITING</code>: Awaits execution</p>
-</li>
-<li>
-<p><code>IN_PROGRESS</code>: Currently executed</p>
-</li>
-<li>
-<p><code>FAILED</code>: Error encountered while executing this step. Check the logs.</p>
-</li>
-<li>
-<p><code>ABORTED</code>: Won’t be executed because of previous step failures.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_retrieving_the_user_identities"><a class="anchor" href="#_retrieving_the_user_identities"></a>Retrieving the user identities</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/users/{baseUser}/identities?default=true</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>API to get the list of identities of a user</p>
-</div>
-<div class="paragraph">
-<p>The response will look like:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">[
- {
- "name":"identity name 1",
- "email":"bob@domain.tld",
- "id":"4c039533-75b9-45db-becc-01fb0e747aa8",
- "mayDelete":true,
- "textSignature":"textSignature 1",
- "htmlSignature":"htmlSignature 1",
- "sortOrder":1,
- "bcc":[
- {
- "emailerName":"bcc name 1",
- "mailAddress":"bcc1@domain.org"
- }
- ],
- "replyTo":[
- {
- "emailerName":"reply name 1",
- "mailAddress":"reply1@domain.org"
- }
- ]
- }
-]</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Query parameters:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>default: (Optional) allows getting the default identity of a user. In order to do that: <code>default=true</code></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The list was successfully retrieved</p>
-</li>
-<li>
-<p>400: The user is invalid</p>
-</li>
-<li>
-<p>404: The user is unknown or the default identity can not be found.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The optional <code>default</code> query parameter allows getting the default identity of a user.
-In order to do that: <code>default=true</code></p>
-</div>
-<div class="paragraph">
-<p>The web-admin server will return <code>404</code> response code when the default identity can not be found.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_creating_a_jmap_user_identity"><a class="anchor" href="#_creating_a_jmap_user_identity"></a>Creating a JMAP user identity</h3>
-<div class="paragraph">
-<p>API to create a new JMAP user identity</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/users/{username}/identities \
--d '{
- "name": "Bob",
- "email": "bob@domain.tld",
- "mayDelete": true,
- "htmlSignature": "a html signature",
- "textSignature": "a text signature",
- "bcc": [{
- "email": "boss2@domain.tld",
- "name": "My Boss 2"
- }],
- "replyTo": [{
- "email": "boss@domain.tld",
- "name": "My Boss"
- }],
- "sortOrder": 0
- }' \
--H "Content-Type: application/json"</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: The new identity was successfully created</p>
-</li>
-<li>
-<p>404: The username is unknown</p>
-</li>
-<li>
-<p>400: The payload is invalid</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Resource name ``username'' represents a valid user</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_updating_a_jmap_user_identity"><a class="anchor" href="#_updating_a_jmap_user_identity"></a>Updating a JMAP user identity</h3>
-<div class="paragraph">
-<p>API to update an exist JMAP user identity</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/users/{username}/identities/{identityId} \
--d '{
- "name": "Bob",
- "htmlSignature": "a html signature",
- "textSignature": "a text signature",
- "bcc": [{
- "email": "boss2@domain.tld",
- "name": "My Boss 2"
- }],
- "replyTo": [{
- "email": "boss@domain.tld",
- "name": "My Boss"
- }],
- "sortOrder": 1
- }' \
--H "Content-Type: application/json"</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The identity were successfully updated</p>
-</li>
-<li>
-<p>404: The username is unknown</p>
-</li>
-<li>
-<p>400: The payload is invalid</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Resource name <code>username'' represents a valid user
-Resource name </code>identityId'' represents a exist user identity</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_administrating_vacation_settings"><a class="anchor" href="#_administrating_vacation_settings"></a>Administrating vacation settings</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_get_vacation_settings"><a class="anchor" href="#_get_vacation_settings"></a>Get vacation settings</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/vacation/usernameToBeUsed</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name usernameToBeUsed representing valid users, hence it should
-match the criteria at <a href="../configure/usersrepository.html" class="xref page">User Repositories documentation</a></p>
-</div>
-<div class="paragraph">
-<p>The response will look like this:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "enabled": true,
- "fromDate": "2021-09-20T10:00:00Z",
- "toDate": "2021-09-27T18:00:00Z",
- "subject": "Out of office",
- "textBody": "I am on vacation, will be back soon.",
- "htmlBody": "<p>I am on vacation, will be back soon.</p>"
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The vacation settings were successfully retrieved</p>
-</li>
-<li>
-<p>404: The user name is unknown</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_update_vacation_settings"><a class="anchor" href="#_update_vacation_settings"></a>Update vacation settings</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/vacation/usernameToBeUsed</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Request body must be a JSON structure as described above.</p>
-</div>
-<div class="paragraph">
-<p>If any field is not set in the request, the corresponding field in the existing vacation message is left unchanged.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The vacation settings were successfully updated</p>
-</li>
-<li>
-<p>404: The user name is unknown</p>
-</li>
-<li>
-<p>400: The payload is invalid</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_delete_vacation_settings"><a class="anchor" href="#_delete_vacation_settings"></a>Delete vacation settings</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/vacation/usernameToBeUsed</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>For convenience, this disables and clears the existing vacation settings of the user.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The vacation settings were successfully disabled</p>
-</li>
-<li>
-<p>404: The user name is unknown</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_administrating_mailboxes"><a class="anchor" href="#_administrating_mailboxes"></a>Administrating mailboxes</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_all_mailboxes"><a class="anchor" href="#_all_mailboxes"></a>All mailboxes</h3>
-<div class="paragraph">
-<p>Several actions can be performed on the server mailboxes.</p>
-</div>
-<div class="paragraph">
-<p>Request pattern is:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /mailboxes?action={action1},...</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Error in the request. Details can be found in the reported error.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The kind of task scheduled depends on the action parameter. See below
-for details.</p>
-</div>
-<div class="sect3">
-<h4 id="_fixing_mailboxes_inconsistencies"><a class="anchor" href="#_fixing_mailboxes_inconsistencies"></a>Fixing mailboxes inconsistencies</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /mailboxes?task=SolveInconsistencies</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule a task for fixing inconsistencies for the mailbox
-deduplicated object stored in Cassandra.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>The <code>I-KNOW-WHAT-I-M-DOING</code> header is mandatory (you can read more
-information about it in the warning section below).</p>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type
-<code>solve-mailbox-inconsistencies</code> and the following
-<code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"solve-mailbox-inconsistencies",
- "processedMailboxEntries": 3,
- "processedMailboxPathEntries": 3,
- "fixedInconsistencies": 2,
- "errors": 1,
- "conflictingEntries":[{
- "mailboxDaoEntry":{
- "mailboxPath":"#private:user:mailboxName",
- "mailboxId":"464765a0-e4e7-11e4-aba4-710c1de3782b"
- }," +
- "mailboxPathDaoEntry":{
- "mailboxPath":"#private:user:mailboxName2",
- "mailboxId":"464765a0-e4e7-11e4-aba4-710c1de3782b"
- }
- }]
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note that conflicting entry inconsistencies will not be fixed and will
-require to explicitly use <a href="#_correcting_ghost_mailbox">ghost mailbox</a>
-endpoint in order to merge the conflicting mailboxes and prevent any
-message loss.</p>
-</div>
-<div class="paragraph">
-<p><strong>WARNING</strong>: this task can cancel concurrently running legitimate user
-operations upon dirty read. As such this task should be run offline.</p>
-</div>
-<div class="paragraph">
-<p>A dirty read is when data is read between the two writes of the
-denormalization operations (no isolation).</p>
-</div>
-<div class="paragraph">
-<p>In order to ensure being offline, stop the traffic on SMTP, JMAP and
-IMAP ports, for example via re-configuration or firewall rules.</p>
-</div>
-<div class="paragraph">
-<p>Due to all of those risks, a <code>I-KNOW-WHAT-I-M-DOING</code> header should be
-positioned to <code>ALL-SERVICES-ARE-OFFLINE</code> in order to prevent accidental
-calls.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_recomputing_mailbox_counters"><a class="anchor" href="#_recomputing_mailbox_counters"></a>Recomputing mailbox counters</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /mailboxes?task=RecomputeMailboxCounters</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will recompute counters (unseen & total count) for the mailbox object
-stored in Cassandra.</p>
-</div>
-<div class="paragraph">
-<p>Cassandra maintains a per mailbox projection for message count and
-unseen message count. As with any projection, it can go out of sync,
-leading to inconsistent results being returned to the client.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type
-<code>recompute-mailbox-counters</code> and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"recompute-mailbox-counters",
- "processedMailboxes": 3,
- "failedMailboxes": ["464765a0-e4e7-11e4-aba4-710c1de3782b"]
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note that conflicting inconsistencies entries will not be fixed and will
-require to explicitly use <a href="#_correcting_ghost_mailbox">ghost mailbox</a>
-endpoint in order to merge the conflicting mailboxes and prevent any
-message loss.</p>
-</div>
-<div class="paragraph">
-<p><strong>WARNING</strong>: this task do not take into account concurrent modifications
-upon a single mailbox counter recomputation. Rerunning the task will
-<em>eventually</em> provide the consistent result. As such we advise to run
-this task offline.</p>
-</div>
-<div class="paragraph">
-<p>In order to ensure being offline, stop the traffic on SMTP, JMAP and
-IMAP ports, for example via re-configuration or firewall rules.</p>
-</div>
-<div class="paragraph">
-<p><code>trustMessageProjection</code> query parameter can be set to <code>true</code>. Content
-of <code>messageIdTable</code> (listing messages by their mailbox context) table
-will be trusted and not compared against content of <code>imapUidTable</code> table
-(listing messages by their messageId mailbox independent identifier).
-This will result in a better performance running the task at the cost of
-safety in the face of message denormalization inconsistencies.</p>
-</div>
-<div class="paragraph">
-<p>Defaults to false, which generates additional checks. You can read
-<a href="https://github.com/apache/james-project/blob/master/src/adr/0022-cassandra-message-inconsistency.md">this
-ADR</a> to better understand the message projection and how it can become
-inconsistent.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_recomputing_global_jmap_fast_message_view_projection"><a class="anchor" href="#_recomputing_global_jmap_fast_message_view_projection"></a>Recomputing Global JMAP fast message view projection</h4>
-<div class="paragraph">
-<p>Message fast view projection stores message properties expected to be
-fast to fetch but are actually expensive to compute, in order for
-GetMessages operation to be fast to execute for these properties.</p>
-</div>
-<div class="paragraph">
-<p>These projection items are asynchronously computed on mailbox events.</p>
-</div>
-<div class="paragraph">
-<p>You can force the full projection recomputation by calling the following
-endpoint:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /mailboxes?task=recomputeFastViewProjectionItems</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule a task for recomputing the fast message view projection
-for all mailboxes.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>An admin can specify the concurrency that should be used when running
-the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>messagesPerSecond</code> rate at which messages should be processed, per
-second. Defaults to 10.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must have a strictly positive integer as a value
-and be passed as query parameters.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /mailboxes?task=recomputeFastViewProjectionItems&messagesPerSecond=20</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type
-<code>RecomputeAllFastViewProjectionItemsTask</code> and the following
-<code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"RecomputeAllPreviewsTask",
- "processedUserCount": 3,
- "processedMessageCount": 3,
- "failedUserCount": 2,
- "failedMessageCount": 1,
- "runningOptions": {
- "messagesPerSecond":20
- }
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Error in the request. Details can be found in the reported error.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_populate_email_query_view"><a class="anchor" href="#_populate_email_query_view"></a>Populate email query view</h4>
-<div class="paragraph">
-<p>Email query view is an optional projection to offload common JMAP <code>Email/query</code> requests used for listing mails on Cassandra
-and not on the search index thus improving the overall reliability / performance on this operation.</p>
-</div>
-<div class="paragraph">
-<p>These projection items are asynchronously computed on mailbox events.</p>
-</div>
-<div class="paragraph">
-<p>You can populate this projection with the following request:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /mailboxes?task=populateEmailQueryView</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule a task for recomputing the fast message view projection
-for all mailboxes.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>An admin can specify the concurrency that should be used when running
-the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>messagesPerSecond</code> rate at which messages should be processed, per
-second. Defaults to 10.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must have a strictly positive integer as a value
-and be passed as query parameters.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /mailboxes?task=populateEmailQueryView&messagesPerSecond=20</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type
-<code>PopulateEmailQueryViewTask</code> and the following
-<code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"PopulateEmailQueryViewTask",
- "processedUserCount": 3,
- "processedMessageCount": 3,
- "failedUserCount": 2,
- "failedMessageCount": 1,
- "runningOptions": {
- "messagesPerSecond":20
- }
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Error in the request. Details can be found in the reported error.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_recomputing_cassandra_filtering_projection"><a class="anchor" href="#_recomputing_cassandra_filtering_projection"></a>Recomputing Cassandra filtering projection</h4>
-<div class="paragraph">
-<p>You can force the reset of the Cassandra filtering projection by calling the following
-endpoint:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /mailboxes?task=populateFilteringProjection</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule a task.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type
-<code>PopulateFilteringProjectionTask</code> and the following
-<code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"RecomputeAllPreviewsTask",
- "processedUserCount": 3,
- "failedUserCount": 2
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Error in the request. Details can be found in the reported error.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_reindexing_action"><a class="anchor" href="#_reindexing_action"></a>ReIndexing action</h4>
-<div class="paragraph">
-<p>Be also aware of the limits of this API:</p>
-</div>
-<div class="paragraph">
-<p>Warning: During the re-indexing, the result of search operations might
-be altered.</p>
-</div>
-<div class="paragraph">
-<p>Warning: Canceling this task should be considered unsafe as it will
-leave the currently reIndexed mailbox as partially indexed.</p>
-</div>
-<div class="paragraph">
-<p>Warning: While we have been trying to reduce the inconsistency window to
-a maximum (by keeping track of ongoing events), concurrent changes done
-during the reIndexing might be ignored.</p>
-</div>
-<div class="sect4">
-<h5 id="_reindexing_all_mails"><a class="anchor" href="#_reindexing_all_mails"></a>ReIndexing all mails</h5>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/mailboxes?task=reIndex</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule a task for reIndexing all the mails stored on this James
-server.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>An admin can specify the concurrency that should be used when running
-the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>messagesPerSecond</code> rate at which messages should be processed per
-second. Default is 50.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must have a strictly positive integer as a value
-and be passed as query parameter.</p>
-</div>
-<div class="paragraph">
-<p>An admin can also specify the reindexing mode it wants to use when
-running the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>mode</code> the reindexing mode used. There are 2 modes for the moment:</p>
-<div class="ulist">
-<ul>
-<li>
-<p><code>rebuildAll</code> allows to rebuild all indexes. This is the default mode.</p>
-</li>
-<li>
-<p><code>fixOutdated</code> will check for outdated indexed document and reindex
-only those.</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must be passed as query parameter.</p>
-</div>
-<div class="paragraph">
-<p>It’s good to note as well that there is a limitation with the
-<code>fixOutdated</code> mode. As we first collect metadata of stored messages to
-compare them with the ones in the index, a failed <code>expunged</code> operation
-might not be well corrected (as the message might not exist anymore but
-still be indexed).</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/mailboxes?task=reIndex&messagesPerSecond=200&mode=rebuildAll</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>full-reindexing</code> and
-the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"full-reindexing",
- "runningOptions":{
- "messagesPerSecond":200,
- "mode":"REBUILD_ALL"
- },
- "successfullyReprocessedMailCount":18,
- "failedReprocessedMailCount": 3,
- "mailboxFailures": ["12", "23" ],
- "messageFailures": [
- {
- "mailboxId": "1",
- "uids": [1, 36]
- }]
-}</pre>
-</div>
-</div>
-</div>
-<div class="sect4">
-<h5 id="_fixing_previously_failed_reindexing"><a class="anchor" href="#_fixing_previously_failed_reindexing"></a>Fixing previously failed ReIndexing</h5>
-<div class="paragraph">
-<p>Will schedule a task for reIndexing all the mails which had failed to be
-indexed from the ReIndexingAllMails task.</p>
-</div>
-<div class="paragraph">
-<p>Given <code>bbdb69c9-082a-44b0-a85a-6e33e74287a5</code> being a <code>taskId</code> generated
-for a reIndexing tasks</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST 'http://ip:port/mailboxes?task=reIndex&reIndexFailedMessagesOf=bbdb69c9-082a-44b0-a85a-6e33e74287a5'</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>An admin can specify the concurrency that should be used when running
-the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>messagesPerSecond</code> rate at which messages should be processed per
-second. Default is 50.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must have a strictly positive integer as a value
-and be passed as query parameter.</p>
-</div>
-<div class="paragraph">
-<p>An admin can also specify the reindexing mode it wants to use when
-running the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>mode</code> the reindexing mode used. There are 2 modes for the moment:</p>
-<div class="ulist">
-<ul>
-<li>
-<p><code>rebuildAll</code> allows to rebuild all indexes. This is the default mode.</p>
-</li>
-<li>
-<p><code>fixOutdated</code> will check for outdated indexed document and reindex
-only those.</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must be passed as query parameter.</p>
-</div>
-<div class="paragraph">
-<p>It’s good to note as well that there is a limitation with the
-<code>fixOutdated</code> mode. As we first collect metadata of stored messages to
-compare them with the ones in the index, a failed <code>expunged</code> operation
-might not be well corrected (as the message might not exist anymore but
-still be indexed).</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/mailboxes?task=reIndex&reIndexFailedMessagesOf=bbdb69c9-082a-44b0-a85a-6e33e74287a5&messagesPerSecond=200&mode=rebuildAll</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type
-<code>error-recovery-indexation</code> and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"error-recovery-indexation"
- "runningOptions":{
- "messagesPerSecond":200,
- "mode":"REBUILD_ALL"
- },
- "successfullyReprocessedMailCount":18,
- "failedReprocessedMailCount": 3,
- "mailboxFailures": ["12", "23" ],
- "messageFailures": [{
- "mailboxId": "1",
- "uids": [1, 36]
- }]
-}</pre>
-</div>
-</div>
-</div>
-<div class="sect4">
-<h5 id="_create_missing_parent_mailboxes"><a class="anchor" href="#_create_missing_parent_mailboxes"></a>Create missing parent mailboxes</h5>
-<div class="paragraph">
-<p>Will schedule a task for creating all the missing parent mailboxes in a hierarchical mailbox tree, which is the result
-of a partially failed rename operation of a child mailbox.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/mailboxes?task=createMissingParents</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Error in the request. Details can be found in the reported error.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>createMissingParents</code> and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"createMissingParents"
- "created": ["1", "2" ],
- "totalCreated": 2,
- "failures": [],
- "totalFailure": 0
-}</pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_single_mailbox"><a class="anchor" href="#_single_mailbox"></a>Single mailbox</h3>
-<div class="sect3">
-<h4 id="_reindexing_a_mailbox_mails"><a class="anchor" href="#_reindexing_a_mailbox_mails"></a>ReIndexing a mailbox mails</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/mailboxes/{mailboxId}?task=reIndex</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule a task for reIndexing all the mails in one mailbox.</p>
-</div>
-<div class="paragraph">
-<p>Note that `mailboxId' path parameter needs to be a (implementation
-dependent) valid mailboxId.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>An admin can specify the concurrency that should be used when running
-the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>messagesPerSecond</code> rate at which messages should be processed per
-second. Default is 50.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must have a strictly positive integer as a value
-and be passed as query parameter.</p>
-</div>
-<div class="paragraph">
-<p>An admin can also specify the reindexing mode it wants to use when
-running the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>mode</code> the reindexing mode used. There are 2 modes for the moment:</p>
-<div class="ulist">
-<ul>
-<li>
-<p><code>rebuildAll</code> allows to rebuild all indexes. This is the default mode.</p>
-</li>
-<li>
-<p><code>fixOutdated</code> will check for outdated indexed document and reindex
-only those.</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must be passed as query parameter.</p>
-</div>
-<div class="paragraph">
-<p>It’s good to note as well that there is a limitation with the
-<code>fixOutdated</code> mode. As we first collect metadata of stored messages to
-compare them with the ones in the index, a failed <code>expunged</code> operation
-might not be well corrected (as the message might not exist anymore but
-still be indexed).</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/mailboxes/{mailboxId}?task=reIndex&messagesPerSecond=200&mode=fixOutdated</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Error in the request. Details can be found in the reported error.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>mailbox-reindexing</code> and
-the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"mailbox-reindexing",
- "runningOptions":{
- "messagesPerSecond":200,
- "mode":"FIX_OUTDATED"
- },
- "mailboxId":"{mailboxId}",
- "successfullyReprocessedMailCount":18,
- "failedReprocessedMailCount": 3,
- "mailboxFailures": ["12"],
- "messageFailures": [
- {
- "mailboxId": "1",
- "uids": [1, 36]
- }]
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Warning: During the re-indexing, the result of search operations might
-be altered.</p>
-</div>
-<div class="paragraph">
-<p>Warning: Canceling this task should be considered unsafe as it will
-leave the currently reIndexed mailbox as partially indexed.</p>
-</div>
-<div class="paragraph">
-<p>Warning: While we have been trying to reduce the inconsistency window to
-a maximum (by keeping track of ongoing events), concurrent changes done
-during the reIndexing might be ignored.</p>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_administrating_messages"><a class="anchor" href="#_administrating_messages"></a>Administrating Messages</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_reindexing_a_single_mail_by_messageid"><a class="anchor" href="#_reindexing_a_single_mail_by_messageid"></a>ReIndexing a single mail by messageId</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/messages/{messageId}?task=reIndex</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule a task for reIndexing a single email in all the mailboxes
-containing it.</p>
-</div>
-<div class="paragraph">
-<p>Note that `messageId' path parameter needs to be a (implementation
-dependent) valid messageId.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Error in the request. Details can be found in the reported error.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>messageId-reindexing</code>
-and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "messageId":"18"
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Warning: During the re-indexing, the result of search operations might
-be altered.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_fixing_message_inconsistencies"><a class="anchor" href="#_fixing_message_inconsistencies"></a>Fixing message inconsistencies</h3>
-<div class="paragraph">
-<p>This task is only available on top of Guice Cassandra products.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /messages?task=SolveInconsistencies</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule a task for fixing message inconsistencies created by the
-message denormalization process.</p>
-</div>
-<div class="paragraph">
-<p>Messages are denormalized and stored in separated data tables in
-Cassandra, so they can be accessed by their unique identifier or mailbox
-identifier & local mailbox identifier through different protocols.</p>
-</div>
-<div class="paragraph">
-<p>Failure in the denormalization process will lead to inconsistencies, for
-example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>BOB receives a message
-The denormalization process fails
-BOB can read the message via JMAP
-BOB cannot read the message via IMAP
-
-BOB marks a message as SEEN
-The denormalization process fails
-The message is SEEN via JMAP
-The message is UNSEEN via IMAP</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>An admin can specify the concurrency that should be used when running
-the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>messagesPerSecond</code> rate of messages to be processed per second.
-Default is 100.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must have a strictly positive integer as a value
-and be passed as query parameter.</p>
-</div>
-<div class="paragraph">
-<p>An admin can also specify the reindexing mode it wants to use when
-running the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>mode</code> the reindexing mode used. There are 2 modes for the moment:</p>
-<div class="ulist">
-<ul>
-<li>
-<p><code>rebuildAll</code> allows to rebuild all indexes. This is the default mode.</p>
-</li>
-<li>
-<p><code>fixOutdated</code> will check for outdated indexed document and reindex
-only those.</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must be passed as query parameter.</p>
-</div>
-<div class="paragraph">
-<p>It’s good to note as well that there is a limitation with the
-<code>fixOutdated</code> mode. As we first collect metadata of stored messages to
-compare them with the ones in the index, a failed <code>expunged</code> operation
-might not be well corrected (as the message might not exist anymore but
-still be indexed).</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /messages?task=SolveInconsistencies&messagesPerSecond=200&mode=rebuildAll</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Error in the request. Details can be found in the reported error.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type
-<code>solve-message-inconsistencies</code> and the following
-<code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"solve-message-inconsistencies",
- "timestamp":"2007-12-03T10:15:30Z",
- "processedImapUidEntries": 2,
- "processedMessageIdEntries": 1,
- "addedMessageIdEntries": 1,
- "updatedMessageIdEntries": 0,
- "removedMessageIdEntries": 1,
- "runningOptions":{
- "messagesPerSecond": 200,
- "mode":"REBUILD_ALL"
- },
- "fixedInconsistencies": [
- {
- "mailboxId": "551f0580-82fb-11ea-970e-f9c83d4cf8c2",
- "messageId": "d2bee791-7e63-11ea-883c-95b84008f979",
- "uid": 1
- },
- {
- "mailboxId": "551f0580-82fb-11ea-970e-f9c83d4cf8c2",
- "messageId": "d2bee792-7e63-11ea-883c-95b84008f979",
- "uid": 2
- }
- ],
- "errors": [
- {
- "mailboxId": "551f0580-82fb-11ea-970e-f9c83d4cf8c2",
- "messageId": "ffffffff-7e63-11ea-883c-95b84008f979",
- "uid": 3
- }
- ]
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>User actions concurrent to the inconsistency fixing task could result in
-concurrency issues. New inconsistencies could be created.</p>
-</div>
-<div class="paragraph">
-<p>However the source of truth will not be impacted, hence rerunning the
-task will eventually fix all issues.</p>
-</div>
-<div class="paragraph">
-<p>This task could be run safely online and can be scheduled on a recurring
-basis outside of peak traffic by an admin to ensure Cassandra message
-consistency.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_deleting_old_messages_of_all_users"><a class="anchor" href="#_deleting_old_messages_of_all_users"></a>Deleting old messages of all users</h3>
-<div class="paragraph">
-<p><strong>Note:</strong>
-Consider enabling the <a href="../configure/vault.html" class="xref page">Deleted Messages Vault</a>
-if you use this feature.</p>
-</div>
-<div class="paragraph">
-<p>Old messages tend to pile up in user INBOXes. An admin might want to delete
-these on behalf of the users, e.g. all messages older than 30 days:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/messages?olderThan=30d</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>The <code>olderThan</code> parameter should be expressed in the following format: <code>Nunit</code>.
-<code>N</code> should be strictly positive. <code>unit</code> could be either in the short form
-(<code>d</code>, <code>w</code>, <code>y</code> etc.), or in the long form (<code>days</code>, <code>weeks</code>, <code>months</code>, <code>years</code>).
-The default unit is <code>days</code>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Error in the request. Details can be found in the reported error.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the type <code>ExpireMailboxTask</code> and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type": "ExpireMailboxTask"
- "mailboxesExpired": 5,
- "mailboxesFailed": 2,
- "mailboxesProcessed": 10,
- "messagesDeleted": 23,
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>To delete old mails from a different mailbox than INBOX, e.g. a mailbox
-named "Archived" :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/messages?mailbox=Archived&olderThan=30d</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Since this is a somewhat expensive operation, the task is throttled to one user
-per second. You may speed it up via <code>usersPerSecond=10</code> for example. But keep
-in mind that a high rate might overwhelm your database or blob store.</p>
-</div>
-<div class="paragraph">
-<p><strong>Scanning search only:</strong> (unsupported for Lucene and OpenSearch search implementations)<br>
-Some mail clients can add an <code>Expires</code> header (RFC 4021) to their messages.
-Instead of specifying an absolute age, you may choose to delete only such
-messages where the expiration date from this header lies in the past:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/messages?byExpiresHeader</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>In this case you should also add the <a href="../configure/mailets.html" class="xref page">mailet</a>
-<code>Expires</code> to your mailet container, which can sanitize expiration date headers.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_administrating_user_mailboxes"><a class="anchor" href="#_administrating_user_mailboxes"></a>Administrating user mailboxes</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_creating_a_mailbox"><a class="anchor" href="#_creating_a_mailbox"></a>Creating a mailbox</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/users/{usernameToBeUsed}/mailboxes/{mailboxNameToBeCreated}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user Resource
-name <code>mailboxNameToBeCreated</code> should not be empty, nor contain % * characters, nor starting with #.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The mailbox now exists on the server</p>
-</li>
-<li>
-<p>400: Invalid mailbox name</p>
-</li>
-<li>
-<p>404: The user name does not exist. Note that this check can be bypassed by specifying the <code>force</code> query parameter.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<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>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/users/{usernameToBeUsed}/mailboxes/INBOX.work</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_deleting_a_mailbox_and_its_children"><a class="anchor" href="#_deleting_a_mailbox_and_its_children"></a>Deleting a mailbox and its children</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/users/{usernameToBeUsed}/mailboxes/{mailboxNameToBeDeleted}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user Resource
-name <code>mailboxNameToBeDeleted</code> should not be empty</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The mailbox now does not exist on the server</p>
-</li>
-<li>
-<p>400: Invalid mailbox name</p>
-</li>
-<li>
-<p>404: The user name does not exist. Note that this check can be bypassed by specifying the <code>force</code> query parameter.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_testing_existence_of_a_mailbox"><a class="anchor" href="#_testing_existence_of_a_mailbox"></a>Testing existence of a mailbox</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/users/{usernameToBeUsed}/mailboxes/{mailboxNameToBeTested}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user Resource
-name <code>mailboxNameToBeTested</code> should not be empty</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The mailbox exists</p>
-</li>
-<li>
-<p>400: Invalid mailbox name</p>
-</li>
-<li>
-<p>404: The user name does not exist, the mailbox does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_listing_user_mailboxes"><a class="anchor" href="#_listing_user_mailboxes"></a>Listing user mailboxes</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/users/{usernameToBeUsed}/mailboxes</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[{"mailboxName":"INBOX"},{"mailboxName":"outbox"}]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The mailboxes list was successfully retrieved</p>
-</li>
-<li>
-<p>404: The user name does not exist, the mailbox does not exist. Note that this check can be bypassed by specifying the <code>force</code> query parameter.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_deleting_user_mailboxes"><a class="anchor" href="#_deleting_user_mailboxes"></a>Deleting user mailboxes</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/users/{usernameToBeUsed}/mailboxes</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The user do not have mailboxes anymore</p>
-</li>
-<li>
-<p>404: The user name does not exist. Note that this check can be bypassed by specifying the <code>force</code> query parameter.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_exporting_user_mailboxes"><a class="anchor" href="#_exporting_user_mailboxes"></a>Exporting user mailboxes</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/users/{usernameToBeUsed}/mailboxes?action=export</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned</p>
-</li>
-<li>
-<p>404: The user name does not exist</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>MailboxesExportTask</code>
-and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"MailboxesExportTask",
- "timestamp":"2007-12-03T10:15:30Z",
- "username": "user",
- "stage": "STARTING"
-}</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_reindexing_a_user_mails"><a class="anchor" href="#_reindexing_a_user_mails"></a>ReIndexing a user mails</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/users/{usernameToBeUsed}/mailboxes?task=reIndex</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule a task for reIndexing all the mails in ``<a href="mailto:user@domain.com">user@domain.com</a>''
-mailboxes (encoded above).</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>An admin can specify the concurrency that should be used when running
-the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>messagesPerSecond</code> rate at which messages should be processed per
-second. Default is 50.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must have a strictly positive integer as a value
-and be passed as query parameter.</p>
-</div>
-<div class="paragraph">
-<p>An admin can also specify the reindexing mode it wants to use when
-running the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>mode</code> the reindexing mode used. There are 2 modes for the moment:</p>
-<div class="ulist">
-<ul>
-<li>
-<p><code>rebuildAll</code> allows to rebuild all indexes. This is the default mode.</p>
-</li>
-<li>
-<p><code>fixOutdated</code> will check for outdated indexed document and reindex
-only those.</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must be passed as query parameter.</p>
-</div>
-<div class="paragraph">
-<p>It’s good to note as well that there is a limitation with the
-<code>fixOutdated</code> mode. As we first collect metadata of stored messages to
-compare them with the ones in the index, a failed <code>expunged</code> operation
-might not be well corrected (as the message might not exist anymore but
-still be indexed).</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/users/{usernameToBeUsed}/mailboxes?task=reIndex&messagesPerSecond=200&mode=fixOutdated</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Error in the request. Details can be found in the reported error.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>user-reindexing</code> and
-the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"user-reindexing",
- "runningOptions":{
- "messagesPerSecond":200,
- "mode":"FIX_OUTDATED"
- },
- "user":"user@domain.com",
- "successfullyReprocessedMailCount":18,
- "failedReprocessedMailCount": 3,
- "mailboxFailures": ["12", "23" ],
- "messageFailures": [
- {
- "mailboxId": "1",
- "uids": [1, 36]
- }]
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Warning: During the re-indexing, the result of search operations might
-be altered.</p>
-</div>
-<div class="paragraph">
-<p>Warning: Canceling this task should be considered unsafe as it will
-leave the currently reIndexed mailbox as partially indexed.</p>
-</div>
-<div class="paragraph">
-<p>Warning: While we have been trying to reduce the inconsistency window to
-a maximum (by keeping track of ongoing events), concurrent changes done
-during the reIndexing might be ignored.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_counting_emails"><a class="anchor" href="#_counting_emails"></a>Counting emails</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/users/{usernameToBeUsed}/mailboxes/{mailboxName}/messageCount</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the total count of messages within the mailbox of that user.</p>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user.</p>
-</div>
-<div class="paragraph">
-<p>Resource name <code>mailboxName</code> should not be empty, nor contain <code>% *</code> characters, nor starting with <code>#</code>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The number of emails in a given mailbox</p>
-</li>
-<li>
-<p>400: Invalid mailbox name</p>
-</li>
-<li>
-<p>404: Invalid get on user mailboxes. The <code>usernameToBeUsed</code> or <code>mailboxName</code> does not exit'</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_counting_unseen_emails"><a class="anchor" href="#_counting_unseen_emails"></a>Counting unseen emails</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/users/{usernameToBeUsed}/mailboxes/{mailboxName}/unseenMessageCount</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the total count of unseen messages within the mailbox of that user.</p>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user.</p>
-</div>
-<div class="paragraph">
-<p>Resource name <code>mailboxName</code> should not be empty, nor contain <code>% *</code> characters, nor starting with <code>#</code>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The number of unseen emails in a given mailbox</p>
-</li>
-<li>
-<p>400: Invalid mailbox name</p>
-</li>
-<li>
-<p>404: Invalid get on user mailboxes. The <code>usernameToBeUsed</code> or <code>mailboxName</code> does not exit'</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_clearing_mailbox_content"><a class="anchor" href="#_clearing_mailbox_content"></a>Clearing mailbox content</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/users/{usernameToBeUsed}/mailboxes/{mailboxName}/messages</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule a task for clearing all the mails in <code>mailboxName</code> mailbox of <code>usernameToBeUsed</code>.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user.</p>
-</div>
-<div class="paragraph">
-<p>Resource name <code>mailboxName</code> should not be empty, nor contain <code>% *</code> characters, nor starting with <code>#</code>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Invalid mailbox name</p>
-</li>
-<li>
-<p>404: Invalid get on user mailboxes. The <code>username</code> or <code>mailboxName</code> does not exit</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>ClearMailboxContentTask</code> and
-the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "mailboxName": "mbx1",
- "messagesFailCount": 9,
- "messagesSuccessCount": 10,
- "timestamp": "2007-12-03T10:15:30Z",
- "type": "ClearMailboxContentTask",
- "username": "bob@domain.tld"
-}</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_subscribing_a_user_to_all_of_its_mailboxes"><a class="anchor" href="#_subscribing_a_user_to_all_of_its_mailboxes"></a>Subscribing a user to all of its mailboxes</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/users/{usernameToBeUsed}/mailboxes?task=subscribeAll</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule a task for subscribing a user to all of its mailboxes.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Most users are unaware of what an IMAP subscription is, nor how they can manage it. If the subscription list gets out
-of sync with the mailbox list, it could result in downgraded user experience (see MAILBOX-405). This task allow
-to reset the subscription list to the mailbox list on a per user basis thus working around the aforementioned issues.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>404: No such user</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>SubscribeAllTask</code> and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"SubscribeAllTask",
- "username":"user@domain.com",
- "subscribedCount":18,
- "unsubscribedCount": 3
-}</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_recomputing_user_jmap_fast_message_view_projection"><a class="anchor" href="#_recomputing_user_jmap_fast_message_view_projection"></a>Recomputing User JMAP fast message view projection</h3>
-<div class="paragraph">
-<p>This action is only available for backends supporting JMAP protocol.</p>
-</div>
-<div class="paragraph">
-<p>Message fast view projection stores message properties expected to be
-fast to fetch but are actually expensive to compute, in order for
-GetMessages operation to be fast to execute for these properties.</p>
-</div>
-<div class="paragraph">
-<p>These projection items are asynchronously computed on mailbox events.</p>
-</div>
-<div class="paragraph">
-<p>You can force the full projection recomputation by calling the following
-endpoint:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /users/{usernameToBeUsed}/mailboxes?task=recomputeFastViewProjectionItems</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule a task for recomputing the fast message view projection
-for all mailboxes of <code>usernameToBeUsed</code>.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>An admin can specify the concurrency that should be used when running
-the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>messagesPerSecond</code> rate at which messages should be processed, per
-second. Defaults to 10.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must have a strictly positive integer as a value
-and be passed as query parameters.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /mailboxes?task=recomputeFastViewProjectionItems&messagesPerSecond=20</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type
-<code>RecomputeUserFastViewProjectionItemsTask</code> and the following
-<code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"RecomputeUserFastViewProjectionItemsTask",
- "username": "{usernameToBeUsed}",
- "processedMessageCount": 3,
- "failedMessageCount": 1,
- "runningOptions": {
- "messagesPerSecond":20
- }
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Error in the request. Details can be found in the reported error.</p>
-</li>
-<li>
-<p>404: User not found.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_administrating_quotas"><a class="anchor" href="#_administrating_quotas"></a>Administrating quotas</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_administrating_quotas_by_users"><a class="anchor" href="#_administrating_quotas_by_users"></a>Administrating quotas by users</h3>
-<div class="sect3">
-<h4 id="_getting_the_quota_for_a_user"><a class="anchor" href="#_getting_the_quota_for_a_user"></a>Getting the quota for a user</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/quota/users/{usernameToBeUsed}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user</p>
-</div>
-<div class="paragraph">
-<p>The answer is the details of the quota of that user.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "global": {
- "count":252,
- "size":242
- },
- "domain": {
- "count":152,
- "size":142
- },
- "user": {
- "count":52,
- "size":42
- },
- "computed": {
- "count":52,
- "size":42
- },
- "occupation": {
- "size":13,
- "count":21,
- "ratio": {
- "size":0.25,
- "count":0.5,
- "max":0.5
- }
- }
-}</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>The <code>global</code> entry represent the quota limit allowed on this James
-server.</p>
-</li>
-<li>
-<p>The <code>domain</code> entry represent the quota limit allowed for the user of
-that domain.</p>
-</li>
-<li>
-<p>The <code>user</code> entry represent the quota limit allowed for this specific
-user.</p>
-</li>
-<li>
-<p>The <code>computed</code> entry represent the quota limit applied for this user,
-resolved from the upper values.</p>
-</li>
-<li>
-<p>The <code>occupation</code> entry represent the occupation of the quota for this
-user. This includes used count and size as well as occupation ratio
-(used / limit).</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Note that <code>quota</code> object can contain a fixed value, an empty value
-(null) or an unlimited value (-1):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"count":52,"size":42}
-
-{"count":null,"size":null}
-
-{"count":52,"size":-1}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The user’s quota was successfully retrieved</p>
-</li>
-<li>
-<p>404: The user does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_updating_the_quota_for_a_user"><a class="anchor" href="#_updating_the_quota_for_a_user"></a>Updating the quota for a user</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/quota/users/{usernameToBeUsed}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user</p>
-</div>
-<div class="paragraph">
-<p>The body can contain a fixed value, an empty value (null) or an
-unlimited value (-1):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"count":52,"size":42}
-
-{"count":null,"size":null}
-
-{"count":52,"size":-1}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated</p>
-</li>
-<li>
-<p>400: The body is not a positive integer neither an unlimited value
-(-1).</p>
-</li>
-<li>
-<p>404: The user does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_getting_the_quota_count_for_a_user"><a class="anchor" href="#_getting_the_quota_count_for_a_user"></a>Getting the quota count for a user</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/quota/users/{usernameToBeUsed}/count</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user</p>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>52</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The user’s quota was successfully retrieved</p>
-</li>
-<li>
-<p>204: No quota count limit is defined at the user level for this user</p>
-</li>
-<li>
-<p>404: The user does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_updating_the_quota_count_for_a_user"><a class="anchor" href="#_updating_the_quota_count_for_a_user"></a>Updating the quota count for a user</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/quota/users/{usernameToBeUsed}/count</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user</p>
-</div>
-<div class="paragraph">
-<p>The body can contain a fixed value or an unlimited value (-1):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>52</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated</p>
-</li>
-<li>
-<p>400: The body is not a positive integer neither an unlimited value
-(-1).</p>
-</li>
-<li>
-<p>404: The user does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_deleting_the_quota_count_for_a_user"><a class="anchor" href="#_deleting_the_quota_count_for_a_user"></a>Deleting the quota count for a user</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/quota/users/{usernameToBeUsed}/count</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated to unlimited value.</p>
-</li>
-<li>
-<p>404: The user does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_getting_the_quota_size_for_a_user"><a class="anchor" href="#_getting_the_quota_size_for_a_user"></a>Getting the quota size for a user</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/quota/users/{usernameToBeUsed}/size</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user</p>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>52</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The user’s quota was successfully retrieved</p>
-</li>
-<li>
-<p>204: No quota size limit is defined at the user level for this user</p>
-</li>
-<li>
-<p>404: The user does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_updating_the_quota_size_for_a_user"><a class="anchor" href="#_updating_the_quota_size_for_a_user"></a>Updating the quota size for a user</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/quota/users/{usernameToBeUsed}/size</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user</p>
-</div>
-<div class="paragraph">
-<p>The body can contain a fixed value or an unlimited value (-1):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>52</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated</p>
-</li>
-<li>
-<p>400: The body is not a positive integer neither an unlimited value
-(-1).</p>
-</li>
-<li>
-<p>404: The user does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_deleting_the_quota_size_for_a_user"><a class="anchor" href="#_deleting_the_quota_size_for_a_user"></a>Deleting the quota size for a user</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/quota/users/{usernameToBeUsed}/size</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated to unlimited value.</p>
-</li>
-<li>
-<p>404: The user does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_searching_user_by_quota_ratio"><a class="anchor" href="#_searching_user_by_quota_ratio"></a>Searching user by quota ratio</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET 'http://ip:port/quota/users?minOccupationRatio=0.8&maxOccupationRatio=0.99&limit=100&offset=200&domain=domain.com'</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[
- {
- "username":"user@domain.com",
- "detail": {
- "global": {
- "count":252,
- "size":242
- },
- "domain": {
- "count":152,
- "size":142
- },
- "user": {
- "count":52,
- "size":42
- },
- "computed": {
- "count":52,
- "size":42
- },
- "occupation": {
- "size":48,
- "count":21,
- "ratio": {
- "size":0.9230,
- "count":0.5,
- "max":0.9230
- }
- }
- }
- },
- ...
-]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Where:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>minOccupationRatio</strong> is a query parameter determining the minimum
-occupation ratio of users to be returned.</p>
-</li>
-<li>
-<p><strong>maxOccupationRatio</strong> is a query parameter determining the maximum
-occupation ratio of users to be returned.</p>
-</li>
-<li>
-<p><strong>domain</strong> is a query parameter determining the domain of users to be
-returned.</p>
-</li>
-<li>
-<p><strong>limit</strong> is a query parameter determining the maximum number of users
-to be returned.</p>
-</li>
-<li>
-<p><strong>offset</strong> is a query parameter determining the number of users to skip.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Please note that users are alphabetically ordered on username.</p>
-</div>
-<div class="paragraph">
-<p>The response is a list of usernames, with attached quota details as
-defined <a href="#_getting_the_quota_for_a_user">here</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: List of users had successfully been returned.</p>
-</li>
-<li>
-<p>400: Validation issues with parameters</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_recomputing_current_quotas_for_users"><a class="anchor" href="#_recomputing_current_quotas_for_users"></a>Recomputing current quotas for users</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /quota/users?task=RecomputeCurrentQuotas</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will recompute current quotas (count and size) for all users stored in
-James.</p>
-</div>
-<div class="paragraph">
-<p>James maintains per quota a projection for current quota count and size.
-As with any projection, it can go out of sync, leading to inconsistent
-results being returned to the client.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>An admin can specify the concurrency that should be used when running
-the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>usersPerSecond</code> rate at which users quotas should be reprocessed, per
-second. Defaults to 1.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must have a strictly positive integer as a value
-and be passed as query parameters.</p>
-</div>
-<div class="paragraph">
-<p>An admin can select which quota component he wants to recompute:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>quotaComponent</code> component whose quota need to be reprocessed. It could be one of values: MAILBOX, SIEVE, JMAP_UPLOADS.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The admin could select several quota components. If he does not select, quotas of all components would be recomputed.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /quota/users?task=RecomputeCurrentQuotas&usersPerSecond=20&quotaComponent=MAILBOX&quotaComponent=JMAP_UPLOADS</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type
-<code>recompute-current-quotas</code> and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"recompute-current-quotas",
- "recomputeSingleQuotaComponentResults": [
- {
- "quotaComponent": "MAILBOX",
- "processedIdentifierCount": 3,
- "failedIdentifiers": ["#private&bob@localhost"]
- },
- {
- "quotaComponent": "JMAP_UPLOADS",
- "processedIdentifierCount": 3,
- "failedIdentifiers": ["bob@localhost"]
- }
- ],
- "runningOptions": {
- "usersPerSecond":20
- }
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>WARNING</strong>: this task do not take into account concurrent modifications
-upon a single current quota re-computation. Rerunning the task will
-<em>eventually</em> provide the consistent result.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_administrating_quotas_by_domains"><a class="anchor" href="#_administrating_quotas_by_domains"></a>Administrating quotas by domains</h3>
-<div class="sect3">
-<h4 id="_getting_the_quota_for_a_domain"><a class="anchor" href="#_getting_the_quota_for_a_domain"></a>Getting the quota for a domain</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/quota/domains/{domainToBeUsed}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>domainToBeUsed</code> should be an existing domain. For
-example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/quota/domains/james.org</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The answer will detail the default quota applied to users belonging to
-that domain:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "global": {
- "count":252,
- "size":null
- },
- "domain": {
- "count":null,
- "size":142
- },
- "computed": {
- "count":252,
- "size":142
- }
-}</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>The <code>global</code> entry represents the quota limit defined on this James
-server by default.</p>
-</li>
-<li>
-<p>The <code>domain</code> entry represents the quota limit allowed for the user of
-that domain by default.</p>
-</li>
-<li>
-<p>The <code>computed</code> entry represents the quota limit applied for the users
-of that domain, by default, resolved from the upper values.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Note that <code>quota</code> object can contain a fixed value, an empty value
-(null) or an unlimited value (-1):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"count":52,"size":42}
-
-{"count":null,"size":null}
-
-{"count":52,"size":-1}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The domain’s quota was successfully retrieved</p>
-</li>
-<li>
-<p>404: The domain does not exist</p>
-</li>
-<li>
-<p>405: Domain Quota configuration not supported when virtual hosting is
-deactivated.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_updating_the_quota_for_a_domain"><a class="anchor" href="#_updating_the_quota_for_a_domain"></a>Updating the quota for a domain</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/quota/domains/{domainToBeUsed}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>domainToBeUsed</code> should be an existing domain.</p>
-</div>
-<div class="paragraph">
-<p>The body can contain a fixed value, an empty value (null) or an
-unlimited value (-1):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"count":52,"size":42}
-
-{"count":null,"size":null}
-
-{"count":52,"size":-1}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated</p>
-</li>
-<li>
-<p>400: The body is not a positive integer neither an unlimited value
-(-1).</p>
-</li>
-<li>
-<p>404: The domain does not exist</p>
-</li>
-<li>
-<p>405: Domain Quota configuration not supported when virtual hosting is
-deactivated.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_getting_the_quota_count_for_a_domain"><a class="anchor" href="#_getting_the_quota_count_for_a_domain"></a>Getting the quota count for a domain</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/quota/domains/{domainToBeUsed}/count</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>domainToBeUsed</code> should be an existing domain.</p>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>52</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The domain’s quota was successfully retrieved</p>
-</li>
-<li>
-<p>204: No quota count limit is defined at the domain level for this
-domain</p>
-</li>
-<li>
-<p>404: The domain does not exist</p>
-</li>
-<li>
-<p>405: Domain Quota configuration not supported when virtual hosting is
-desactivated.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_updating_the_quota_count_for_a_domain"><a class="anchor" href="#_updating_the_quota_count_for_a_domain"></a>Updating the quota count for a domain</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/quota/domains/{domainToBeUsed}/count</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>domainToBeUsed</code> should be an existing domain.</p>
-</div>
-<div class="paragraph">
-<p>The body can contain a fixed value or an unlimited value (-1):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>52</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated</p>
-</li>
-<li>
-<p>400: The body is not a positive integer neither an unlimited value
-(-1).</p>
-</li>
-<li>
-<p>404: The domain does not exist</p>
-</li>
-<li>
-<p>405: Domain Quota configuration not supported when virtual hosting is
-desactivated.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_deleting_the_quota_count_for_a_domain"><a class="anchor" href="#_deleting_the_quota_count_for_a_domain"></a>Deleting the quota count for a domain</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/quota/domains/{domainToBeUsed}/count</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>domainToBeUsed</code> should be an existing domain.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated to unlimited value.</p>
-</li>
-<li>
-<p>404: The domain does not exist</p>
-</li>
-<li>
-<p>405: Domain Quota configuration not supported when virtual hosting is
-deactivated.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_getting_the_quota_size_for_a_domain"><a class="anchor" href="#_getting_the_quota_size_for_a_domain"></a>Getting the quota size for a domain</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/quota/domains/{domainToBeUsed}/size</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>domainToBeUsed</code> should be an existing domain.</p>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>52</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The domain’s quota was successfully retrieved</p>
-</li>
-<li>
-<p>204: No quota size limit is defined at the domain level for this
-domain</p>
-</li>
-<li>
-<p>404: The domain does not exist</p>
-</li>
-<li>
-<p>405: Domain Quota configuration not supported when virtual hosting is
-deactivated.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_updating_the_quota_size_for_a_domain"><a class="anchor" href="#_updating_the_quota_size_for_a_domain"></a>Updating the quota size for a domain</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/quota/domains/{domainToBeUsed}/size</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>domainToBeUsed</code> should be an existing domain.</p>
-</div>
-<div class="paragraph">
-<p>The body can contain a fixed value or an unlimited value (-1):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>52</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated</p>
-</li>
-<li>
-<p>400: The body is not a positive integer neither an unlimited value
-(-1).</p>
-</li>
-<li>
-<p>404: The domain does not exist</p>
-</li>
-<li>
-<p>405: Domain Quota configuration not supported when virtual hosting is
-deactivated.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_deleting_the_quota_size_for_a_domain"><a class="anchor" href="#_deleting_the_quota_size_for_a_domain"></a>Deleting the quota size for a domain</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/quota/domains/{domainToBeUsed}/size</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>domainToBeUsed</code> should be an existing domain.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated to unlimited value.</p>
-</li>
-<li>
-<p>404: The domain does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_administrating_global_quotas"><a class="anchor" href="#_administrating_global_quotas"></a>Administrating global quotas</h3>
-<div class="sect3">
-<h4 id="_getting_the_global_quota"><a class="anchor" href="#_getting_the_global_quota"></a>Getting the global quota</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/quota</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The answer is the details of the global quota.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "count":252,
- "size":242
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note that <code>quota</code> object can contain a fixed value, an empty value
-(null) or an unlimited value (-1):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"count":52,"size":42}
-
-{"count":null,"size":null}
-
-{"count":52,"size":-1}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The quota was successfully retrieved</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_updating_global_quota"><a class="anchor" href="#_updating_global_quota"></a>Updating global quota</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/quota</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The body can contain a fixed value, an empty value (null) or an
-unlimited value (-1):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"count":52,"size":42}
-
-{"count":null,"size":null}
-
-{"count":52,"size":-1}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated</p>
-</li>
-<li>
-<p>400: The body is not a positive integer neither an unlimited value
-(-1).</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_getting_the_global_quota_count"><a class="anchor" href="#_getting_the_global_quota_count"></a>Getting the global quota count</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/quota/count</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name usernameToBeUsed should be an existing user</p>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>52</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The quota was successfully retrieved</p>
-</li>
-<li>
-<p>204: No quota count limit is defined at the global level</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_updating_the_global_quota_count"><a class="anchor" href="#_updating_the_global_quota_count"></a>Updating the global quota count</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/quota/count</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The body can contain a fixed value or an unlimited value (-1):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>52</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated</p>
-</li>
-<li>
-<p>400: The body is not a positive integer neither an unlimited value
-(-1).</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_deleting_the_global_quota_count"><a class="anchor" href="#_deleting_the_global_quota_count"></a>Deleting the global quota count</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/quota/count</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated to unlimited value.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_getting_the_global_quota_size"><a class="anchor" href="#_getting_the_global_quota_size"></a>Getting the global quota size</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/quota/size</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>52</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The quota was successfully retrieved</p>
-</li>
-<li>
-<p>204: No quota size limit is defined at the global level</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_updating_the_global_quota_size"><a class="anchor" href="#_updating_the_global_quota_size"></a>Updating the global quota size</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/quota/size</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The body can contain a fixed value or an unlimited value (-1):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>52</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated</p>
-</li>
-<li>
-<p>400: The body is not a positive integer neither an unlimited value
-(-1).</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_deleting_the_global_quota_size"><a class="anchor" href="#_deleting_the_global_quota_size"></a>Deleting the global quota size</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/quota/size</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated to unlimited value.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_administrating_sieve_quotas"><a class="anchor" href="#_administrating_sieve_quotas"></a>Administrating Sieve quotas</h3>
-<div class="paragraph">
-<p>Some limitations on space Users Sieve script can occupy can be
-configured by default, and overridden by user.</p>
-</div>
-<div class="sect3">
-<h4 id="_retrieving_global_sieve_quota"><a class="anchor" href="#_retrieving_global_sieve_quota"></a>Retrieving global sieve quota</h4>
-<div class="paragraph">
-<p>This endpoints allows to retrieve the global Sieve quota, which will be
-users default:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/sieve/quota/default</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the bytes count allowed by user per default on this server.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>102400</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Request is a success and the value is returned</p>
-</li>
-<li>
-<p>204: No default quota is being configured</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_updating_global_sieve_quota"><a class="anchor" href="#_updating_global_sieve_quota"></a>Updating global sieve quota</h4>
-<div class="paragraph">
-<p>This endpoints allows to update the global Sieve quota, which will be
-users default:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/sieve/quota/default</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>With the body being the bytes count allowed by user per default on this
-server.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>102400</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Operation succeeded</p>
-</li>
-<li>
-<p>400: Invalid payload</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_removing_global_sieve_quota"><a class="anchor" href="#_removing_global_sieve_quota"></a>Removing global sieve quota</h4>
-<div class="paragraph">
-<p>This endpoints allows to remove the global Sieve quota. There will no
-more be users default:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/sieve/quota/default</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Operation succeeded</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_retrieving_user_sieve_quota"><a class="anchor" href="#_retrieving_user_sieve_quota"></a>Retrieving user sieve quota</h4>
-<div class="paragraph">
-<p>This endpoints allows to retrieve the Sieve quota of a user, which will
-be this users quota:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/sieve/quota/users/user@domain.com</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the bytes count allowed for this user.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>102400</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Request is a success and the value is returned</p>
-</li>
-<li>
-<p>204: No quota is being configured for this user</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_updating_user_sieve_quota"><a class="anchor" href="#_updating_user_sieve_quota"></a>Updating user sieve quota</h4>
-<div class="paragraph">
-<p>This endpoints allows to update the Sieve quota of a user, which will be
-users default:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/sieve/quota/users/user@domain.com</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>With the body being the bytes count allowed for this user on this
-server.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>102400</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Operation succeeded</p>
-</li>
-<li>
-<p>400: Invalid payload</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_removing_user_sieve_quota"><a class="anchor" href="#_removing_user_sieve_quota"></a>Removing user sieve quota</h4>
-<div class="paragraph">
-<p>This endpoints allows to remove the Sieve quota of a user. There will no
-more quota for this user:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/sieve/quota/users/user@domain.com</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Operation succeeded</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_administrating_jmap_uploads"><a class="anchor" href="#_administrating_jmap_uploads"></a>Administrating Jmap Uploads</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_cleaning_upload_repository"><a class="anchor" href="#_cleaning_upload_repository"></a>Cleaning upload repository</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/jmap/uploads?scope=expired</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule a task for clearing expired upload entries.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Query parameter <code>scope</code> is required and have the value <code>expired</code>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Scope invalid</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>UploadRepositoryCleanupTask</code> and
-the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "scope": "expired",
- "timestamp": "2007-12-03T10:15:30Z",
- "type": "UploadRepositoryCleanupTask"
-}</pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_running_blob_garbage_collection"><a class="anchor" href="#_running_blob_garbage_collection"></a>Running blob garbage collection</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>When deduplication is enabled one needs to explicitly run a garbage collection in order to delete no longer referenced
-blobs.</p>
-</div>
-<div class="paragraph">
-<p>To do so:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/blobs?scope=unreferenced</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Additional parameters include Bloom filter tuning parameters:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>associatedProbability</strong>: Allow to define the targeted false positive rate. Note that subsequent runs do not have the
-same false-positives. Defaults to <code>0.01</code>.</p>
-</li>
-<li>
-<p><strong>expectedBlobCount</strong>: Expected count of blobs used to size the bloom filters. Defaults to <code>1.000.000</code>.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>These settings directly impacts the memory footprint of the bloom filter. <a href="https://hur.st/bloomfilter/">Simulators</a> can
-help understand those parameters.</p>
-</div>
-<div class="paragraph">
-<p>The created task has the following additional information:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "referenceSourceCount": 3456,
- "blobCount": 5678,
- "gcedBlobCount": 1234,
- "bloomFilterExpectedBlobCount": 10000,
- "bloomFilterAssociatedProbability": 0.01
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Where:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>bloomFilterExpectedBlobCount</strong> correspond to the supplied <strong>expectedBlobCount</strong> query parameter.</p>
-</li>
-<li>
-<p><strong>bloomFilterAssociatedProbability</strong> correspond to the supplied <strong>associatedProbability</strong> query parameter.</p>
-</li>
-<li>
-<p><strong>referenceSourceCount</strong> is the count of distinct blob references encountered while populating the bloom filter.</p>
-</li>
-<li>
-<p><strong>blobCount</strong> is the count of blobs tried against the bloom filter. This value can be used to better size the bloom
-filter in later runs.</p>
-</li>
-<li>
-<p><strong>gcedBlobCount</strong> is the count of blobs that were garbage collected.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_administrating_recipient_rewriting"><a class="anchor" href="#_administrating_recipient_rewriting"></a>Administrating Recipient rewriting</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_address_group"><a class="anchor" href="#_address_group"></a>Address group</h3>
-<div class="paragraph">
-<p>You can use <strong>webadmin</strong> to define address groups.</p>
-</div>
-<div class="paragraph">
-<p>When a specific email is sent to the group mail address, every group
-member will receive it.</p>
-</div>
-<div class="paragraph">
-<p>Note that the group mail address is virtual: it does not correspond to
-an existing user.</p>
-</div>
-<div class="paragraph">
-<p>This feature uses <a href="../architecture/index.html#_recipient_rewrite_tables" class="xref page">Recipients rewrite table</a>
-and requires the
-<a 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>
-</div>
-<div class="paragraph">
-<p>Note that email addresses are restricted to ASCII character set. Mail
-addresses not matching this criteria will be rejected.</p>
-</div>
-<div class="sect3">
-<h4 id="_listing_groups"><a class="anchor" href="#_listing_groups"></a>Listing groups</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/address/groups</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the groups as a list of JSON Strings representing mail
-addresses. For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>["group1@domain.com", "group2@domain.com"]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_listing_members_of_a_group"><a class="anchor" href="#_listing_members_of_a_group"></a>Listing members of a group</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/address/groups/group@domain.com</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the group members as a list of JSON Strings representing
-mail addresses. For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>["member1@domain.com", "member2@domain.com"]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success</p>
-</li>
-<li>
-<p>400: Group structure is not valid</p>
-</li>
-<li>
-<p>404: The group does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_adding_a_group_member"><a class="anchor" href="#_adding_a_group_member"></a>Adding a group member</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/address/groups/group@domain.com/member@domain.com</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will add <a href="mailto:member@domain.com">member@domain.com</a> to <a href="mailto:group@domain.com">group@domain.com</a>, creating the group if
-needed</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Success</p>
-</li>
-<li>
-<p>400: Group structure or member is not valid</p>
-</li>
-<li>
-<p>400: Domain in the source is not managed by the DomainList</p>
-</li>
-<li>
-<p>409: Requested group address is already used for another purpose</p>
-</li>
-<li>
-<p>409: The addition of the group member would lead to a loop and thus cannot be performed</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_removing_a_group_member"><a class="anchor" href="#_removing_a_group_member"></a>Removing a group member</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/address/groups/group@domain.com/member@domain.com</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will remove <a href="mailto:member@domain.com">member@domain.com</a> from <a href="mailto:group@domain.com">group@domain.com</a>, removing the group
-if group is empty after deletion</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Success</p>
-</li>
-<li>
-<p>400: Group structure or member is not valid</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_address_forwards"><a class="anchor" href="#_address_forwards"></a>Address forwards</h3>
-<div class="paragraph">
-<p>You can use <strong>webadmin</strong> to define address forwards.</p>
-</div>
-<div class="paragraph">
-<p>When a specific email is sent to the base mail address, every forward
-destination addresses will receive it.</p>
-</div>
-<div class="paragraph">
-<p>Please note that the base address can be optionaly part of the forward
-destination. In that case, the base recipient also receive a copy of the
-mail. Otherwise he is omitted.</p>
-</div>
-<div class="paragraph">
-<p>Forwards can be defined for existing users. It then defers from
-``groups''.</p>
-</div>
-<div class="paragraph">
-<p>This feature uses <a href="../architecture/index.html#_recipient_rewrite_tables" class="xref page">Recipients rewrite table</a>
-and requires the
-<a 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>
-</div>
-<div class="paragraph">
-<p>Note that email addresses are restricted to ASCII character set. Mail
-addresses not matching this criteria will be rejected.</p>
-</div>
-<div class="sect3">
-<h4 id="_listing_forwards"><a class="anchor" href="#_listing_forwards"></a>Listing Forwards</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/address/forwards</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the users having forwards configured as a list of JSON
-Strings representing mail addresses. For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>["user1@domain.com", "user2@domain.com"]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_listing_destinations_in_a_forward"><a class="anchor" href="#_listing_destinations_in_a_forward"></a>Listing destinations in a forward</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/address/forwards/user@domain.com</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the destination addresses of this forward as a list of JSON
-Strings representing mail addresses. For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[
- {"mailAddress":"destination1@domain.com"},
- {"mailAddress":"destination2@domain.com"}
-]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success</p>
-</li>
-<li>
-<p>400: Forward structure is not valid</p>
-</li>
-<li>
-<p>404: The given user don’t have forwards or does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_adding_a_new_destination_to_a_forward"><a class="anchor" href="#_adding_a_new_destination_to_a_forward"></a>Adding a new destination to a forward</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/address/forwards/user@domain.com/targets/destination@domain.com</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will add <a href="mailto:destination@domain.com">destination@domain.com</a> to <a href="mailto:user@domain.com">user@domain.com</a>, creating the forward
-if needed</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Success</p>
-</li>
-<li>
-<p>400: Forward structure or member is not valid</p>
-</li>
-<li>
-<p>400: Domain in the source is not managed by the DomainList</p>
-</li>
-<li>
-<p>404: Requested forward address does not match an existing user</p>
-</li>
-<li>
-<p>409: The creation of the forward would lead to a loop and thus cannot be performed</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_removing_a_destination_of_a_forward"><a class="anchor" href="#_removing_a_destination_of_a_forward"></a>Removing a destination of a forward</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/address/forwards/user@domain.com/targets/destination@domain.com</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will remove <a href="mailto:destination@domain.com">destination@domain.com</a> from <a href="mailto:user@domain.com">user@domain.com</a>, removing the
-forward if forward is empty after deletion</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Success</p>
-</li>
-<li>
-<p>400: Forward structure or member is not valid</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_address_aliases"><a class="anchor" href="#_address_aliases"></a>Address aliases</h3>
-<div class="paragraph">
-<p>You can use <strong>webadmin</strong> to define aliases for an user.</p>
-</div>
-<div class="paragraph">
-<p>When a specific email is sent to the alias address, the destination
-address of the alias will receive it.</p>
-</div>
-<div class="paragraph">
-<p>Aliases can be defined for existing users.</p>
-</div>
-<div class="paragraph">
-<p>This feature uses <a href="../architecture/index.html#_recipient_rewrite_tables" class="xref page">Recipients rewrite table</a>
-and requires the
-<a 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>
-</div>
-<div class="paragraph">
-<p>Note that email addresses are restricted to ASCII character set. Mail
-addresses not matching this criteria will be rejected.</p>
-</div>
-<div class="sect3">
-<h4 id="_listing_users_with_aliases"><a class="anchor" href="#_listing_users_with_aliases"></a>Listing users with aliases</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/address/aliases</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the users having aliases configured as a list of JSON
-Strings representing mail addresses. For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>["user1@domain.com", "user2@domain.com"]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_listing_alias_sources_of_an_user"><a class="anchor" href="#_listing_alias_sources_of_an_user"></a>Listing alias sources of an user</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/address/aliases/user@domain.com</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the aliases of this user as a list of JSON Strings
-representing mail addresses. For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[
- {"source":"alias1@domain.com"},
- {"source":"alias2@domain.com"}
-]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success</p>
-</li>
-<li>
-<p>400: Alias structure is not valid</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_adding_a_new_alias_to_an_user"><a class="anchor" href="#_adding_a_new_alias_to_an_user"></a>Adding a new alias to an user</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/address/aliases/user@domain.com/sources/alias@domain.com</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will add <a href="mailto:alias@domain.com">alias@domain.com</a> to <a href="mailto:user@domain.com">user@domain.com</a>, creating the alias if
-needed</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: OK</p>
-</li>
-<li>
-<p>400: Alias structure or member is not valid</p>
-</li>
-<li>
-<p>400: Source and destination can’t be the same!</p>
-</li>
-<li>
-<p>400: Domain in the destination or source is not managed by the
-DomainList</p>
-</li>
-<li>
-<p>409: The alias source exists as an user already</p>
-</li>
-<li>
-<p>409: The addition of the alias would lead to a loop and thus cannot be performed</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_removing_an_alias_of_an_user"><a class="anchor" href="#_removing_an_alias_of_an_user"></a>Removing an alias of an user</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/address/aliases/user@domain.com/sources/alias@domain.com</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will remove <a href="mailto:alias@domain.com">alias@domain.com</a> from <a href="mailto:user@domain.com">user@domain.com</a>, removing the alias if
-needed</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: OK</p>
-</li>
-<li>
-<p>400: Alias structure or member is not valid</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_domain_mappings"><a class="anchor" href="#_domain_mappings"></a>Domain mappings</h3>
-<div class="paragraph">
-<p>You can use <strong>webadmin</strong> to define domain mappings.</p>
-</div>
-<div class="paragraph">
-<p>Given a configured source (from) domain and a destination (to) domain,
-when an email is sent to an address belonging to the source domain, then
-the domain part of this address is overwritten, the destination domain
-is then used. A source (from) domain can have many destination (to)
-domains.</p>
-</div>
-<div class="paragraph">
-<p>For example: with a source domain <code>james.apache.org</code> maps to two
-destination domains <code>james.org</code> and <code>apache-james.org</code>, when a mail is
-sent to <code>admin@james.apache.org</code>, then it will be routed to
-<code>admin@james.org</code> and <code>admin@apache-james.org</code></p>
-</div>
-<div class="paragraph">
-<p>This feature uses <a href="../architecture/index.html#_recipient_rewrite_tables" class="xref page">Recipients rewrite table</a>
-and requires the
-<a 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>
-</div>
-<div class="paragraph">
-<p>Note that email addresses are restricted to ASCII character set. Mail
-addresses not matching this criteria will be rejected.</p>
-</div>
-<div class="sect3">
-<h4 id="_listing_all_domain_mappings"><a class="anchor" href="#_listing_all_domain_mappings"></a>Listing all domain mappings</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/domainMappings</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return all configured domain mappings</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "firstSource.org" : ["firstDestination.com", "secondDestination.net"],
- "secondSource.com" : ["thirdDestination.com", "fourthDestination.net"],
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: OK</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_listing_all_destination_domains_for_a_source_domain"><a class="anchor" href="#_listing_all_destination_domains_for_a_source_domain"></a>Listing all destination domains for a source domain</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/domainMappings/sourceDomain.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>With <code>sourceDomain.tld</code> as the value passed to <code>fromDomain</code> resource
-name, the API will return all destination domains configured to that
-domain</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>["firstDestination.com", "secondDestination.com"]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: OK</p>
-</li>
-<li>
-<p>400: The <code>fromDomain</code> resource name is invalid</p>
-</li>
-<li>
-<p>404: The <code>fromDomain</code> resource name is not found</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_adding_a_domain_mapping"><a class="anchor" href="#_adding_a_domain_mapping"></a>Adding a domain mapping</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/domainMappings/sourceDomain.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Body:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>destination.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>With <code>sourceDomain.tld</code> as the value passed to <code>fromDomain</code> resource
-name, the API will add a destination domain specified in the body to
-that domain</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: OK</p>
-</li>
-<li>
-<p>400: The <code>fromDomain</code> resource name is invalid</p>
-</li>
-<li>
-<p>400: The destination domain specified in the body is invalid</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Be aware that no checks to find possible loops that would result of this creation will be performed.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_removing_a_domain_mapping"><a class="anchor" href="#_removing_a_domain_mapping"></a>Removing a domain mapping</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/domainMappings/sourceDomain.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Body:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>destination.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>With <code>sourceDomain.tld</code> as the value passed to <code>fromDomain</code> resource
-name, the API will remove a destination domain specified in the body
-mapped to that domain</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: OK</p>
-</li>
-<li>
-<p>400: The <code>fromDomain</code> resource name is invalid</p>
-</li>
-<li>
-<p>400: The destination domain specified in the body is invalid</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_regex_mapping"><a class="anchor" href="#_regex_mapping"></a>Regex mapping</h3>
-<div class="paragraph">
-<p>You can use <strong>webadmin</strong> to create regex mappings.</p>
-</div>
-<div class="paragraph">
-<p>A regex mapping contains a mapping source and a Java Regular Expression
-(regex) in String as the mapping value. Everytime, if a mail containing
-a recipient matched with the mapping source, then that mail will be
-re-routed to a new recipient address which is re written by the regex.</p>
-</div>
-<div class="paragraph">
-<p>This feature uses <a href="../architecture/index.html#_recipient_rewrite_tables" class="xref page">Recipients rewrite table</a>
-and requires the
-<a href="https://github.com/apache/james-project/blob/master/server/mailet/mailets/src/main/java/org/apache/james/transport/mailets/RecipientRewriteTable.java">RecipientRewriteTable
-API</a> to be configured.</p>
-</div>
-<div class="sect3">
-<h4 id="_adding_a_regex_mapping"><a class="anchor" href="#_adding_a_regex_mapping"></a>Adding a regex mapping</h4>
-<div class="literalblock">
-<div class="content">
-<pre>POST /mappings/regex/mappingSource/targets/regex</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Where:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>the <code>mappingSource</code> is the path parameter represents for the Regex
-Mapping mapping source</p>
-</li>
-<li>
-<p>the <code>regex</code> is the path parameter represents for the Regex Mapping
-regex</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The route will add a regex mapping made from <code>mappingSource</code> and <code>regex</code>
-to RecipientRewriteTable.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/mappings/regex/james@domain.tld/targets/james@.*:james-intern@james.org</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Mapping added successfully.</p>
-</li>
-<li>
-<p>400: Invalid <code>mappingSource</code> path parameter.</p>
-</li>
-<li>
-<p>400: Invalid <code>regex</code> path parameter.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Be aware that no checks to find possible loops that would result of this creation will be performed.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_removing_a_regex_mapping"><a class="anchor" href="#_removing_a_regex_mapping"></a>Removing a regex mapping</h4>
-<div class="literalblock">
-<div class="content">
-<pre>DELETE /mappings/regex/{mappingSource}/targets/{regex}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Where:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>the <code>mappingSource</code> is the path parameter representing the Regex
-Mapping mapping source</p>
-</li>
-<li>
-<p>the <code>regex</code> is the path parameter representing the Regex Mapping regex</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The route will remove the regex mapping made from <code>regex</code> from the
-mapping source <code>mappingSource</code> to RecipientRewriteTable.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/mappings/regex/james@domain.tld/targets/[O_O]:james-intern@james.org</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Mapping deleted successfully.</p>
-</li>
-<li>
-<p>400: Invalid <code>mappingSource</code> path parameter.</p>
-</li>
-<li>
-<p>400: Invalid <code>regex</code> path parameter.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_address_mappings"><a class="anchor" href="#_address_mappings"></a>Address Mappings</h3>
-<div class="paragraph">
-<p>You can use <strong>webadmin</strong> to define address mappings.</p>
-</div>
-<div class="paragraph">
-<p>When a specific email is sent to the base mail address, every
-destination addresses will receive it.</p>
-</div>
-<div class="paragraph">
-<p>This feature uses <a href="../architecture/index.html#_recipient_rewrite_tables" class="xref page">Recipients rewrite table</a>
-and requires the
-<a 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>
-</div>
-<div class="paragraph">
-<p>Note that email addresses are restricted to ASCII character set. Mail
-addresses not matching this criteria will be rejected.</p>
-</div>
-<div class="paragraph">
-<p>Please use address mappings with caution, as it’s not a typed address.
-If you know the type of your address (forward, alias, domain, group,
-etc), prefer using the corresponding routes to those types.</p>
-</div>
-<div class="paragraph">
-<p>Here are the following actions available on address mappings:</p>
-</div>
-<div class="sect3">
-<h4 id="_add_an_address_mapping"><a class="anchor" href="#_add_an_address_mapping"></a>Add an address mapping</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/mappings/address/{mappingSource}/targets/{destinationAddress}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Add an address mapping to the Recipients rewrite table
-Mapping source is the value of {mappingSource} Mapping destination is
-the value of {destinationAddress} Type of mapping destination is
-Address</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Action successfully performed</p>
-</li>
-<li>
-<p>400: Invalid parameters</p>
-</li>
-<li>
-<p>409: The addition of the address mapping would lead to a loop and thus cannot be performed</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_remove_an_address_mapping"><a class="anchor" href="#_remove_an_address_mapping"></a>Remove an address mapping</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/mappings/address/{mappingSource}/targets/{destinationAddress}</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Remove an address mapping from the Recipients rewrite table</p>
-</li>
-<li>
-<p>Mapping source is the value of <code>mappingSource</code></p>
-</li>
-<li>
-<p>Mapping destination is the value of <code>destinationAddress</code></p>
-</li>
-<li>
-<p>Type of mapping destination is Address</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Action successfully performed</p>
-</li>
-<li>
-<p>400: Invalid parameters</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_list_all_mappings"><a class="anchor" href="#_list_all_mappings"></a>List all mappings</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mappings</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Get all mappings from the
-<a href="../architecture/index.html#_recipient_rewrite_tables" class="xref page">Recipients rewrite table</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response body:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "alias@domain.tld": [
- {
- "type": "Alias",
- "mapping": "user@domain.tld"
- },
- {
- "type": "Group",
- "mapping": "group-user@domain.tld"
- }
- ],
- "aliasdomain.tld": [
- {
- "type": "Domain",
- "mapping": "realdomain.tld"
- }
- ],
- "group@domain.tld": [
- {
- "type": "Address",
- "mapping": "user@domain.tld"
- }
- ]
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response code:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: OK</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_listing_user_mappings"><a class="anchor" href="#_listing_user_mappings"></a>Listing User Mappings</h3>
-<div class="paragraph">
-<p>This endpoint allows receiving all mappings of a corresponding user.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mappings/user/{userAddress}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Return all mappings of a user where:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>userAddress</code>: is the selected user</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Response body:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[
- {
- "type": "Address",
- "mapping": "user123@domain.tld"
- },
- {
- "type": "Alias",
- "mapping": "aliasuser123@domain.tld"
- },
- {
- "type": "Group",
- "mapping": "group123@domain.tld"
- }
-]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: OK</p>
-</li>
-<li>
-<p>400: Invalid parameter value</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_administrating_mail_repositories"><a class="anchor" href="#_administrating_mail_repositories"></a>Administrating mail repositories</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_create_a_mail_repository"><a class="anchor" href="#_create_a_mail_repository"></a>Create a mail repository</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/mailRepositories/{encodedPathOfTheRepository}?protocol={someProtocol}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>encodedPathOfTheRepository</code> should be the resource path
-of the created mail repository. Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/mailRepositories/mailRepo?protocol=file</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The repository is created</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_listing_mail_repositories"><a class="anchor" href="#_listing_mail_repositories"></a>Listing mail repositories</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mailRepositories</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[
- {
- "repository": "var/mail/error/",
- "path": "var%2Fmail%2Ferror%2F"
- },
- {
- "repository": "var/mail/relay-denied/",
- "path": "var%2Fmail%2Frelay-denied%2F"
- },
- {
- "repository": "var/mail/spam/",
- "path": "var%2Fmail%2Fspam%2F"
- },
- {
- "repository": "var/mail/address-error/",
- "path": "var%2Fmail%2Faddress-error%2F"
- }
-]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can use <code>id</code>, the encoded URL of the repository, to access it in
-later requests.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The list of mail repositories</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_getting_additional_information_for_a_mail_repository"><a class="anchor" href="#_getting_additional_information_for_a_mail_repository"></a>Getting additional information for a mail repository</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mailRepositories/{encodedPathOfTheRepository}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>encodedPathOfTheRepository</code> should be the resource path
-of an existing mail repository. Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mailRepositories/var%2Fmail%2Ferror%2F</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "repository": "var/mail/error/",
- "path": "mail%2Ferror%2F",
- "size": 243
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Additonnal information for that repository</p>
-</li>
-<li>
-<p>404: This repository can not be found</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_listing_mails_contained_in_a_mail_repository"><a class="anchor" href="#_listing_mails_contained_in_a_mail_repository"></a>Listing mails contained in a mail repository</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mailRepositories/{encodedPathOfTheRepository}/mails</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>encodedPathOfTheRepository</code> should be the resource path
-of an existing mail repository. Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mailRepositories/var%2Fmail%2Ferror%2F/mails</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The answer will contains all mailKey contained in that repository.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[
- "mail-key-1",
- "mail-key-2",
- "mail-key-3"
-]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note that this can be used to read mail details.</p>
-</div>
-<div class="paragraph">
-<p>You can pass additional URL parameters to this call in order to limit
-the output: - A limit: no more elements than the specified limit will be
-returned. This needs to be strictly positive. If no value is specified,
-no limit will be applied. - An offset: allow to skip elements. This
-needs to be positive. Default value is zero.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET 'http://ip:port/mailRepositories/var%2Fmail%2Ferror%2F/mails?limit=100&offset=500'</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The list of mail keys contained in that mail repository</p>
-</li>
-<li>
-<p>400: Invalid parameters</p>
-</li>
-<li>
-<p>404: This repository can not be found</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_readingdownloading_a_mail_details"><a class="anchor" href="#_readingdownloading_a_mail_details"></a>Reading/downloading a mail details</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mailRepositories/{encodedPathOfTheRepository}/mails/mailKey</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>encodedPathOfTheRepository</code> should be the resource path
-of an existing mail repository. Resource name <code>mailKey</code> should be the
-key of a mail stored in that repository. Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mailRepositories/var%2Fmail%2Ferror%2F/mails/mail-key-1</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If the Accept header in the request is ``application/json'', then the
-response looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "name": "mail-key-1",
- "sender": "sender@domain.com",
- "recipients": ["recipient1@domain.com", "recipient2@domain.com"],
- "state": "address-error",
- "error": "A small message explaining what happened to that mail...",
- "remoteHost": "111.222.333.444",
- "remoteAddr": "127.0.0.1",
- "lastUpdated": null
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If the Accept header in the request is ``message/rfc822'', then the
-response will be the <em>eml</em> file itself.</p>
-</div>
-<div class="paragraph">
-<p>Additional query parameter <code>additionalFields</code> add the existing
-information to the response for the supported values (only work with
-``application/json'' Accept header):</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>attributes</p>
-</li>
-<li>
-<p>headers</p>
-</li>
-<li>
-<p>textBody</p>
-</li>
-<li>
-<p>htmlBody</p>
-</li>
-<li>
-<p>messageSize</p>
-</li>
-<li>
-<p>perRecipientsHeaders</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mailRepositories/file%3A%2F%2Fvar%2Fmail%2Ferror%2F/mails/mail-key-1?additionalFields=attributes,headers,textBody,htmlBody,messageSize,perRecipientsHeaders</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Give the following kind of response:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "name": "mail-key-1",
- "sender": "sender@domain.com",
- "recipients": ["recipient1@domain.com", "recipient2@domain.com"],
- "state": "address-error",
- "error": "A small message explaining what happened to that mail...",
- "remoteHost": "111.222.333.444",
- "remoteAddr": "127.0.0.1",
- "lastUpdated": null,
- "attributes": {
- "name2": "value2",
- "name1": "value1"
- },
- "perRecipientsHeaders": {
- "third@party": {
- "headerName1": [
- "value1",
- "value2"
- ],
- "headerName2": [
- "value3",
- "value4"
- ]
- }
- },
- "headers": {
- "headerName4": [
- "value6",
- "value7"
- ],
- "headerName3": [
- "value5",
- "value8"
- ]
- },
- "textBody": "My body!!",
- "htmlBody": "My <em>body</em>!!",
- "messageSize": 42424242
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Details of the mail</p>
-</li>
-<li>
-<p>404: This repository or mail can not be found</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_removing_a_mail_from_a_mail_repository"><a class="anchor" href="#_removing_a_mail_from_a_mail_repository"></a>Removing a mail from a mail repository</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/mailRepositories/{encodedPathOfTheRepository}/mails/mailKey</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>encodedPathOfTheRepository</code> should be the resource path
-of an existing mail repository. Resource name <code>mailKey</code> should be the
-key of a mail stored in that repository. Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/mailRepositories/var%2Fmail%2Ferror%2F/mails/mail-key-1</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: This mail no longer exists in this repository</p>
-</li>
-<li>
-<p>404: This repository can not be found</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_removing_all_mails_from_a_mail_repository"><a class="anchor" href="#_removing_all_mails_from_a_mail_repository"></a>Removing all mails from a mail repository</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/mailRepositories/{encodedPathOfTheRepository}/mails</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>encodedPathOfTheRepository</code> should be the resource path
-of an existing mail repository. Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/mailRepositories/var%2Fmail%2Ferror%2F/mails</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Task generation succeeded. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>404: Could not find that mail repository</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>clear-mail-repository</code>
-and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "mailRepositoryPath":"var/mail/error/",
- "initialCount": 243,
- "remainingCount": 17
-}</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_reprocessing_mails_from_a_mail_repository"><a class="anchor" href="#_reprocessing_mails_from_a_mail_repository"></a>Reprocessing mails from a mail repository</h3>
-<div class="paragraph">
-<p>Sometime, you want to re-process emails stored in a mail repository. For
-instance, you can make a configuration error, or there can be a James
-bug that makes processing of some mails fail. Those mail will be stored
-in a mail repository. Once you solved the problem, you can reprocess
-them.</p>
-</div>
-<div class="paragraph">
-<p>To reprocess mails from a repository:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPATCH http://ip:port/mailRepositories/{encodedPathOfTheRepository}/mails?action=reprocess</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>encodedPathOfTheRepository</code> should be the resource path
-of an existing mail repository. Example:</p>
-</div>
-<div class="paragraph">
-<p>For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPATCH http://ip:port/mailRepositories/var%2Fmail%2Ferror%2F/mails?action=reprocess</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Additional query parameters are supported:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>queue</code> allows you to
-target the mail queue you want to enqueue the mails in. Defaults to
-<code>spool</code>.</p>
-</li>
-<li>
-<p><code>processor</code> allows you to overwrite the state of the
-reprocessing mails, and thus select the processors they will start their
-processing in. Defaults to the <code>state</code> field of each processed email.</p>
-</li>
-<li>
-<p><code>consume</code> (boolean defaulting to <code>true</code>) whether the reprocessing should consume the mail in its originating mail repository. Passing
-this value to <code>false</code> allows non destructive reprocessing as you keep a copy of the email in the mail repository and can be valuable
-when debugging.</p>
-</li>
-<li>
-<p><code>limit</code> (integer value. Optional, default is empty). It enables to limit the count of elements reprocessed.
-If unspecified the count of the processed elements is unbounded.</p>
-</li>
-<li>
-<p><code>maxRetries</code> Optional integer, defaults to no max retries limit. Only processed emails that had been retried less
-than this value. Ignored by default.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>redeliver_group_events</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPATCH 'http://ip:port/mailRepositories/var%2Fmail%2Ferror%2F/mails?action=reprocess&processor=transport&queue=spool'</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note that the <code>action</code> query parameter is compulsary and can only take
-value <code>reprocess</code>.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Task generation succeeded. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>404: Could not find that mail repository</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>reprocessing-all</code> and
-the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "mailRepositoryPath":"var/mail/error/",
- "targetQueue":"spool",
- "targetProcessor":"transport",
- "initialCount": 243,
- "remainingCount": 17
-}</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_reprocessing_a_specific_mail_from_a_mail_repository"><a class="anchor" href="#_reprocessing_a_specific_mail_from_a_mail_repository"></a>Reprocessing a specific mail from a mail repository</h3>
-<div class="paragraph">
-<p>To reprocess a specific mail from a mail repository:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPATCH http://ip:port/mailRepositories/{encodedPathOfTheRepository}/mails/mailKey?action=reprocess</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>encodedPathOfTheRepository</code> should be the resource id of
-an existing mail repository. Resource name <code>mailKey</code> should be the key
-of a mail stored in that repository. Example:</p>
-</div>
-<div class="paragraph">
-<p>For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPATCH http://ip:port/mailRepositories/var%2Fmail%2Ferror%2F/mails/name1?action=reprocess</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Additional query parameters are supported:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>queue</code> allows you to
-target the mail queue you want to enqueue the mails in. Defaults to
-<code>spool</code>.</p>
-</li>
-<li>
-<p><code>processor</code> allows you to overwrite the state of the
-reprocessing mails, and thus select the processors they will start their
-processing in. Defaults to the <code>state</code> field of each processed email.</p>
-</li>
-<li>
-<p><code>consume</code> (boolean defaulting to <code>true</code>) whether the reprocessing should consume the mail in its originating mail repository. Passing
-this value to <code>false</code> allows non destructive reprocessing as you keep a copy of the email in the mail repository and can be valuable
-when debugging.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>While <code>processor</code> being an optional parameter, not specifying it will
-result reprocessing the mails in their current state
-(<a href="https://james.apache.org/server/feature-mailetcontainer.html#Processors">see
-documentation about processors and state</a>). Consequently, only few cases
-will give a different result, definitively storing them out of the mail
-repository.</p>
-</div>
-<div class="paragraph">
-<p>For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPATCH 'http://ip:port/mailRepositories/var%2Fmail%2Ferror%2F/mails/name1?action=reprocess&processor=transport&queue=spool'</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note that the <code>action</code> query parameter is compulsary and can only take
-value <code>reprocess</code>.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Task generation succeeded. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>404: Could not find that mail repository</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>reprocessing-one</code> and
-the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "mailRepositoryPath":"var/mail/error/",
- "targetQueue":"spool",
- "targetProcessor":"transport",
- "mailKey":"name1"
-}</pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_administrating_mail_queues"><a class="anchor" href="#_administrating_mail_queues"></a>Administrating mail queues</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_listing_mail_queues"><a class="anchor" href="#_listing_mail_queues"></a>Listing mail queues</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mailQueues</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>["outgoing","spool"]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The list of mail queues</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_getting_a_mail_queue_details"><a class="anchor" href="#_getting_a_mail_queue_details"></a>Getting a mail queue details</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mailQueues/{mailQueueName}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>mailQueueName</code> is the name of a mail queue, this command
-will return the details of the given mail queue. For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"name":"outgoing","size":0}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success</p>
-</li>
-<li>
-<p>400: Mail queue is not valid</p>
-</li>
-<li>
-<p>404: The mail queue does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_listing_the_mails_of_a_mail_queue"><a class="anchor" href="#_listing_the_mails_of_a_mail_queue"></a>Listing the mails of a mail queue</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mailQueues/{mailQueueName}/mails</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Additional URL query parameters:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>limit</code>: Maximum number of mails returned in a single call. Only
-strictly positive integer values are accepted. Example:</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mailQueues/{mailQueueName}/mails?limit=100</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[{
- "name": "Mail1516976156284-8b3093b9-eebf-4c40-9c26-1450f4fcdc3c-to-test.com",
- "sender": "user@james.linagora.com",
- "recipients": ["someone@test.com"],
- "nextDelivery": "1969-12-31T23:59:59.999Z"
-}]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success</p>
-</li>
-<li>
-<p>400: Mail queue is not valid or limit is invalid</p>
-</li>
-<li>
-<p>404: The mail queue does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_deleting_mails_from_a_mail_queue"><a class="anchor" href="#_deleting_mails_from_a_mail_queue"></a>Deleting mails from a mail queue</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/mailQueues/{mailQueueName}/mails?sender=senderMailAddress</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>This request should have exactly one query parameter from the following
-list:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>sender: which is a mail address (i.e. <a href="mailto:sender@james.org">sender@james.org</a>)</p>
-</li>
-<li>
-<p>name: which is a string</p>
-</li>
-<li>
-<p>recipient: which is a mail address (i.e. <a href="mailto:recipient@james.org">recipient@james.org</a>)</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The mails from the given mail queue matching the query parameter will be
-deleted.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Task generation succeeded. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Invalid request</p>
-</li>
-<li>
-<p>404: The mail queue does not exist</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type
-<code>delete-mails-from-mail-queue</code> and the following
-<code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "queue":"outgoing",
- "initialCount":10,
- "remainingCount": 5,
- "sender": "sender@james.org",
- "name": "Java Developer",
- "recipient: "recipient@james.org"
-}</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_clearing_a_mail_queue"><a class="anchor" href="#_clearing_a_mail_queue"></a>Clearing a mail queue</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/mailQueues/{mailQueueName}/mails</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>All mails from the given mail queue will be deleted.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Task generation succeeded. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Invalid request</p>
-</li>
-<li>
-<p>404: The mail queue does not exist</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>clear-mail-queue</code> and
-the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "queue":"outgoing",
- "initialCount":10,
- "remainingCount": 0
-}</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_flushing_mails_from_a_mail_queue"><a class="anchor" href="#_flushing_mails_from_a_mail_queue"></a>Flushing mails from a mail queue</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPATCH http://ip:port/mailQueues/{mailQueueName}?delayed=true \
- -d '{"delayed": false}' \
- -H "Content-Type: application/json"</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>This request should have the query parameter <em>delayed</em> set to <em>true</em>, in
-order to indicate only delayed mails are affected. The payload should
-set the <code>delayed</code> field to false inorder to remove the delay. This is
-the only supported combination, and it performs a flush.</p>
-</div>
-<div class="paragraph">
-<p>The mails delayed in the given mail queue will be flushed.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Success (No content)</p>
-</li>
-<li>
-<p>400: Invalid request</p>
-</li>
-<li>
-<p>404: The mail queue does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_rabbitmq_republishing_a_mail_queue_from_cassandra"><a class="anchor" href="#_rabbitmq_republishing_a_mail_queue_from_cassandra"></a>RabbitMQ republishing a mail queue from cassandra</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST 'http://ip:port/mailQueues/{mailQueueName}?action=RepublishNotProcessedMails&olderThan=1d'</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>This method is specific to the distributed flavor of James, which relies
-on Cassandra and RabbitMQ for implementing a mail queue. In case of a
-RabbitMQ crash resulting in a loss of messages, this task can be
-launched to repopulate the <code>mailQueueName</code> queue in RabbitMQ using the
-information stored in Cassandra.</p>
-</div>
-<div class="paragraph">
-<p>The <code>olderThan</code> parameter is mandatory. It filters the mails to be
-restored, by taking into account only the mails older than the given
-value. The expected value should be expressed in the following format:
-<code>Nunit</code>. <code>N</code> should be strictly positive. <code>unit</code> could be either in the
-short form (<code>h</code>, <code>d</code>, <code>w</code>, etc.), or in the long form (<code>day</code>, <code>week</code>,
-<code>month</code>, etc.).</p>
-</div>
-<div class="paragraph">
-<p>Examples:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>5h</code></p>
-</li>
-<li>
-<p><code>7d</code></p>
-</li>
-<li>
-<p><code>1y</code></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Task created</p>
-</li>
-<li>
-<p>400: Invalid request</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The response body contains the id of the republishing task.
-<code>{ "taskId": "a650a66a-5984-431e-bdad-f1baad885856" }</code></p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_cassandra_view_of_the_rabbitmq_mailqueue_browse_start_update"><a class="anchor" href="#_cassandra_view_of_the_rabbitmq_mailqueue_browse_start_update"></a>Cassandra view of the RabbitMQ mailQueue: browse start update</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST 'http://ip:port/mailQueues/{mailQueueName}?action=updateBrowseStart</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return a task that updates the browse start of the aforementioned mailQueue, regardless of the configuration.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>This is an advanced, potentially expensive operation which requires a good understanding of the RabbitMQMailQueue design
-(<a href="https://github.com/apache/james-project/blob/master/src/adr/0031-distributed-mail-queue.md" class="bare">https://github.com/apache/james-project/blob/master/src/adr/0031-distributed-mail-queue.md</a>). Especially, care needs to
-be taken to call this at most once per slice (not doing so might be expensive).</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_sending_email_over_webadmin"><a class="anchor" href="#_sending_email_over_webadmin"></a>Sending email over webAdmin</h2>
-<div class="sectionbody">
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /mail-transfer-service
-
-{MIME message}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will send the following email to the recipients specified in the MIME message.</p>
-</div>
-<div class="paragraph">
-<p>The <code>{MIME message}</code> payload must match <code>message/rfc822</code> format.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_event_dead_letter"><a class="anchor" href="#_event_dead_letter"></a>Event Dead Letter</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The EventBus allows to register `group listeners' that are called in a
-distributed fashion. These group listeners enable the implementation of
-some advanced mailbox manager feature like indexing, spam reporting,
-quota management and the like.</p>
-</div>
-<div class="paragraph">
-<p>Upon exceptions, a bounded number of retries are performed (with
-exponential backoff delays). If after those retries the listener is
-still failing, then the event will be stored in the ``Event Dead
-Letter''. This API allows diagnosing issues, as well as performing event
-replay.</p>
-</div>
-<div class="sect2">
-<h3 id="_listing_mailbox_listener_groups"><a class="anchor" href="#_listing_mailbox_listener_groups"></a>Listing mailbox listener groups</h3>
-<div class="paragraph">
-<p>This endpoint allows discovering the list of mailbox listener groups.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/events/deadLetter/groups</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return a list of group names that can be further used to interact
-with the dead letter API:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>["org.apache.james.mailbox.events.EventBusTestFixture$GroupA", "org.apache.james.mailbox.events.GenericGroup-abc"]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success. A list of group names is returned.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_listing_failed_events"><a class="anchor" href="#_listing_failed_events"></a>Listing failed events</h3>
-<div class="paragraph">
-<p>This endpoint allows listing failed events for a given group:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/events/deadLetter/groups/org.apache.james.mailbox.events.EventBusTestFixture$GroupA</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return a list of insertionIds:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>["6e0dd59d-660e-4d9b-b22f-0354479f47b4", "58a8f59d-660e-4d9b-b22f-0354486322a2"]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success. A list of insertion ids is returned.</p>
-</li>
-<li>
-<p>400: Invalid group name</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_getting_event_details"><a class="anchor" href="#_getting_event_details"></a>Getting event details</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/events/deadLetter/groups/org.apache.james.mailbox.events.EventBusTestFixture$GroupA/6e0dd59d-660e-4d9b-b22f-0354479f47b4</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the full JSON associated with this event.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success. A JSON representing this event is returned.</p>
-</li>
-<li>
-<p>400: Invalid group name or <code>insertionId</code></p>
-</li>
-<li>
-<p>404: No event with this <code>insertionId</code></p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_deleting_an_event"><a class="anchor" href="#_deleting_an_event"></a>Deleting an event</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/events/deadLetter/groups/org.apache.james.mailbox.events.EventBusTestFixture$GroupA/6e0dd59d-660e-4d9b-b22f-0354479f47b4</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will delete this event.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Success</p>
-</li>
-<li>
-<p>400: Invalid group name or <code>insertionId</code></p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_deleting_all_events_of_a_group"><a class="anchor" href="#_deleting_all_events_of_a_group"></a>Deleting all events of a group</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/events/deadLetter/groups/org.apache.james.mailbox.events.EventBusTestFixture$GroupA</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will delete all events of this group.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Success</p>
-</li>
-<li>
-<p>400: Invalid group name</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_redeliver_all_events"><a class="anchor" href="#_redeliver_all_events"></a>Redeliver all events</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/events/deadLetter?action=reDeliver</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Additional query parameters are supported:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>limit</code> (integer value. Optional, default is empty). It enables to limit the count of elements redelivered.
-If unspecified the count of the processed elements is unbounded</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/events/deadLetter?action=reDeliver&limit=10</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will create a task that will attempt to redeliver all events stored in
-<code>Event Dead Letter''. If successful, redelivered events will then be
-removed from </code>Dead Letter''.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: the taskId of the created task</p>
-</li>
-<li>
-<p>400: Invalid action argument</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_redeliver_group_events"><a class="anchor" href="#_redeliver_group_events"></a>Redeliver group events</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/events/deadLetter/groups/org.apache.james.mailbox.events.EventBusTestFixture$GroupA?action=reDeliver</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will create a task that will attempt to redeliver all events of a
-particular group stored in <code>Event Dead Letter''. If successful,
-redelivered events will then be removed from </code>Dead Letter''.</p>
-</div>
-<div class="paragraph">
-<p>Additional query parameters are supported:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>limit</code> (integer value. Optional, default is empty). It enables to limit the count of elements redelivered.
-If unspecified the count of the processed elements is unbounded</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/events/deadLetter/groups/org.apache.james.mailbox.events.EventBusTestFixture$GroupA?action=reDeliver&limit=10</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: the taskId of the created task</p>
-</li>
-<li>
-<p>400: Invalid group name or action argument</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_redeliver_a_single_event"><a class="anchor" href="#_redeliver_a_single_event"></a>Redeliver a single event</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/events/deadLetter/groups/org.apache.james.mailbox.events.EventBusTestFixture$GroupA/6e0dd59d-660e-4d9b-b22f-0354479f47b4?action=reDeliver</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will create a task that will attempt to redeliver a single event of a
-particular group stored in <code>Event Dead Letter''. If successful,
-redelivered event will then be removed from </code>Dead Letter''.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: the taskId of the created task</p>
-</li>
-<li>
-<p>400: Invalid group name, insertion id or action argument</p>
-</li>
-<li>
-<p>404: No event with this insertionId</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_cassandra_extra_operations"><a class="anchor" href="#_cassandra_extra_operations"></a>Cassandra extra operations</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Some webadmin features to manage some extra operations on Cassandra
-tables, like solving inconsistencies on projection tables. Such
-inconsistencies can be for example created by a fail of the DAO to add a
-mapping into
-’mappings_sources`, while it was successful regarding the`rrt` table.</p>
-</div>
-<div class="sect2">
-<h3 id="_operations_on_mappings_sources"><a class="anchor" href="#_operations_on_mappings_sources"></a>Operations on mappings sources</h3>
-<div class="paragraph">
-<p>You can do a series of action on <code>mappings_sources</code> projection table :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /cassandra/mappings?action={action}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the taskId corresponding to the related task. Actions
-supported so far are :</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>SolveInconsistencies : cleans up first all the mappings in
-<code>mappings_sources</code> index and then repopulate it correctly. In the
-meantime, listing sources of a mapping might create temporary
-inconsistencies during the process.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>For example :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /cassandra/mappings?action=SolveInconsistencies</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes :</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: the taskId of the created task</p>
-</li>
-<li>
-<p>400: Invalid action argument for performing operation on mappings data</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_cassandra_schema_upgrades"><a class="anchor" href="#_cassandra_schema_upgrades"></a>Cassandra Schema upgrades</h3>
-<div class="paragraph">
-<p>Cassandra upgrades implies the creation of a new table. Thus restarting
-James is needed, as new tables are created on restart.</p>
-</div>
-<div class="paragraph">
-<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>
-</div>
-<div class="paragraph">
-<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>
-</div>
-<div class="paragraph">
-<p>These schema updates can be triggered by webadmin using the Cassandra
-backend.</p>
-</div>
-<div class="paragraph">
-<p>Note that currently the progress can be tracked by logs.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="#<em>retrieving_current_cassandra_schema_version</em>">Retrieving current
-Cassandra schema version</a></p>
-</li>
-<li>
-<p><a href="#<em>retrieving_latest_available_cassandra_schema_version</em>">Retrieving
-latest available Cassandra schema version</a></p>
-</li>
-<li>
-<p><a href="#<em>upgrading_to_a_specific_version</em>">Upgrading to a specific version</a></p>
-</li>
-<li>
-<p><a href="#<em>upgrading_to_the_latest_version</em>">Upgrading to the latest version</a></p>
-</li>
-</ul>
-</div>
-<div class="sect3">
-<h4 id="_retrieving_current_cassandra_schema_version"><a class="anchor" href="#_retrieving_current_cassandra_schema_version"></a>Retrieving current Cassandra schema version</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/cassandra/version</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"version": 2}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Where the number corresponds to the current schema version of the
-database you are using.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_retrieving_latest_available_cassandra_schema_version"><a class="anchor" href="#_retrieving_latest_available_cassandra_schema_version"></a>Retrieving latest available Cassandra schema version</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/cassandra/version/latest</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"version": 3}</pre>
-</div>
-</div>
-<div class="paragraph">
-<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>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_upgrading_to_a_specific_version"><a class="anchor" href="#_upgrading_to_a_specific_version"></a>Upgrading to a specific version</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST -H "Content-Type: application/json http://ip:port/cassandra/version/upgrade -d '3'</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule the run of the migrations you need to reach schema version
-3.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success. The scheduled task <code>taskId</code> is returned.</p>
-</li>
-<li>
-<p>400: The version is invalid. The version should be a strictly positive
-number.</p>
-</li>
-<li>
-<p>410: Error while planning this migration. This resource is gone away.
-Reason is mentionned in the body.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Note that several calls to this endpoint will be run in a sequential
-pattern.</p>
-</div>
-<div class="paragraph">
-<p>If the server restarts during the migration, the migration is silently
-aborted.</p>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>cassandra-migration</code>
-and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"targetVersion":3}</pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_upgrading_to_the_latest_version"><a class="anchor" href="#_upgrading_to_the_latest_version"></a>Upgrading to the latest version</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/cassandra/version/upgrade/latest</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule the run of the migrations you need to reach the latest
-schema version.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success. The scheduled task <code>taskId</code> is returned.</p>
-</li>
-<li>
-<p>410: Error while planning this migration. This resource is gone away.
-Reason is mentionned in the body.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Note that several calls to this endpoint will be run in a sequential
-pattern.</p>
-</div>
-<div class="paragraph">
-<p>If the server restarts during the migration, the migration is silently
-aborted.</p>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>cassandra-migration</code>
-and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"toVersion":2}</pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_correcting_ghost_mailbox"><a class="anchor" href="#_correcting_ghost_mailbox"></a>Correcting ghost mailbox</h3>
-<div class="paragraph">
-<p>This is a temporary workaround for the <strong>Ghost mailbox</strong> bug encountered
-using the Cassandra backend, as described in MAILBOX-322.</p>
-</div>
-<div class="paragraph">
-<p>You can use the mailbox merging feature in order to merge the old
-``ghosted'' mailbox with the new one.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/cassandra/mailbox/merging \
- -d '{"mergeOrigin":"{id1}", "mergeDestination":"{id2}"}' \
- -H "Content-Type: application/json"</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will scedule a task for :</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Delete references to <code>id1</code> mailbox</p>
-</li>
-<li>
-<p>Move it’s messages into <code>id2</code> mailbox</p>
-</li>
-<li>
-<p>Union the rights of both mailboxes</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Task generation succeeded. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Unable to parse the body.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>mailbox-merging</code> and
-the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "oldMailboxId":"5641376-02ed-47bd-bcc7-76ff6262d92a",
- "newMailboxId":"4555159-52ae-895f-ccb7-586a4412fb50",
- "totalMessageCount": 1,
- "messageMovedCount": 1,
- "messageFailedCount": 0
-}</pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_deleted_messages_vault"><a class="anchor" href="#_deleted_messages_vault"></a>Deleted Messages Vault</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The `Deleted Message Vault plugin' allows you to keep users deleted
-messages during a given retention time. This set of routes allow you to
-<em>restore</em> users deleted messages or export them in an archive.</p>
-</div>
-<div class="paragraph">
-<p>To move deleted messages in the vault, you need to specifically
-configure the DeletedMessageVault PreDeletionHook.</p>
-</div>
-<div class="sect2">
-<h3 id="_restore_deleted_messages"><a class="anchor" href="#_restore_deleted_messages"></a>Restore Deleted Messages</h3>
-<div class="paragraph">
-<p>Deleted messages of a specific user can be restored by calling the
-following endpoint:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/deletedMessages/users/userToRestore@domain.ext?action=restore
-
-{
- "combinator": "and",
- "criteria": [
- {
- "fieldName": "subject",
- "operator": "containsIgnoreCase",
- "value": "Apache James"
- },
- {
- "fieldName": "deliveryDate",
- "operator": "beforeOrEquals",
- "value": "2014-10-30T14:12:00Z"
- },
- {
- "fieldName": "deletionDate",
- "operator": "afterOrEquals",
- "value": "2015-10-20T09:08:00Z"
- },
- {
- "fieldName": "recipients","
- "operator": "contains","
- "value": "recipient@james.org"
- },
- {
- "fieldName": "hasAttachment",
- "operator": "equals",
- "value": "false"
- },
- {
- "fieldName": "sender",
- "operator": "equals",
- "value": "sender@apache.org"
- },
- {
- "fieldName": "originMailboxes",
- "operator": "contains",
- "value": "02874f7c-d10e-102f-acda-0015176f7922"
- }
- ]
-};</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The requested Json body is made from a list of criterion objects which
-have the following structure:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "fieldName": "supportedFieldName",
- "operator": "supportedOperator",
- "value": "A plain string representing the matching value of the corresponding field"
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Deleted Messages which are matched with the <strong>all</strong> criterion in the query
-body will be restored. Here are a list of supported fieldName for the
-restoring:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>subject: represents for deleted message <code>subject</code> field matching.
-Supports below string operators:</p>
-<div class="ulist">
-<ul>
-<li>
-<p>contains</p>
-</li>
-<li>
-<p>containsIgnoreCase</p>
-</li>
-<li>
-<p>equals</p>
-</li>
-<li>
-<p>equalsIgnoreCase</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p>deliveryDate: represents for deleted message <code>deliveryDate</code> field
-matching. Tested value should follow the right date time with zone
-offset format (ISO-8601) like <code>2008-09-15T15:53:00+05:00</code> or
-<code>2008-09-15T15:53:00Z</code> Supports below date time operators:</p>
-<div class="ulist">
-<ul>
-<li>
-<p>beforeOrEquals: is the deleted message’s <code>deliveryDate</code> before or
-equals the time of tested value.</p>
-</li>
-<li>
-<p>afterOrEquals: is the deleted message’s <code>deliveryDate</code> after or
-equals the time of tested value</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p>deletionDate: represents for deleted message <code>deletionDate</code> field
-matching. Tested value & Supports operators: similar to <code>deliveryDate</code></p>
-</li>
-<li>
-<p>sender: represents for deleted message <code>sender</code> field matching. Tested
-value should be a valid mail address. Supports mail address operator:</p>
-<div class="ulist">
-<ul>
-<li>
-<p>equals: does the tested sender equal to the sender of the tested
-deleted message ?<br></p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p>recipients: represents for deleted message <code>recipients</code> field
-matching. Tested value should be a valid mail address. Supports list
-mail address operator:</p>
-<div class="ulist">
-<ul>
-<li>
-<p>contains: does the tested deleted message’s recipients contain tested
-recipient ?</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p>hasAttachment: represents for deleted message <code>hasAttachment</code> field
-matching. Tested value could be <code>false</code> or <code>true</code>. Supports boolean
-operator:</p>
-<div class="ulist">
-<ul>
-<li>
-<p>equals: does the tested deleted message’s hasAttachment property
-equal to the tested hasAttachment value?</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p>originMailboxes: represents for deleted message <code>originMailboxes</code>
-field matching. Tested value is a string serialized of mailbox id.
-Supports list mailbox id operators:</p>
-<div class="ulist">
-<ul>
-<li>
-<p>contains: does the tested deleted message’s originMailbox ids contain
-tested mailbox id ?</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Messages in the Deleted Messages Vault of a specified user that are
-matched with Query Json Object in the body will be appended to his
-`Restored-Messages' mailbox, which will be created if needed.</p>
-</div>
-<div class="paragraph">
-<p><strong>Note</strong>:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Query parameter <code>action</code> is required and should have the value
-<code>restore</code> to represent the restoring feature. Otherwise, a bad request
-response will be returned</p>
-</li>
-<li>
-<p>Query parameter <code>action</code> is case sensitive</p>
-</li>
-<li>
-<p>fieldName & operator passed to the routes are case sensitive</p>
-</li>
-<li>
-<p>Currently, we only support query combinator <code>and</code> value, otherwise,
-requests will be rejected</p>
-</li>
-<li>
-<p>If you only want to restore by only one criterion, the json body could
-be simplified to a single criterion:</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "fieldName": "subject",
- "operator": "containsIgnoreCase",
- "value": "Apache James"
-}</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>For restoring all deleted messages, passing a query json with an empty
-criterion list to represent <code>matching all deleted messages</code>:</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "combinator": "and",
- "criteria": []
-}</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>For limiting the number of restored messages, you can use the <code>limit</code> query property:</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "combinator": "and",
- "limit": 99
- "criteria": []
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>Warning</strong>: Current web-admin uses <code>US</code> locale as the default. Therefore,
-there might be some conflicts when using String <code>containsIgnoreCase</code>
-comparators to apply on the String data of other special locales stored
-in the Vault. More details at
-<a href="https://issues.apache.org/jira/browse/MAILBOX-384">JIRA</a></p>
-</div>
-<div class="paragraph">
-<p>Response code:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Task for restoring deleted has been created</p>
-</li>
-<li>
-<p>400: Bad request:</p>
-<div class="ulist">
-<ul>
-<li>
-<p>action query param is not present</p>
-</li>
-<li>
-<p>action query param is not a valid action</p>
-</li>
-<li>
-<p>user parameter is invalid</p>
-</li>
-<li>
-<p>can not parse the JSON body</p>
-</li>
-<li>
-<p>Json query object contains unsupported operator, fieldName</p>
-</li>
-<li>
-<p>Json query object values violate parsing rules</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p>404: User not found</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type
-<code>deleted-messages-restore</code> and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "successfulRestoreCount": 47,
- "errorRestoreCount": 0,
- "user": "userToRestore@domain.ext"
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>while:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>successfulRestoreCount: number of restored messages</p>
-</li>
-<li>
-<p>errorRestoreCount: number of messages that failed to restore</p>
-</li>
-<li>
-<p>user: owner of deleted messages need to restore</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_export_deleted_messages"><a class="anchor" href="#_export_deleted_messages"></a>Export Deleted Messages</h3>
-<div class="paragraph">
-<p>Retrieve deleted messages matched with requested query from an user then
-share the content to a targeted mail address (exportTo)</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST 'http://ip:port/deletedMessages/users/userExportFrom@domain.ext?action=export&exportTo=userReceiving@domain.ext'
-
-BODY: is the json query has the same structure with Restore Deleted Messages section</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>Note</strong>: Json query passing into the body follows the same rules &
-restrictions like in <a href="#_restore_deleted_messages">Restore Deleted
-Messages</a></p>
-</div>
-<div class="paragraph">
-<p>Response code:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Task for exporting has been created</p>
-</li>
-<li>
-<p>400: Bad request:</p>
-<div class="ulist">
-<ul>
-<li>
-<p>exportTo query param is not present</p>
-</li>
-<li>
-<p>exportTo query param is not a valid mail address</p>
-</li>
-<li>
-<p>action query param is not present</p>
-</li>
-<li>
-<p>action query param is not a valid action</p>
-</li>
-<li>
-<p>user parameter is invalid</p>
-</li>
-<li>
-<p>can not parse the JSON body</p>
-</li>
-<li>
-<p>Json query object contains unsupported operator, fieldName</p>
-</li>
-<li>
-<p>Json query object values violate parsing rules</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p>404: User not found</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type
-<code>deleted-messages-export</code> and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "userExportFrom": "userToRestore@domain.ext",
- "exportTo": "userReceiving@domain.ext",
- "totalExportedMessages": 1432
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>while:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>userExportFrom: export deleted messages from this user</p>
-</li>
-<li>
-<p>exportTo: content of deleted messages have been shared to this mail
-address</p>
-</li>
-<li>
-<p>totalExportedMessages: number of deleted messages match with
-json query, then being shared to sharee.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_purge_deleted_messages"><a class="anchor" href="#_purge_deleted_messages"></a>Purge Deleted Messages</h3>
-<div class="paragraph">
-<p>You can overwrite `retentionPeriod' configuration in
-`deletedMessageVault' configuration file or use the default value of 1
-year.</p>
-</div>
-<div class="paragraph">
-<p>Purge all deleted messages older than the configured `retentionPeriod'</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/deletedMessages?scope=expired</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response code:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Task for purging has been created</p>
-</li>
-<li>
-<p>400: Bad request:</p>
-<div class="ulist">
-<ul>
-<li>
-<p>action query param is not present</p>
-</li>
-<li>
-<p>action query param is not a valid action</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>You may want to call this endpoint on a regular basis.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_permanently_remove_deleted_message"><a class="anchor" href="#_permanently_remove_deleted_message"></a>Permanently Remove Deleted Message</h3>
-<div class="paragraph">
-<p>Delete a Deleted Message with <code>MessageId</code></p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/deletedMessages/users/user@domain.ext/messages/3294a976-ce63-491e-bd52-1b6f465ed7a2</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response code:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Task for deleting message has been created</p>
-</li>
-<li>
-<p>400: Bad request:</p>
-<div class="ulist">
-<ul>
-<li>
-<p>user parameter is invalid</p>
-</li>
-<li>
-<p>messageId parameter is invalid</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p>404: User not found</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type
-<code>deleted-messages-delete</code> and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> {
- "userName": "user@domain.ext",
- "messageId": "3294a976-ce63-491e-bd52-1b6f465ed7a2"
- }</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>while: - user: delete deleted messages from this user - deleteMessageId:
-messageId of deleted messages will be delete</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_administrating_dlp_configuration"><a class="anchor" href="#_administrating_dlp_configuration"></a>Administrating DLP Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>DLP (stands for Data Leak Prevention) is supported by James. A DLP
-matcher will, on incoming emails, execute regular expressions on email
-sender, recipients or content, in order to report suspicious emails to
-an administrator. WebAdmin can be used to manage these DLP rules on a
-per <code>senderDomain</code> basis.</p>
-</div>
-<div class="paragraph">
-<p><code>senderDomain</code> is domain of the sender of incoming emails, for example:
-<code>apache.org</code>, <code>james.org</code>,… Each <code>senderDomain</code> correspond to a distinct
-DLP configuration.</p>
-</div>
-<div class="sect2">
-<h3 id="_list_dlp_configuration_by_sender_domain"><a class="anchor" href="#_list_dlp_configuration_by_sender_domain"></a>List DLP configuration by sender domain</h3>
-<div class="paragraph">
-<p>Retrieve a DLP configuration for corresponding <code>senderDomain</code>, a
-configuration contains list of configuration items</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/dlp/rules/{senderDomain}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: A list of dlp configuration items is returned</p>
-</li>
-<li>
-<p>400: Invalid <code>senderDomain</code> or payload in request</p>
-</li>
-<li>
-<p>404: The domain does not exist.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This is an example of returned body. The rules field is a list of rules
-as described below.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"rules : [
- {
- "id": "1",
- "expression": "james.org",
- "explanation": "Find senders or recipients containing james[any char]org",
- "targetsSender": true,
- "targetsRecipients": true,
- "targetsContent": false
- },
- {
- "id": "2",
- "expression": "Find senders containing apache[any char]org",
- "explanation": "apache.org",
- "targetsSender": true,
- "targetsRecipients": false,
- "targetsContent": false
- }
-]}</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_store_dlp_configuration_by_sender_domain"><a class="anchor" href="#_store_dlp_configuration_by_sender_domain"></a>Store DLP configuration by sender domain</h3>
-<div class="paragraph">
-<p>Store a DLP configuration for corresponding <code>senderDomain</code>, if any item
-of DLP configuration in the request is stored before, it will not be
-stored anymore</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/dlp/rules/{senderDomain}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The body can contain a list of DLP configuration items formed by those
-fields: - <code>id</code>(String) is mandatory, unique identifier of the
-configuration item - <code>expression</code>(String) is mandatory, regular
-expression to match contents of targets - <code>explanation</code>(String) is
-optional, description of the configuration item -
-<code>targetsSender</code>(boolean) is optional and defaults to false. If true,
-<code>expression</code> will be applied to Sender and to From headers of the mail -
-<code>targetsContent</code>(boolean) is optional and defaults to false. If true,
-<code>expression</code> will be applied to Subject headers and textual bodies
-(text/plain and text/html) of the mail - <code>targetsRecipients</code>(boolean) is
-optional and defaults to false. If true, <code>expression</code> will be applied to
-recipients of the mail</p>
-</div>
-<div class="paragraph">
-<p>This is an example of returned body. The rules field is a list of rules
-as described below.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"rules": [
- {
- "id": "1",
- "expression": "james.org",
- "explanation": "Find senders or recipients containing james[any char]org",
- "targetsSender": true,
- "targetsRecipients": true,
- "targetsContent": false
- },
- {
- "id": "2",
- "expression": "Find senders containing apache[any char]org",
- "explanation": "apache.org",
- "targetsSender": true,
- "targetsRecipients": false,
- "targetsContent": false
- }
-]}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: List of dlp configuration items is stored</p>
-</li>
-<li>
-<p>400: Invalid <code>senderDomain</code> or payload in request</p>
-</li>
-<li>
-<p>404: The domain does not exist.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_remove_dlp_configuration_by_sender_domain"><a class="anchor" href="#_remove_dlp_configuration_by_sender_domain"></a>Remove DLP configuration by sender domain</h3>
-<div class="paragraph">
-<p>Remove a DLP configuration for corresponding <code>senderDomain</code></p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/dlp/rules/{senderDomain}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: DLP configuration is removed</p>
-</li>
-<li>
-<p>400: Invalid <code>senderDomain</code> or payload in request</p>
-</li>
-<li>
-<p>404: The domain does not exist.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_fetch_a_dlp_configuration_item_by_sender_domain_and_rule_id"><a class="anchor" href="#_fetch_a_dlp_configuration_item_by_sender_domain_and_rule_id"></a>Fetch a DLP configuration item by sender domain and rule id</h3>
-<div class="paragraph">
-<p>Retrieve a DLP configuration rule for corresponding <code>senderDomain</code> and a
-<code>ruleId</code></p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/dlp/rules/{senderDomain}/rules/{ruleId}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: A dlp configuration item is returned</p>
-</li>
-<li>
-<p>400: Invalid <code>senderDomain</code> or payload in request</p>
-</li>
-<li>
-<p>404: The domain and/or the rule does not exist.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This is an example of returned body.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "id": "1",
- "expression": "james.org",
- "explanation": "Find senders or recipients containing james[any char]org",
- "targetsSender": true,
- "targetsRecipients": true,
- "targetsContent": false
-}</pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_reloading_server_certificates"><a class="anchor" href="#_reloading_server_certificates"></a>Reloading server certificates</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Certificates for TCP based protocols (IMAP, SMTP, POP3, LMTP and ManageSieve) can be updated at
-runtime, without service interuption and without closing existing connections.</p>
-</div>
-<div class="paragraph">
-<p>In order to do so:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Generate / retrieve your cryptographic materials and replace the ones specified in James configuration.</p>
-</li>
-<li>
-<p>Then call the following endpoint:</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/servers?reload-certificate</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Optional query parameters:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>port</code>: positive integer (valid port number). Only reload certificates for the specific port.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Return code:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: the certificate is reloaded</p>
-</li>
-<li>
-<p>400: Invalid request.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/run/index.html b/james-distributed-app/3.8.0/run/index.html
deleted file mode 100644
index fba1dd2..0000000
--- a/james-distributed-app/3.8.0/run/index.html
+++ /dev/null
@@ -1,436 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Run :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item is-current-page" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Run</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/run/index.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Run</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This sections presents guidance to all current deployment types of Distributed James Server.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_run_with_java"><a class="anchor" href="#_run_with_java"></a>Run with Java</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Build your own Apache James Distributed artifacts and start <a href="run-java.html" class="xref page">Running it directly on a Java Virtual Machine</a>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_run_with_docker"><a class="anchor" href="#_run_with_docker"></a>Run with Docker</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>We have prepared a docker-compose for Apache James to run with Cassandra & OpenSearch.</p>
-</div>
-<div class="paragraph">
-<p>You can start <a href="run-docker.html" class="xref page">Running James with few simple Docker commands</a>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_run_with_kubernetes"><a class="anchor" href="#_run_with_kubernetes"></a>Run with Kubernetes</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>A more complete - production ready deployment type.</p>
-</div>
-<div class="paragraph">
-<p>We have packed <a href="run-kubernetes.html" class="xref page">Apache James in a Helm chart</a>, parameterized most of the application resources. With it you can easily deploy and test different set of configuration on a Kubernetes Cluster.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/run/k8s-checklist.html b/james-distributed-app/3.8.0/run/k8s-checklist.html
deleted file mode 100644
index 4a6829c..0000000
--- a/james-distributed-app/3.8.0/run/k8s-checklist.html
+++ /dev/null
@@ -1,515 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Checklist :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Run</a></li>
- <li><a href="run-kubernetes.html">Run with Kubernetes</a></li>
- <li><a href="k8s-checklist.html">Deployment Checklist</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/run/k8s-checklist.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Checklist</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>There is some things that you must have before being able to run James on your Kubernetes Cluster.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_must_have"><a class="anchor" href="#_must_have"></a>MUST have</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Those are absolutely necessary if you want at least James to start without crashing.</p>
-</div>
-<div class="ulist checklist">
-<ul class="checklist">
-<li>
-<p><i class="fa fa-square-o"></i> Setup RabbitMQ and create James user in it.</p>
-</li>
-<li>
-<p><i class="fa fa-square-o"></i> Create a Kubernetes namespace for James deployment.</p>
-</li>
-<li>
-<p><i class="fa fa-square-o"></i> A <code>distributed</code> version of James image.</p>
-</li>
-<li>
-<p><i class="fa fa-square-o"></i> An ObjectStorage compatible with S3 APIs.</p>
-</li>
-<li>
-<p><i class="fa fa-square-o"></i> Configure JWT keys, keystores.</p>
-</li>
-<li>
-<p><i class="fa fa-square-o"></i> Adding the proper <code>mailetcontainer.xml</code> file with other conf files in James Helm package</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>With those you should be able to startup James for first tests without having it crashing. However it’s still not enough to have it fully functional.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_should_have"><a class="anchor" href="#_should_have"></a>Should have</h2>
-<div class="sectionbody">
-<div class="ulist checklist">
-<ul class="checklist">
-<li>
-<p><i class="fa fa-square-o"></i> Cassandra nodes deployed.</p>
-</li>
-<li>
-<p><i class="fa fa-square-o"></i> Put valid Cassandra keyspaces in the configuration.</p>
-</li>
-<li>
-<p><i class="fa fa-square-o"></i> Have an appropriate email domain (Contact your Domain Service Provider)</p>
-</li>
-<li>
-<p><i class="fa fa-square-o"></i> Create your Domain SPF and DKIM Record. See document [here](<a href="https://james.apache.org/howTo/" class="bare">https://james.apache.org/howTo/</a>)</p>
-</li>
-<li>
-<p><i class="fa fa-square-o"></i> OpenSearch nodes deployed.</p>
-</li>
-<li>
-<p><i class="fa fa-square-o"></i> DNS registered entries for JMAP, IMAP, SMTP, Webadmin.</p>
-</li>
-<li>
-<p><i class="fa fa-square-o"></i> Enable Ingress and create the secret for TLS certificate used by Ingress.</p>
-<div class="ulist">
-<ul>
-<li>
-<p>Preproduction: Usually, we use <a href="https://github.com/jetstack/cert-manager">cert-manager</a> to request a Let’s Encrypt Certificate. Remember to use the full chain certificate. You can verify that your certificate works well with <code>openssl</code> before adding
-the name of that secret to your James values.</p>
-</li>
-<li>
-<p>Production: Some certificates belonging to the client should exist already. See that with the team.</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p><i class="fa fa-square-o"></i> Change IMAP ports to NodePort if your Cloud Provider Load Balancer has short idle timeout and we need longer connections for performance reasons (and the RFC for IMAP states also we need 30 minutes for the timeout).</p>
-</li>
-<li>
-<p><i class="fa fa-square-o"></i> Use an external LB (ie. HA Proxy) to redirect traffic towards James IMAP service NodePort IPs and ports.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_after_setup_operations"><a class="anchor" href="#_after_setup_operations"></a>After setup operations</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>When all of this is working, normally your chain mail should be able to work. To check it you can:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Use a mail client (ThunderBird, Outlook, …​) to test James IMAP.</p>
-</li>
-<li>
-<p>Send a mail internally from one test account to an other.</p>
-</li>
-<li>
-<p>Send a mail from James to an external mail provider (your Gmail, Yahoo account for example).</p>
-</li>
-<li>
-<p>Send a mail from an external provider to James.</p>
-</li>
-<li>
-<p>Use services like <a href="https://www.mail-tester.com/">mail-tester</a> to check your score.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/run/k8s-logsMetrics.html b/james-distributed-app/3.8.0/run/k8s-logsMetrics.html
deleted file mode 100644
index 3d62ece..0000000
--- a/james-distributed-app/3.8.0/run/k8s-logsMetrics.html
+++ /dev/null
@@ -1,442 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Untitled :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Run</a></li>
- <li><a href="run-kubernetes.html">Run with Kubernetes</a></li>
- <li><a href="k8s-logsMetrics.html">Logs & Metrics</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/run/k8s-logsMetrics.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<div class="sect1">
-<h2 id="_logs_and_metrics"><a class="anchor" href="#_logs_and_metrics"></a>Logs and Metrics</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_logs"><a class="anchor" href="#_logs"></a>Logs</h3>
-<div class="paragraph">
-<p>James exposes its logs on the console. Then a fluent bit instance scraps
-and collects them, before being indexed and used by Kibana, with nice
-search possibilities.</p>
-</div>
-<div class="paragraph">
-<p>The way James exposes its logs on the console is defined in the
-<code>logback.xml</code> configuration file. James currently exposes logs in JSON
-format using Jackson Json formatter.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_metrics"><a class="anchor" href="#_metrics"></a>Metrics</h3>
-<div class="paragraph">
-<p>James exposes its metrics over an HTTP Webadmin endpoint, something like
-<code><a href="https://james-web-admin/metrics" class="bare">https://james-web-admin/metrics</a></code>. Those metrics can be scraped by
-Prometheus before being visualized on Grafana.</p>
-</div>
-<div class="paragraph">
-<p>This Helm chart exposes James metrics through Prometheus
-<a href="https://github.com/prometheus-operator/prometheus-operator/blob/master/Documentation/user-guides/getting-started.md#include-servicemonitors">ServiceMonitor</a>.</p>
-</div>
-<div class="paragraph">
-<p>You can import the dashboards for James metrics in Grafana defined
-<a href="https://github.com/apache/james-project/tree/master/server/grafana-reporting/prometheus-datasource">here</a>.</p>
-</div>
-<div class="paragraph">
-<p>Be aware that those dashboards still need more work, as we used to
-export metrics to Elasticsearch not long ago, which required to redo all
-dashboards. Some enhancements are highly possible and encouraged.</p>
-</div>
-<div class="paragraph">
-<p>Read more about <a href="../operate/metrics.html" class="xref page">Metrics in James</a>.</p>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/run/k8s-secrets.html b/james-distributed-app/3.8.0/run/k8s-secrets.html
deleted file mode 100644
index 7169a5f..0000000
--- a/james-distributed-app/3.8.0/run/k8s-secrets.html
+++ /dev/null
@@ -1,524 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Untitled :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Run</a></li>
- <li><a href="run-kubernetes.html">Run with Kubernetes</a></li>
- <li><a href="k8s-secrets.html">secrets.yaml</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/run/k8s-secrets.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<div class="sect1">
-<h2 id="_secrets_for_james_helm_template"><a class="anchor" href="#_secrets_for_james_helm_template"></a>Secrets for James Helm template</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Helm James has many secret values to configure before being able to use
-it correctly. Those secrets are linked to the template through their
-declaration in <code>james-secrets.yaml</code>. A sample with dumb secrets can be
-found in the <code>secrets.sample.yaml</code> file.</p>
-</div>
-<div class="paragraph">
-<p>This document presents a quick description of each secret field.</p>
-</div>
-<div class="paragraph">
-<p>For more information about encrypt/descrypt secret with Helm, see:
-<a href="https://github.com/jkroepke/helm-secrets" class="bare">https://github.com/jkroepke/helm-secrets</a></p>
-</div>
-<div class="sect2">
-<h3 id="_james_secret_values"><a class="anchor" href="#_james_secret_values"></a>James secret values</h3>
-<table class="tableblock frame-all grid-all stretch">
-<colgroup>
-<col style="width: 33.3333%;">
-<col style="width: 33.3333%;">
-<col style="width: 33.3334%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Field</th>
-<th class="tableblock halign-left valign-top">Mandatory or optional</th>
-<th class="tableblock halign-left valign-top">Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jwtPublicKey</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Mandatory</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The JWT public key used for JWT tokens.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jwtPrivateKey</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Mandatory</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The JWT private key used for JWT tokens.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandraUser</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Mandatory</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The user for Cassandra access</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandraPassword</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Mandatory</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The password fort Cassandra access</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">esUser</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The user for OpenSearch access</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">esPassword</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The password for OpenSearch access</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">dkimPrivateKey</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The private key for the generated DKIM</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">s3.endpoint</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Mandatory</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The S3 endpoint. ie:
-<a href="http://s3-us-east-1.amazonaws.com" class="bare">http://s3-us-east-1.amazonaws.com</a></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">s3.region</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Mandatory</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The region of the S3 object storage.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">s3.accessKeyId</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Mandatory</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The access key to the S3 object storage</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">s3.secretKey</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Mandatory</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The secret key to the S3 object storage</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">s3.bucketNameSuffix</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Mandatory</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">All buckets in S3 related to james
-storage start by ``james-''. This allows to have a suffix for each
-tenant</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="sect2">
-<h3 id="_jwtpublickey"><a class="anchor" href="#_jwtpublickey"></a>jwtPublicKey</h3>
-<div class="paragraph">
-<p>Use <code>openssl</code> to generate self-signed certificate and convert to Java
-Key Store JKS. You can find an example
-<a href="https://loneidealist.medium.com/generating-signing-certificates-with-openssl-and-converting-to-java-key-store-jks-3c8185dbf8fe">here</a></p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_dkim"><a class="anchor" href="#_dkim"></a>DKIM</h3>
-<div class="paragraph">
-<p>To generate DKIM, you can follow our guide:
-<a href="https://james.apache.org/howTo/dkim.html">howTo Dkim</a></p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_external_secrets"><a class="anchor" href="#_external_secrets"></a>External secrets</h3>
-<div class="paragraph">
-<p>Some declared secrets in <code>james-deployment.yaml</code> are external to the
-James configuration. They are often being created by other components
-like RabbitMQ or Cassandra. You need to have those setup before
-installing the Helm James package.</p>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/run/k8s-values.html b/james-distributed-app/3.8.0/run/k8s-values.html
deleted file mode 100644
index 42e3821..0000000
--- a/james-distributed-app/3.8.0/run/k8s-values.html
+++ /dev/null
@@ -1,798 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Untitled :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Run</a></li>
- <li><a href="run-kubernetes.html">Run with Kubernetes</a></li>
- <li><a href="k8s-values.html">values.yaml</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/run/k8s-values.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<div class="sect1">
-<h2 id="_values_for_helm_james_template"><a class="anchor" href="#_values_for_helm_james_template"></a>Values for Helm James template</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Helm James has many visible values to configure before being able to use
-it correctly. Values are injected into the deployment template as
-environment variables. An example with default values can be found in
-the <code>values.yaml</code> file.</p>
-</div>
-<div class="paragraph">
-<p>This document presents a quick description of each value field.</p>
-</div>
-<div class="sect2">
-<h3 id="_dns_values"><a class="anchor" href="#_dns_values"></a>DNS values</h3>
-<table class="tableblock frame-all grid-all stretch">
-<colgroup>
-<col style="width: 33.3333%;">
-<col style="width: 33.3333%;">
-<col style="width: 33.3334%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Field</th>
-<th class="tableblock halign-left valign-top">Default value</th>
-<th class="tableblock halign-left valign-top">Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">emailDomain</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mail.example.com</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The domain name for your tenant’s email
-addresses</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jmapUrl</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jmap.example.com</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The url for the ingress jmap endpoint</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">adminUrl</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">admin.example.com</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The url for the ingress admin endpoint</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">smtpHostname</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">smtp.example.com</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The SMTP Ehlo hostname</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="sect2">
-<h3 id="_james_values"><a class="anchor" href="#_james_values"></a>James values</h3>
-<table class="tableblock frame-all grid-all stretch">
-<colgroup>
-<col style="width: 33.3333%;">
-<col style="width: 33.3333%;">
-<col style="width: 33.3334%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Field</th>
-<th class="tableblock halign-left valign-top">Default value</th>
-<th class="tableblock halign-left valign-top">Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">replicaJmapInstanceCount</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">1</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The number of pods we deploy for James
-JMAP instance in the cluster</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">replicaImapSmtpInstanceCount</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">1</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The number of pods we deploy for James
-IMAP/SMTP instance in the cluster</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">image</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">apache/james:distributed-3.8.0</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The James image used for
-deployment (Cassandra - RabbitMQ - LDAP distributed James flavor)</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="sect2">
-<h3 id="_james_environment_values"><a class="anchor" href="#_james_environment_values"></a>James environment values</h3>
-<table class="tableblock frame-all grid-all stretch">
-<colgroup>
-<col style="width: 33.3333%;">
-<col style="width: 33.3333%;">
-<col style="width: 33.3334%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Field</th>
-<th class="tableblock halign-left valign-top">Default value</th>
-<th class="tableblock halign-left valign-top">Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jamesCassandraKeyspace</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">sandbox_james</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The keyspace used for Cassandra
-James data</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jamesCassandraCacheKeyspace</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">sandbox_james_cache</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The keyspace used for
-the Cassandra cache</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jamesEsMailboxIndex</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailbox_v1</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The index used for mailbox in
-OpenSearch. The default value should be enough, but in case you had
-issues and needed to create a new index, this will allow you to point
-James to it</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jamesEsClusterName</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">change-me</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Name of the cluster</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jamesEsHostScheme</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">http</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Only http or https are accepted</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jamesEsSslValidationStrategy</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ignore</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Choosing the SSL check strategy
-when using https scheme: <code>default</code> (use the default SSL TrustStore of
-the system), <code>ignore</code> (Ignore SSL Validation check (not recommended)),
-<code>override</code> (override the SSL Context to use a custom TrustStore
-containing ES server’s certificate)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jamesEsHostNameVerifier</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">default</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure OpenSearch rest client
-to use host name verifier during SSL handshake: <code>default</code> (using the
-default hostname verifier provided by apache http client),
-<code>accept_any_hostname</code> (accept any host (not recommended))</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jamesRabbitHost</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">change-me</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The host url for RabbitMQ used by James for
-mail processing</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jamesMessageSize</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">25M</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The default maximum size for each email is 25MB,
-Must be a positive integer, optionally with a unit: B, K, M, G.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jamesDkimSignSmtp</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">dkimselector</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">SMTP signature for DKIM, also called
-DKIM Selector</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jamesDkimSignDomain</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mail.example.com</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Domain signature for DKIM</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandraReplicationFactor</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">3</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The replication factor for Cassandra
-configuration</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jamesHELOMessage</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">change-me</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The SMTP Ehlo message</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jvmOpts</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">-Xms4g -Xmx4g</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Add the JVM_OPTIONS flag for the JVM resource
-allocation when starting James</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jamesResources.limits.cpu</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">2000m</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Limit of cpu allowed to James pod</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jamesResources.limits.memory</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">6Gi</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Limit of memory allowed to James pod</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jamesResources.requests.cpu</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">1000m</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Request of cpu allowed to James pod</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jamesResources.requests.memory</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">3Gi</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Request of memory allowed to James
-pod</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">glowroot.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Enabling or disabling Glowroot usage with
-James. It’s better to disable it for prod environments</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ingress.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Enabling or disabling Nginx Ingress. We are
-using it to expose JMAP and attach our SSL certificates for
-SMTP/IMAP/JMAP. Default is false</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">james.tls.secretName</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">the-name-of-a-secret</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The name of the secret
-created separately contenting the SSL certificate for JMAP, IMAPS and
-SMTPS</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="sect2">
-<h3 id="_cassandra_values"><a class="anchor" href="#_cassandra_values"></a>Cassandra values</h3>
-<div class="paragraph">
-<p>There is two ways to deploy Cassandra in our Helm packages, defined by
-the <code>deploy</code> field.</p>
-</div>
-<div class="sect3">
-<h4 id="_as_pod"><a class="anchor" href="#_as_pod"></a>as-pod</h4>
-<div class="paragraph">
-<p>Cassandra can be deployed as pods in the cluster. Parameters for this
-mode are:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<colgroup>
-<col style="width: 33.3333%;">
-<col style="width: 33.3333%;">
-<col style="width: 33.3334%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Field</th>
-<th class="tableblock halign-left valign-top">Default value</th>
-<th class="tableblock halign-left valign-top">Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">replicaCount</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">1</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The number of Cassandra pods</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">change-me</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Namespace of Cassandra deployment</p></td>
-</tr>
-</tbody>
-</table>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-note" title="Note"></i>
-</td>
-<td class="content">
-Pod name must match template format: <code>cassandra-01.namespace:9042,cassandra-02.namespace:9042</code>
-</td>
-</tr>
-</table>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_as_ref"><a class="anchor" href="#_as_ref"></a>as-ref</h4>
-<div class="paragraph">
-<p>Cassandra has been deployed in VMs and the nodes can be accessed through
-their IP addresses. Parameters for this mode are:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<colgroup>
-<col style="width: 33.3333%;">
-<col style="width: 33.3333%;">
-<col style="width: 33.3334%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Field</th>
-<th class="tableblock halign-left valign-top">Default value</th>
-<th class="tableblock halign-left valign-top">Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ips</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">1.2.3.4, 5.6.7.8, 9.10.11.12</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The list of Cassandra IP nodes.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_opensearch_values"><a class="anchor" href="#_opensearch_values"></a>OpenSearch values</h3>
-<div class="paragraph">
-<p>There is two ways to deploy OpenSearch in our Helm packages, defined
-by the <code>deploy</code> field.</p>
-</div>
-<div class="sect3">
-<h4 id="_as_pod_2"><a class="anchor" href="#_as_pod_2"></a>as-pod</h4>
-<div class="paragraph">
-<p>OpenSearch has been deployed as pods in the cluster. Parameters for
-this mode are:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<colgroup>
-<col style="width: 33.3333%;">
-<col style="width: 33.3333%;">
-<col style="width: 33.3334%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Field</th>
-<th class="tableblock halign-left valign-top">Default value</th>
-<th class="tableblock halign-left valign-top">Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">replicaCount</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">1</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The number of OpenSearch pods</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">change-me</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Namespace of OpenSearch deployment</p></td>
-</tr>
-</tbody>
-</table>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-note" title="Note"></i>
-</td>
-<td class="content">
-Pod name must match template format: <code>opensearch-01.namespace:9200,opensearch-02.namespace:9200</code>
-</td>
-</tr>
-</table>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_as_ref_2"><a class="anchor" href="#_as_ref_2"></a>as-ref</h4>
-<div class="paragraph">
-<p>OpenSearch has been deployed in VMs and the nodes can be accessed
-through their IP addresses. Parameters for this mode are:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<colgroup>
-<col style="width: 33.3333%;">
-<col style="width: 33.3333%;">
-<col style="width: 33.3334%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Field</th>
-<th class="tableblock halign-left valign-top">Default value</th>
-<th class="tableblock halign-left valign-top">Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ips</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">1.2.3.4, 5.6.7.8, 9.10.11.12</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The list of OpenSearch IP nodes.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/run/run-docker.html b/james-distributed-app/3.8.0/run/run-docker.html
deleted file mode 100644
index 0f1d025..0000000
--- a/james-distributed-app/3.8.0/run/run-docker.html
+++ /dev/null
@@ -1,619 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Run with docker :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run-java.html">Run with Java</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Run</a></li>
- <li><a href="run-docker.html">Run with Docker</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/run/run-docker.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Run with docker</h1>
-<div class="sect1">
-<h2 id="_running_via_docker_compose"><a class="anchor" href="#_running_via_docker_compose"></a>Running via docker-compose</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Requirements: docker & docker-compose installed.</p>
-</div>
-<div class="paragraph">
-<p>When you try James this way, you will use the most current state of James.
-It will be configured to run with Cassandra & OpenSearch.
-All those three components will be started with a single command.</p>
-</div>
-<div class="paragraph">
-<p>You can retrieve the docker-compose file : ( docker-compose file and james image name should be changed)</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ wget https://raw.githubusercontent.com/apache/james-project/master/server/apps/distributed-app/docker-compose.yml</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Then, you just have to start the services:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ docker-compose up -d</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Wait a few seconds in order to have all those services start up. You will see the following log when James is available:
-james | Started : true</p>
-</div>
-<div class="paragraph">
-<p>A default domain, james.local, has been created. You can see this by running:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ docker exec james james-cli -h 127.0.0.1 -p 9999 listdomains</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>James will respond to IMAP port 143 and SMTP port 25.
-You have to create users before playing with james. You may also want to create other domains.
-Follow the 'Useful commands' section for more information about James CLI.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_run_with_docker"><a class="anchor" href="#_run_with_docker"></a>Run with docker</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_requirements"><a class="anchor" href="#_requirements"></a>Requirements</h3>
-<div class="paragraph">
-<p>Compile the whole project:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>mvn clean install -DskipTests -T 4</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Then load the distributed server docker image:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>docker load -i server/apps/distributed-app/target/jib-image.tar</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Alternatively we provide convenience distribution for the latest release:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>docker pull apache/james:distributed-3.8.0</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_running"><a class="anchor" href="#_running"></a>Running</h3>
-<div class="paragraph">
-<p>Firstly, create your own user network on Docker for the James environment:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ docker network create --driver bridge james</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You need a running <strong>cassandra</strong> in docker which connects to <strong>james</strong> network. To achieve this run:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ docker run -d --network james --name=cassandra cassandra:4.1.3</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You need a running <strong>rabbitmq</strong> in docker which connects to <strong>james</strong> network. To achieve this run:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ docker run -d --network james --name=rabbitmq rabbitmq:3.12.1-management</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You need a running <strong>Zenko Cloudserver</strong> objectstorage in docker which connects to <strong>james</strong> network. To achieve this run:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ docker run -d --network james --env 'REMOTE_MANAGEMENT_DISABLE=1' --env 'SCALITY_ACCESS_KEY_ID=accessKey1' --env 'SCALITY_SECRET_ACCESS_KEY=secretKey1' --name=s3 registry.scality.com/cloudserver/cloudserver:8.7.25</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You need a running <strong>OpenSearch</strong> in docker which connects to <strong>james</strong> network. To achieve this run:</p>
-</div>
-<div class="paragraph">
-<p>$ docker run -d --network james -p 9200:9200 --name=opensearch --env 'discovery.type=single-node' opensearchproject/opensearch:2.1.0</p>
-</div>
-<div class="paragraph">
-<p>If you want to use all the JMAP search capabilities, you may also need to start Tika container which connects to <strong>james</strong> network:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ docker run -d --network james --name=tika apache/tika:2.8.0.0</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can find more explanation on the need of Tika in this <a href="../configure/tika.html" class="xref page">page</a>.</p>
-</div>
-<div class="paragraph">
-<p>To run this container :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ docker run --network james --hostname HOSTNAME -p "25:25" -p 80:80 -p "110:110" -p "143:143" -p "465:465" -p "587:587" -p "993:993" -p "127.0.0.1:8000:8000" --name james_run
- -v $PWD/keystore:/root/conf/keystore -t apache/james:distributed-3.8.0 --generate-keystore</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Where :</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>HOSTNAME: is the hostname you want to give to your James container. This DNS entry will be used to send mail to your James server.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Webadmin port binding is restricted to loopback as users are not authenticated by default on webadmin server. Thus you should avoid exposing it in production.
-Note that the above example assumes <code>127.0.0.1</code> is your loopback interface for convenience but you should change it if this is not the case on your machine.</p>
-</div>
-<div class="paragraph">
-<p>If you want to pass additional options to the underlying java command, you can configure a <em>JAVA_TOOL_OPTIONS</em> env variable, for example add:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>--env "JAVA_TOOL_OPTIONS=-Xms256m -Xmx2048m"</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>To have log file accessible on a volume, add <strong>-v $PWD/logs:/logs</strong> option to the above command line, where <strong>$PWD/logs</strong> is your local directory to put files in.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_specific_keystore"><a class="anchor" href="#_specific_keystore"></a>Specific keystore</h3>
-<div class="paragraph">
-<p>Alternatively, you can also generate a keystore in your conf folder with the
-following command, and drop <code>--generate-keystore</code> option:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ keytool -genkey -alias james -keyalg RSA -keystore conf/keystore</code></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_instrumentation"><a class="anchor" href="#_instrumentation"></a>Instrumentation</h3>
-<div class="paragraph">
-<p>You can use <a href="https://glowroot.org/">Glowroot</a> to instrumentalize James. It is packaged as part of the docker distribution to easily enable valuable performances insights.
-Disabled by default, its java agent can easily be enabled:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>--env "JAVA_TOOL_OPTIONS=-javaagent:/root/glowroot.jar" -p "4000:4000"</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>By default, the Glowroot UI is accessible from every machines in the network as defined in the <em>destination/admin.json</em>.
-Which you could configure before building the image, if you want to restrict its accessibility to localhost for example.
-See the <a href="https://github.com/glowroot/glowroot/wiki/Agent-Installation-(with-Embedded-Collector)#user-content-optional-post-installation-steps">Glowroot post installation steps</a> for more details.</p>
-</div>
-<div class="paragraph">
-<p>Or by mapping the 4000 port to the IP of the desired network interface, for example <code>-p 127.0.0.1:4000:4000</code>.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_handling_attachment_indexing"><a class="anchor" href="#_handling_attachment_indexing"></a>Handling attachment indexing</h3>
-<div class="paragraph">
-<p>You can handle attachment text extraction before indexing in OpenSearch. This makes attachments searchable. To enable this:</p>
-</div>
-<div class="paragraph">
-<p>Run tika connect to <strong>james</strong> network:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ docker run -d --network james --name tika apache/tika:2.8.0.0</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Run James:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ docker run --network james --hostname HOSTNAME -p "25:25" -p 80:80 -p "110:110" -p "143:143" -p "465:465" -p "587:587" -p "993:993" -p "127.0.0.1:8000:8000"
- --name james_run -v $PWD/keystore:/root/conf/keystore -t apache/james:distributed-latest</pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/run/run-java.html b/james-distributed-app/3.8.0/run/run-java.html
deleted file mode 100644
index 2ba15a2..0000000
--- a/james-distributed-app/3.8.0/run/run-java.html
+++ /dev/null
@@ -1,531 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Run :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Run</a></li>
- <li><a href="run-java.html">Run with Java</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/run/run-java.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Run</h1>
-<div class="sect1">
-<h2 id="_building"><a class="anchor" href="#_building"></a>Building</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_requirements"><a class="anchor" href="#_requirements"></a>Requirements</h3>
-<div class="ulist">
-<ul>
-<li>
-<p>Java 11 SDK</p>
-</li>
-<li>
-<p>Docker ∕ OpenSearch 2.1.0, RabbitMQ Management 3.8.18, S3 compatible
-ObjectStorage and Cassandra 4.0</p>
-</li>
-<li>
-<p>Maven 3</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_building_the_artifacts"><a class="anchor" href="#_building_the_artifacts"></a>Building the artifacts</h3>
-<div class="paragraph">
-<p>An usual compilation using maven will produce two artifacts into
-server/apps/distributed-app/target directory:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>james-server-distributed-app.jar</p>
-</li>
-<li>
-<p>james-server-distributed-app.lib</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>You can for example run in the base of
-<a href="https://github.com/apache/james-project">this git repository</a>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>mvn clean install</pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_running"><a class="anchor" href="#_running"></a>Running</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_requirements_2"><a class="anchor" href="#_requirements_2"></a>Requirements</h3>
-<div class="ulist">
-<ul>
-<li>
-<p>Cassandra 4.0</p>
-</li>
-<li>
-<p>OpenSearch 2.1.0</p>
-</li>
-<li>
-<p>RabbitMQ-Management 3.8.17</p>
-</li>
-<li>
-<p>Swift ObjectStorage 2.15.1 or Zenko Cloudserver or AWS S3</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_james_launch"><a class="anchor" href="#_james_launch"></a>James Launch</h3>
-<div class="paragraph">
-<p>To run james, you have to create a directory containing required
-configuration files.</p>
-</div>
-<div class="paragraph">
-<p>James requires the configuration to be in a subfolder of working
-directory that is called <strong>conf</strong>. You can get a sample directory for
-configuration from
-<a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/">server/apps/distributed-app/sample-configuration/</a>.
-You might need to adapt it to your needs.</p>
-</div>
-<div class="paragraph">
-<p>You need to have a Cassandra, OpenSearch, S3 and RabbitMQ instance
-running. You can either install the servers or launch them via docker:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ docker run -d -p 9042:9042 --name=cassandra cassandra:4.1.3
-$ docker run -d --network james -p 9200:9200 --name=opensearch --env 'discovery.type=single-node' opensearchproject/opensearch:2.1.0
-$ docker run -d -p 5672:5672 -p 15672:15672 --name=rabbitmq rabbitmq:3.12.1-management
-$ docker run -d --env 'REMOTE_MANAGEMENT_DISABLE=1' --env 'SCALITY_ACCESS_KEY_ID=accessKey1' --env 'SCALITY_SECRET_ACCESS_KEY=secretKey1' --name=s3 registry.scality.com/cloudserver/cloudserver:8.7.25</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Once everything is set up, you just have to run the jar with:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ java -Dworking.directory=. -jar target/james-server-distributed-app.jar --generate-keystore</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Alternatively, you can also generate a keystore in your conf folder with the
-following command, and drop <code>--generate-keystore</code> option:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ keytool -genkey -alias james -keyalg RSA -keystore conf/keystore</code></pre>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_using_aws_s3_of_zenko_cloudserver"><a class="anchor" href="#_using_aws_s3_of_zenko_cloudserver"></a>Using AWS S3 of Zenko Cloudserver</h4>
-<div class="paragraph">
-<p>By default, James is configured with [Zenko Cloudserver](<a href="https://hub.docker.com/r/zenko/cloudserver" class="bare">https://hub.docker.com/r/zenko/cloudserver</a>) which is compatible with AWS S3, in <code>blobstore.propeties</code> as such:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">implementation=s3
-objectstorage.namespace=james
-objectstorage.s3.endPoint=http://s3.docker.test:8000/
-objectstorage.s3.region=eu-west-1
-objectstorage.s3.accessKeyId=accessKey1
-objectstorage.s3.secretKey=secretKey1</code></pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.0/run/run-kubernetes.html b/james-distributed-app/3.8.0/run/run-kubernetes.html
deleted file mode 100644
index fe04bea..0000000
--- a/james-distributed-app/3.8.0/run/run-kubernetes.html
+++ /dev/null
@@ -1,778 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Run with Kubernetes :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.0 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.0/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Run</a></li>
- <li><a href="run-kubernetes.html">Run with Kubernetes</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/run/run-kubernetes.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Run with Kubernetes</h1>
-<div class="sect1">
-<h2 id="_deploy_apache_james_on_kubernetes_with_helm_chart"><a class="anchor" href="#_deploy_apache_james_on_kubernetes_with_helm_chart"></a>Deploy Apache James on Kubernetes with Helm chart.</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This chart bootstraps a James mail server on a <a href="http://kubernetes.io">Kubernetes</a>
-cluster using the <a href="https://helm.sh">Helm</a> package manager.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_before_starting"><a class="anchor" href="#_before_starting"></a>Before Starting</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Before running the Helm chart, James should have particularly accessed to the following external products:</p>
-</div>
-<div class="dlist">
-<dl>
-<dt class="hdlist1">Apache Cassandra</dt>
-<dd>
-<div class="ulist">
-<ul>
-<li>
-<p>You can deploy Cassandra on Kubernetes with a <a href="https://github.com/bitnami/charts/tree/master/bitnami/cassandra">Cassandra chart</a> for testing purpose. However we would recommend running Cassandra on VirtualMachine for better stablilty.</p>
-</li>
-</ul>
-</div>
-</dd>
-<dt class="hdlist1">OpenSearch</dt>
-<dd>
-<div class="ulist">
-<ul>
-<li>
-<p>OpenSearch community maintains <a href="https://github.com/opensearch-project/helm-charts">Helm charts</a></p>
-</li>
-</ul>
-</div>
-</dd>
-<dt class="hdlist1">RabbitMQ</dt>
-<dd>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://github.com/rabbitmq/cluster-operator">RabbitMQ Cluster Operator</a> is a custom Kubernetes resource designed for the lifecycle (creation, upgrade, graceful shutdown) of a RabbitMQ cluster. Using Quickstart setup is enough for James deployment.</p>
-</li>
-</ul>
-</div>
-</dd>
-</dl>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_configuration"><a class="anchor" href="#_configuration"></a>Configuration</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_helm_configuration"><a class="anchor" href="#_helm_configuration"></a>Helm Configuration</h3>
-<div class="paragraph">
-<p>The James helm package take parameters that will configure and determine the behavior of James.
-There are 2 configuration files:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>One contains global, non-confidential, configuration: <code>values.yaml</code></p>
-</li>
-<li>
-<p>The other one contains secrets: <code>secrets.yaml</code>. Values are encrypted with a key stored generated by <a href="https://github.com/mozilla/sops">sops</a>.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>You need to pass these 2 files as parameters to the James Helm package.
-To verify the coherence and avoid errors, the packages can validate the input.</p>
-</div>
-<div class="paragraph">
-<p>This package contains a default <code>values.yaml</code> file, but that you should override with proper configuration for your deployment (<code>conf.yaml</code>).
-The file <code>secrets.sample.yaml</code> will show you the possible values of the secrets file. To generate the <code>secrets.yaml</code> file,
-you will need a plugin for Helm called <a href="https://github.com/jkroepke/helm-secrets)">helm-scecrets</a>.</p>
-</div>
-<div class="paragraph">
-<p>Usually, you will save those configurations in different repositories, per deployment.</p>
-</div>
-<div class="paragraph">
-<p>Have a look at <code>values.md</code> and <code>secrets.md</code> in our Chart <a href="https://github.com/apache/james-project/tree/master/server/apps/distributed-app/helm-chart/james/doc/">documents</a> to have more information on the configuration James is using.</p>
-</div>
-<div class="paragraph">
-<p>You can find our Helm chart for James in <a href="https://github.com/apache/james-project/tree/master/server/apps/distributed-app/helm-chart">here</a></p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_james_configuration"><a class="anchor" href="#_james_configuration"></a>James Configuration</h3>
-<div class="paragraph">
-<p>The configuration files proper to James are stored in the Chart <code>james/configs</code> folder. They are being stored in a <code>ConfigMap</code> and then being mounted in the James pod at /root/conf path.</p>
-</div>
-<div class="paragraph">
-<p>If you need to change a conf in James, this is where you need to look at.</p>
-</div>
-<div class="paragraph">
-<p>For now all configuration files are the same for every deployment, except for <code>mailetcontainer.xml</code> that has been excluded (see section below).</p>
-</div>
-<div class="paragraph">
-<p>You can get the template <code>mailetcontainer.xml</code> in our <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/">sample-configuration</a> folder.</p>
-</div>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-note" title="Note"></i>
-</td>
-<td class="content">
-<div class="paragraph">
-<p>The <code>mailetcontainer.xml</code> is the configuration file in James responsible of mail processing and delivery. It can differ greatly from one deployment to another. For that reason, we have excluded it from <code>james/configs</code> folder for the moment. You need to draft your own version of <code>mailetcontainer.xml</code> and add it to <code>james/configs</code> before start deploying Helm chart, as we can’t actually mount a separate file into the same mounting point as the one sued by the <code>ConfigMap</code> on <code>/root/conf</code> path.</p>
-</div>
-<div class="paragraph">
-<p>However, the next release of Helm should allow to do something about that (hopefully). The helm package will be updated then.</p>
-</div>
-</td>
-</tr>
-</table>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_deploy_james_helm_chart"><a class="anchor" href="#_deploy_james_helm_chart"></a>Deploy James Helm chart</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_verify_the_configuration"><a class="anchor" href="#_verify_the_configuration"></a>Verify the configuration</h3>
-<div class="paragraph">
-<p>We recommend to verify the configuration against the James Helm packages before deploying it. Usually it is best to have to position yourself in the repository having your deployment’s values and secrets, and linking this helm package to it, like this:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ helm lint -f james/conf.yaml -f james/secrets.yaml /path/to/helm/james</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can also generate the whole templates with values (can be useful for debugging sometimes), by typing:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ helm secrets templates -f james/conf.yaml -f james/secrets.yaml james /path/to/helm/james</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>From there, you should be able to interact with the Kubernetes cluster with <code>kubectl</code> command.</p>
-</div>
-<div class="paragraph">
-<p>A few useful commands:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>kubectl get namespace # show namespaces on your cluster
-
-kubectl get pod -n mail-server # list pods running in mail-server namespace
-
-kubectl config set-context --current --namespace=mail-server # set the namespace mail-server as default one for next commands
-
-kubectl get configmaps # list configmaps depoyed on the namespace
-
-kubectl get secrets # list secrets deployed on the namespace
-
-kubectl get service # list services deployed in the namespace
-
-kubectl get nodes -o wide # list nodes related to the namespace
-
-kubectl describe pod my-pod # get a detailed description of my-pod (similar for other objects)
-
-kubectl scale --replicas=4 deployment james # scale up (or down) james to 4 pods
-
-kubectl rollout restart deployment james # force a rollout restart of your pods related to james
-
-kubectl logs my-pod -f --tail 100 # show and follow logs of a pod from the last 100 lines
-
-kubectl logs -f -l app=james --tail 100 # show and follow the combined logs of all james pods from the last 100 lines
-
-kubectl port-forward pod/my-pod 3000:3000 # allow you to access and interact with internal port 3000 of my-pod from localhost</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Usually you have a namespace per deployment. Always target your deployments on the corresponding namespace, by either adding the flag -n mail-server on your kubectl and helm commands, or by setting your namespace by default (see in the above commands).</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_deploy_james_chart"><a class="anchor" href="#_deploy_james_chart"></a>Deploy James Chart</h3>
-<div class="paragraph">
-<p>Before doing a real deployment, you need to check that you have at least all necessary values for James to start and run smoothly on your environment. You can check the <code>checklist.md</code> in our document folder for this.</p>
-</div>
-<div class="paragraph">
-<p>Run the command when you think you are good to go:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ helm secrets install james james/ -f james/values.yaml -f james/secrets.yaml</pre>
-</div>
-</div>
-<div class="imageblock">
-<div class="content">
-<img src="../_images/apache-james-lens.png" alt="Distributed Apache James in Kubernetes">
-</div>
-</div>
-<div class="paragraph">
-<p>You can also wait for the deployment to be complete by adding a --wait flag, that is based on the readiness probe located inside the James pod.</p>
-</div>
-<div class="paragraph">
-<p>However sometimes things might not always go well at the start of James. Usually it is good to look at the logs. If it goes without issues until you start to see some successful health check logs, then you are likely good.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_upgrade_chart_version"><a class="anchor" href="#_upgrade_chart_version"></a>Upgrade Chart version</h3>
-<div class="paragraph">
-<p>If you want to deploy a new version of a installed package, use helm secrets upgrade:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ helm secrets upgrade -f james/conf.yaml -f james/secrets.yaml james /path/to/helm/james</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>What Helm does is that it compares all the generated YAML files with those on the server.
-And it updates only those that changed. There are however some limitations:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>pods in errors are not recreated during an upgrade. It allows to check the logs first. However, if you delete the pod by hand, it will be recreated from the last definition.</p>
-</li>
-<li>
-<p>Some artifacts, such as jobs and stateful sets, have immutable properties. So, some upgrades may fail. Deleting by hand the element is sometimes a solution before doing the upgrade.</p>
-</li>
-</ul>
-</div>
-<div class="admonitionblock tip">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-tip" title="Tip"></i>
-</td>
-<td class="content">
-Install <a href="https://github.com/databus23/helm-diff">helm-diff</a> plugin to display the changed configurations before run upgrade.
-</td>
-</tr>
-</table>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ helm secrets diff upgrade -f james/conf.yaml -f james/secrets.yaml james /path/to/helm/james</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_rollback_to_previous_chart_version"><a class="anchor" href="#_rollback_to_previous_chart_version"></a>Rollback to previous Chart version</h3>
-<div class="paragraph">
-<p>Show chart revision history:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ helm history james -n <name space></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Rollback to a previous version:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ helm rollbaack james <revision></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_uninstalling"><a class="anchor" href="#_uninstalling"></a>Uninstalling</h3>
-<div class="paragraph">
-<p>To uninstall the helm package:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ helm uninstall james -n <name space></pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_references"><a class="anchor" href="#_references"></a>References</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>A summary of different resources that could be interesting to have in hand.</p>
-</div>
-<div class="sect2">
-<h3 id="_this_package"><a class="anchor" href="#_this_package"></a>This package</h3>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="k8s-values.html" class="xref page">Values</a></p>
-</li>
-<li>
-<p><a href="k8s-secrets.html" class="xref page">Secrets</a></p>
-</li>
-<li>
-<p><a href="k8s-checklist.html" class="xref page">Check List</a></p>
-</li>
-<li>
-<p><a href="k8s-logsMetrics.html" class="xref page">Logs and Metrics</a></p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_james_documentation"><a class="anchor" href="#_james_documentation"></a>James documentation</h3>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://james.apache.org/">James Official Website</a></p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project">James GitHub Project</a></p>
-</li>
-<li>
-<p><a href="../operate/webadmin.html" class="xref page">WebAdmin</a></p>
-</li>
-<li>
-<p><a href="../operate/cli.html" class="xref page">James CLI</a></p>
-</li>
-<li>
-<p><a href="https://james.apache.org/server/manage-guice-distributed-james.html">Manage Guice Distributed James</a></p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_kubernetes"><a class="anchor" href="#_kubernetes"></a>Kubernetes</h3>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://kubernetes.io/docs/concepts/overview/components/">Kubernetes Components Overview</a></p>
-</li>
-<li>
-<p><a href="https://kubernetes.io/docs/concepts/workloads/pods/">Pods</a></p>
-</li>
-<li>
-<p><a href="https://kubernetes.io/docs/concepts/services-networking/service/">Services</a></p>
-</li>
-<li>
-<p><a href="https://kubernetes.io/docs/concepts/services-networking/ingress/">Ingress</a></p>
-</li>
-<li>
-<p><a href="https://kubernetes.io/docs/concepts/configuration/configmap/">Configmaps</a></p>
-</li>
-<li>
-<p><a href="https://kubernetes.io/docs/concepts/configuration/secret/">Secrets</a></p>
-</li>
-<li>
-<p><a href="https://kubernetes.io/docs/concepts/workloads/controllers/deployment/">Deployments</a></p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_helm"><a class="anchor" href="#_helm"></a>Helm</h3>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://helm.sh/docs/topics/architecture/">Helm Architecture</a></p>
-</li>
-<li>
-<p><a href="https://helm.sh/docs/topics/charts/">Charts</a></p>
-</li>
-<li>
-<p><a href="https://helm.sh/docs/intro/using_helm/">Using Helm</a></p>
-</li>
-<li>
-<p><a href="https://helm.sh/docs/chart_template_guide/getting_started/">Helm templates</a></p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/_images/BlobStore.png b/james-distributed-app/3.8.1/_images/BlobStore.png
deleted file mode 100644
index d964d2a..0000000
--- a/james-distributed-app/3.8.1/_images/BlobStore.png
+++ /dev/null
Binary files differ
diff --git a/james-distributed-app/3.8.1/_images/IMAP_board.png b/james-distributed-app/3.8.1/_images/IMAP_board.png
deleted file mode 100644
index 2c3e935..0000000
--- a/james-distributed-app/3.8.1/_images/IMAP_board.png
+++ /dev/null
Binary files differ
diff --git a/james-distributed-app/3.8.1/_images/JMAP_board.png b/james-distributed-app/3.8.1/_images/JMAP_board.png
deleted file mode 100644
index e97b021..0000000
--- a/james-distributed-app/3.8.1/_images/JMAP_board.png
+++ /dev/null
Binary files differ
diff --git a/james-distributed-app/3.8.1/_images/JVM_board.png b/james-distributed-app/3.8.1/_images/JVM_board.png
deleted file mode 100644
index 45f9463..0000000
--- a/james-distributed-app/3.8.1/_images/JVM_board.png
+++ /dev/null
Binary files differ
diff --git a/james-distributed-app/3.8.1/_images/MATCHER.png b/james-distributed-app/3.8.1/_images/MATCHER.png
deleted file mode 100644
index 4730e94..0000000
--- a/james-distributed-app/3.8.1/_images/MATCHER.png
+++ /dev/null
Binary files differ
diff --git a/james-distributed-app/3.8.1/_images/apache-james-lens.png b/james-distributed-app/3.8.1/_images/apache-james-lens.png
deleted file mode 100644
index e97507c..0000000
--- a/james-distributed-app/3.8.1/_images/apache-james-lens.png
+++ /dev/null
Binary files differ
diff --git a/james-distributed-app/3.8.1/_images/cassandra_stress_test_result_1.png b/james-distributed-app/3.8.1/_images/cassandra_stress_test_result_1.png
deleted file mode 100644
index b4ab9fa..0000000
--- a/james-distributed-app/3.8.1/_images/cassandra_stress_test_result_1.png
+++ /dev/null
Binary files differ
diff --git a/james-distributed-app/3.8.1/_images/cassandra_stress_test_result_2.png b/james-distributed-app/3.8.1/_images/cassandra_stress_test_result_2.png
deleted file mode 100644
index 189f602..0000000
--- a/james-distributed-app/3.8.1/_images/cassandra_stress_test_result_2.png
+++ /dev/null
Binary files differ
diff --git a/james-distributed-app/3.8.1/_images/james-hexagons-extensions.png b/james-distributed-app/3.8.1/_images/james-hexagons-extensions.png
deleted file mode 100644
index 6e228e2..0000000
--- a/james-distributed-app/3.8.1/_images/james-hexagons-extensions.png
+++ /dev/null
Binary files differ
diff --git a/james-distributed-app/3.8.1/_images/james-imap-base-performance.png b/james-distributed-app/3.8.1/_images/james-imap-base-performance.png
deleted file mode 100644
index 1caa11d..0000000
--- a/james-distributed-app/3.8.1/_images/james-imap-base-performance.png
+++ /dev/null
Binary files differ
diff --git a/james-distributed-app/3.8.1/_images/preload-dashboards.png b/james-distributed-app/3.8.1/_images/preload-dashboards.png
deleted file mode 100644
index 8ecc77f..0000000
--- a/james-distributed-app/3.8.1/_images/preload-dashboards.png
+++ /dev/null
Binary files differ
diff --git a/james-distributed-app/3.8.1/_images/remote-delivery-error-handling.png b/james-distributed-app/3.8.1/_images/remote-delivery-error-handling.png
deleted file mode 100644
index 7e0665a..0000000
--- a/james-distributed-app/3.8.1/_images/remote-delivery-error-handling.png
+++ /dev/null
Binary files differ
diff --git a/james-distributed-app/3.8.1/_images/server-components.png b/james-distributed-app/3.8.1/_images/server-components.png
deleted file mode 100644
index 30112d9..0000000
--- a/james-distributed-app/3.8.1/_images/server-components.png
+++ /dev/null
Binary files differ
diff --git a/james-distributed-app/3.8.1/_images/specialized-instances.png b/james-distributed-app/3.8.1/_images/specialized-instances.png
deleted file mode 100644
index 687cefe..0000000
--- a/james-distributed-app/3.8.1/_images/specialized-instances.png
+++ /dev/null
Binary files differ
diff --git a/james-distributed-app/3.8.1/_images/storage.png b/james-distributed-app/3.8.1/_images/storage.png
deleted file mode 100644
index d52322a..0000000
--- a/james-distributed-app/3.8.1/_images/storage.png
+++ /dev/null
Binary files differ
diff --git a/james-distributed-app/3.8.1/_images/webAdmin.png b/james-distributed-app/3.8.1/_images/webAdmin.png
deleted file mode 100644
index a0b88a9..0000000
--- a/james-distributed-app/3.8.1/_images/webAdmin.png
+++ /dev/null
Binary files differ
diff --git a/james-distributed-app/3.8.1/architecture/consistency-model.html b/james-distributed-app/3.8.1/architecture/consistency-model.html
deleted file mode 100644
index f70e8d1..0000000
--- a/james-distributed-app/3.8.1/architecture/consistency-model.html
+++ /dev/null
@@ -1,592 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Consistency Model :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Architecture</a></li>
- <li><a href="consistency-model.html">Consistency Model</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/architecture/consistency-model.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Consistency Model</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This page presents the consistency model used by the Distributed Server and
-points to the tools built around it.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_data_replication"><a class="anchor" href="#_data_replication"></a>Data Replication</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The Distributed Server relies on different storage technologies, all having their own
-consistency models.</p>
-</div>
-<div class="paragraph">
-<p>These data stores replicate data in order to enforce some level of availability. We call
-this process replication. By consistency, we mean the ability for all replica to hold the
-same data. By availability, we mean the ability for a replica to answer a request.</p>
-</div>
-<div class="paragraph">
-<p>In distributed systems, <a href="https://en.wikipedia.org/wiki/CAP_theorem">according to the CAP theorem</a>,
-as we will necessarily encounter network partitions, then trade-offs need to be made between
-consistency and availability.</p>
-</div>
-<div class="paragraph">
-<p>This section details this trade-off for data stores used by the Distributed Server.</p>
-</div>
-<div class="sect2">
-<h3 id="_cassandra_consistency_model"><a class="anchor" href="#_cassandra_consistency_model"></a>Cassandra consistency model</h3>
-<div class="paragraph">
-<p><a href="https://cassandra.apache.org/">Cassandra</a> is an
-<a href="https://en.wikipedia.org/wiki/Eventual_consistency">eventually consistent</a> data store.
-This means that replica can hold diverging data, but are guaranteed to converge over time.</p>
-</div>
-<div class="paragraph">
-<p>Several mechanisms are built in Cassandra to enforce this convergence, and need to be
-leveraged by <strong>Distributed Server Administrator</strong>. Namely
-<a href="https://docs.datastax.com/en/dse/5.1/dse-admin/datastax_enterprise/tools/nodetool/toolsRepair.html">nodetool repair</a>,
-<a href="https://cassandra.apache.org/doc/latest/operating/hints.html">Hinted hand-off</a> and
-<a href="https://cassandra.apache.org/doc/latest/operating/read_repair.html">Read repair</a>.</p>
-</div>
-<div class="paragraph">
-<p>The Distributed Server tries to mitigate inconsistencies by relying on
-<a href="https://docs.datastax.com/en/archived/cassandra/3.0/cassandra/dml/dmlConfigConsistency.html">QUORUM</a> read and write levels.
-This means that a majority of replica are needed for read and write operations to be performed.</p>
-</div>
-<div class="paragraph">
-<p>Critical business operations, like UID allocation, rely on strong consistency mechanisms brought by
-<a href="https://www.datastax.com/blog/2013/07/lightweight-transactions-cassandra-20">lightweight transaction</a>.</p>
-</div>
-<div class="sect3">
-<h4 id="_about_multi_data_center_setups"><a class="anchor" href="#_about_multi_data_center_setups"></a>About multi data-center setups</h4>
-<div class="paragraph">
-<p>As strong consistency is required for some operation, especially regarding IMAP monotic UID and MODSEQ generation,
-and as lightweight transactions are slow across data centers, running James with a
-<a href="https://docs.datastax.com/en/ddac/doc/datastax_enterprise/production/DDACmultiDCperWorkloadType.html">multi data-center</a>
-Cassandra setup is discouraged.</p>
-</div>
-<div class="paragraph">
-<p>However, <a href="../configure/cassandra.html" class="xref page">this page</a> enables setting alternative read level,
-which could be acceptable regarding limited requirements. <code>LOCAL_QUORUM</code> coupled with <code>LOCAL_SERIAL</code>
-is likely the only scalable setup. Some options were added to turn off SERIAL consistency usage for message
-and mailbox management. However, the use of Lightweight Transaction cannot be disabled for UIDs and ModSeqs.</p>
-</div>
-<div class="paragraph">
-<p>Running the Distributed Server IMAP server in a multi datacenter setup will likely result either in data loss,
-or very slow operations - as we rely on monotic UID generation, without strong consistency, UIDs could be allocated
-several times.</p>
-</div>
-<div class="paragraph">
-<p>We did wire a multi-DC friendly distributed, POP3 only server that leverages acceptable performance while staying
-consistent. This is achieved by having a reduced feature set - supporting only the POP3 server and using messageIds as
-identifiers (generated without synchronisation using TimeUUIDs). You can find this application
-<a href="https://github.com/apache/james-project/tree/master/server/apps/distributed-pop3-app">on GitHub</a>. In the future,
-JMAP support could be added, but requires followup developments as some components critically depends on UIDs
-(for instance the search).</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_opensearch_consistency_model"><a class="anchor" href="#_opensearch_consistency_model"></a>OpenSearch consistency model</h3>
-<div class="paragraph">
-<p>OpenSearch relies on <a href="https://www.elastic.co/blog/a-new-era-for-cluster-coordination-in-elasticsearch">strong consistency</a>
-with home grown algorithm.</p>
-</div>
-<div class="paragraph">
-<p>The 6.x release line, that the distributed server is using is known to be slow to recover from failures.</p>
-</div>
-<div class="paragraph">
-<p>Be aware that data is asynchronously indexed in OpenSearch, changes will be eventually visible.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_rabbitmq_consistency_model"><a class="anchor" href="#_rabbitmq_consistency_model"></a>RabbitMQ consistency model</h3>
-<div class="paragraph">
-<p>The Distributed Server relies out of the box on a single RabbitMQ server, thus consistency concerns
-are not (yet) applicable. Availability concerns are applicable.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_denormalization"><a class="anchor" href="#_denormalization"></a>Denormalization</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>In Cassandra, data needs to be structured to match the read patterns. To support several conflicting
-read patterns, the data needs to be duplicated into different structures. This process is called
-denormalization.</p>
-</div>
-<div class="paragraph">
-<p>While data can be consistent at the table level, some inconsistencies can sneak in at the applicative
-level across denormalization tables.</p>
-</div>
-<div class="paragraph">
-<p>We write to a "table of truth" first, then duplicate the data to denormalization tables.</p>
-</div>
-<div class="paragraph">
-<p>The Distributed server offers several mechanisms to mitigate these inconsistencies:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Writes to denormalization tables are retried.</p>
-</li>
-<li>
-<p>Some <a href="../operate/guide.html#_solving_cassandra_inconsistencies" class="xref page">SolveInconsistencies tasks</a> are exposed and are able to heal a given denormalization table.
-They reset the "deduplication tables" content to the "table of truth" content.</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/blob/master/src/adr/0042-applicative-read-repairs.md">Read repairs</a>,
-when implemented for a given denormalization, enables auto-healing. When an inconsistency is detected, They reset the
-"deduplication tables" entry to the "table of truth" entry.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_consistency_across_data_stores"><a class="anchor" href="#_consistency_across_data_stores"></a>Consistency across data stores</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The Distributed Server leverages several data stores:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Cassandra is used for metadata storage</p>
-</li>
-<li>
-<p>OpenSearch for search</p>
-</li>
-<li>
-<p>Object Storage for large object storage</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Thus the Distributed Server also offers mechanisms to enforce consistency across data stores.</p>
-</div>
-<div class="sect2">
-<h3 id="_write_path_organisation"><a class="anchor" href="#_write_path_organisation"></a>Write path organisation</h3>
-<div class="paragraph">
-<p>The primary data stores are composed of Cassandra for metadata and Object storage for binary data.</p>
-</div>
-<div class="paragraph">
-<p>To ensure the data referenced in Cassandra is pointing to a valid object in the object store, we write
-the object store payload first, then write the corresponding metadata in Cassandra.</p>
-</div>
-<div class="paragraph">
-<p>Such a procedure avoids metadata pointing to unexisting blobs, however might lead to some unreferenced
-blobs.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_cassandra_opensearch"><a class="anchor" href="#_cassandra_opensearch"></a>Cassandra <⇒ OpenSearch</h3>
-<div class="paragraph">
-<p>After being written to the primary stores (namely Cassandra & Object Storage), email content is
-asynchronously indexed into OpenSearch.</p>
-</div>
-<div class="paragraph">
-<p>This process, called the EventBus, which retries temporary errors, and stores transient errors for
-later admin-triggered retries is described further <a href="../operate/guide.html#_mailbox_event_bus" class="xref page">here</a>.
-His role is to spread load and limit inconsistencies.</p>
-</div>
-<div class="paragraph">
-<p>Furthermore, some <a href="../operate/guide.html#_usual_troubleshooting_procedures" class="xref page">re-indexing tasks</a>
-enables to re-synchronise OpenSearch content with the primary data stores</p>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/architecture/implemented-standards.html b/james-distributed-app/3.8.1/architecture/implemented-standards.html
deleted file mode 100644
index ac14efd..0000000
--- a/james-distributed-app/3.8.1/architecture/implemented-standards.html
+++ /dev/null
@@ -1,721 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Implemented standards :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Architecture</a></li>
- <li><a href="implemented-standards.html">Implemented standards</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/architecture/implemented-standards.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Implemented standards</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This page details standards implemented by the distributed server.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_message_formats"><a class="anchor" href="#_message_formats"></a>Message formats</h2>
-<div class="sectionbody">
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc5322">RFC-5322</a> Internet Message Format (MIME)</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc2045">RFC-2045</a> Format of Internet Message Bodies</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc3464">RFC-3464</a> An Extensible Message Format for Delivery Status Notifications</p>
-</li>
-<li>
-<p>James allow emmit DSNs from the mailet container.</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc8098">RFC-8098</a> Message Disposition Notification</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_tls_authentication"><a class="anchor" href="#_tls_authentication"></a>TLS & authentication</h2>
-<div class="sectionbody">
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc2595.html">RFC-2595</a> TLS for IMAP, POP3, SMTP (StartTLS)</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc8314.html">RFC-8314</a> Implicit TLS</p>
-</li>
-<li>
-<p><a href="https://www.rfc-editor.org/rfc/rfc4959.html">RFC-4959</a> SASL IR: Initial client response</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc4616">RFC-4616</a> SASL plain authentication</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc8314.html">RFC-7628</a> SASL for OAUTH</p>
-</li>
-<li>
-<p>Implemented for IMAP and SMTP</p>
-</li>
-<li>
-<p>Support for OIDC standard only.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_smtp"><a class="anchor" href="#_smtp"></a>SMTP</h2>
-<div class="sectionbody">
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc5321">RFC-5321</a> SMTP Protocol</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc974">RFC-974</a> MAIL ROUTING AND THE DOMAIN SYSTEM</p>
-</li>
-<li>
-<p><a href="https://www.rfc-editor.org/rfc/rfc3461">RFC-3461</a> Simple Mail Transfer Protocol (SMTP) Service Extension for Delivery Status Notifications (DSNs)</p>
-</li>
-<li>
-<p>Requires extra configuration.</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc1652">RFC-1652</a> SMTP Service Extension for 8bit-MIME transport</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc1830">RFC-1830</a> SMTP Service Extensions for Transmission of Large and Binary MIME Messages</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc1869">RFC-1869</a> SMTP Service Extensions</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc1870">RFC-1870</a> SMTP Service Extension for Message Size Declaration</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc1891">RFC-1891</a> SMTP Service Extension for Delivery Status Notifications</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc1893">RFC-1893</a> Enhanced Mail System Status Codes</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc2034">RFC-2034</a> SMTP Service Extension for Returning Enhanced Error Codes</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc2142">RFC-2142</a> Mailbox Names For Common Services, Roles And Functions</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc2197">RFC-2197</a> SMTP Service Extension for Command Pipelining</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc2554">RFC-2554</a> ESMTP Service Extension for Authentication</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc1893">RFC-1893</a> Enhanced Mail System Status Codes</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_lmtp"><a class="anchor" href="#_lmtp"></a>LMTP</h2>
-<div class="sectionbody">
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://james.apache.org/server/rfclist/lmtp/rfc2033.txt">RFC-2033</a> LMTP Local Mail Transfer Protocol</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_imap"><a class="anchor" href="#_imap"></a>IMAP</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The following IMAP specifications are implemented:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc3501.html">RFC-3501</a> INTERNET MESSAGE ACCESS PROTOCOL - VERSION 4rev1</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc2177.html">RFC-2177</a> IMAP IDLE (mailbox scoped push notifications)</p>
-</li>
-<li>
-<p><a href="https://www.rfc-editor.org/rfc/rfc9208.html">RFC-9208</a> IMAP QUOTA Extension</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc2342.html">RFC-2342</a> IMAP namespace</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc2088.html">RFC-2088</a> IMAP non synchronized literals</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc4315.html">RFC-4315</a> IMAP UIDPLUS</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc5464.html">RFC-5464</a> IMAP Metadata (annotations on mailboxes)</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc4551.html">RFC-4551</a> IMAP Condstore</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc5162.html">RFC-5162</a> IMAP QRESYNC (synchronisation semantic for deleted messages)</p>
-</li>
-<li>
-<p>We don’t store a log of deleted modseq thus clients should rely on known sequences mechanism to optimize exchanges.</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc4978.html">RFC-4978</a> IMAP Compress (optional)</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc5161.html">RFC-5161</a> IMAP ENABLE</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc6851.html">RFC-6851</a> IMAP MOVE command</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc5182.html">RFC-5182</a> IMAP Extension for Referencing the Last SEARCH Result</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc5032.html">RFC-5032</a> IMAP WITHIN (for relative date search semantic)</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc4731.html">RFC-4731</a> IMAP ESEARCH: extentions for IMAP search: new options like min, max, count.</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc3348.html">RFC-3348</a> IMAP Child Mailbox Extension</p>
-</li>
-<li>
-<p><a href="https://www.rfc-editor.org/rfc/rfc8508.html">RFC-8508</a> IMAP Replace Extension</p>
-</li>
-<li>
-<p><a href="https://www.rfc-editor.org/rfc/rfc7889.html">RFC-7889</a> IMAP Extension for APPENDLIMIT</p>
-</li>
-<li>
-<p><a href="https://www.rfc-editor.org/rfc/rfc8474.html">RFC-8474</a> IMAP Extension for Object Identifiers</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc2971.html">RFC-2971</a> IMAP ID Extension</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc8438.html">RFC-8438</a> IMAP Extension for STATUS=SIZE</p>
-</li>
-<li>
-<p><a href="https://www.rfc-editor.org/rfc/rfc5258.html">RFC-5258</a> IMAP LIST Command Extensions</p>
-</li>
-<li>
-<p><a href="https://www.rfc-editor.org/rfc/rfc5819.html">RFC-5819</a> IMAP4 Extension for Returning STATUS Information in Extended LIST</p>
-</li>
-<li>
-<p><a href="https://www.rfc-editor.org/rfc/rfc8440.html">RFC-8440</a> IMAP4 Extension for Returning MYRIGHTS Information in Extended LIST</p>
-</li>
-<li>
-<p><a href="https://www.rfc-editor.org/rfc/rfc8440.html">RFC-6154</a> IMAP LIST Extension for Special-Use Mailboxes</p>
-</li>
-<li>
-<p><a href="https://www.rfc-editor.org/rfc/rfc8514.html">RFC-8514</a> IMAP SAVEDATE Extension</p>
-</li>
-<li>
-<p><a href="https://www.rfc-editor.org/rfc/rfc8514.html">RFC-9394</a> IMAP PARTIAL Extension for Paged SEARCH and FETCH</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Partially implemented specifications:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc4314.html">RFC-4314</a> IMAP ACL</p>
-</li>
-<li>
-<p>ACLs can be created and managed but mailbox not belonging to one account cannot, as of today, be accessed in IMAP.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_jmap"><a class="anchor" href="#_jmap"></a>JMAP</h2>
-<div class="sectionbody">
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc8620">RFC-8620</a> Json Metadata Application Protocol (JMAP)</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc8621">RFC-8621</a> JMAP for emails</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc8887">RFC-8887</a> JMAP over websockets</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc9007.html">RFC-9007</a> Message Delivery Notifications with JMAP.</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc8030.html">RFC-8030</a> Web PUSH: JMAP enable sending push notifications through a push gateway.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p><a href="https://jmap.io/">JMAP</a> is intended to be a new standard for email clients to connect to mail
-stores. It therefore intends to primarily replace IMAP + SMTP submission. It is also designed to be more
-generic. It does not replace MTA-to-MTA SMTP transmission.</p>
-</div>
-<div class="paragraph">
-<p>The <a href="https://github.com/apache/james-project/tree/master/server/protocols/jmap-rfc-8621/doc/specs/spec">annotated documentation</a>
-presents the limits of the JMAP RFC-8621 implementation part of the Apache James project.</p>
-</div>
-<div class="paragraph">
-<p>Some methods / types are not yet implemented, some implementations are naive, and the PUSH is not supported yet.</p>
-</div>
-<div class="paragraph">
-<p>Users are invited to read these limitations before using actively the JMAP RFC-8621 implementation, and should ensure their
-client applications only uses supported operations.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_pop3"><a class="anchor" href="#_pop3"></a>POP3</h2>
-<div class="sectionbody">
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://www.ietf.org/rfc/rfc1939.txt">RFC-1939</a> Post Office Protocol - Version 3</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_managesieve"><a class="anchor" href="#_managesieve"></a>ManageSieve</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Support for manageSieve is experimental.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc5804">RFC-5804</a> A Protocol for Remotely Managing Sieve Scripts</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_sieve"><a class="anchor" href="#_sieve"></a>Sieve</h2>
-<div class="sectionbody">
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc5228">RFC-5228</a> Sieve: An Email Filtering Language</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc5173">RFC-5173</a> Sieve Email Filtering: Body Extension</p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc5230">RFC-5230</a> Sieve Email Filtering: Vacation Extension</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/architecture/index.html b/james-distributed-app/3.8.1/architecture/index.html
deleted file mode 100644
index 45d6891..0000000
--- a/james-distributed-app/3.8.1/architecture/index.html
+++ /dev/null
@@ -1,965 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Architecture :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item is-current-page" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Architecture</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/architecture/index.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Architecture</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This sections presents the Distributed Server architecture.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_storage"><a class="anchor" href="#_storage"></a>Storage</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>In order to deliver its promises, the Distributed Server leverages the following storage strategies:</p>
-</div>
-<div class="imageblock">
-<div class="content">
-<img src="../_images/storage.png" alt="Storage responsibilities for the Distributed Server">
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>Cassandra</strong> is used for metadata storage. Cassandra is efficient for a very high workload of small queries following
-a known pattern.</p>
-</li>
-<li>
-<p>The <strong>blob store</strong> storage interface is responsible of storing potentially large binary data. For instance
- email bodies, headers or attachments. Different technologies can be used: <strong>Cassandra</strong>, or S3 compatible <strong>Object Storage</strong>
-(S3 or Swift).</p>
-</li>
-<li>
-<p><strong>OpenSearch</strong> component empowers full text search on emails. It also enables querying data with unplanned access
-patterns. OpenSearch throughput do not however match the one of Cassandra thus its use is avoided upon regular workloads.</p>
-</li>
-<li>
-<p><strong>RabbitMQ</strong> enables James nodes of a same cluster to collaborate together. It is used to implement connected protocols,
-notification patterns as well as distributed resilient work queues and mail queue.</p>
-</li>
-<li>
-<p><strong>Tika</strong> (optional) enables text extraction from attachments, thus improving full text search results.</p>
-</li>
-<li>
-<p><strong><a href="https://spamassassin.apache.org/">SpamAssassin</a> or <a href="https://rspamd.com/">Rspamd</a></strong> (optional) can be used for Spam detection and user feedback is supported.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p><a href="consistency-model.html" class="xref page">This page</a> further details Distributed James consistency model.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_protocols"><a class="anchor" href="#_protocols"></a>Protocols</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The following protocols are supported and can be used to interact with the Distributed Server:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>SMTP</strong></p>
-</li>
-<li>
-<p><strong>IMAP</strong></p>
-</li>
-<li>
-<p><a href="../operate/webadmin.html" class="xref page">WebAdmin</a> REST Administration API</p>
-</li>
-<li>
-<p><strong>LMTP</strong></p>
-</li>
-<li>
-<p><strong>POP3</strong></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The following protocols should be considered experimental:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>JMAP</strong> (RFC-8620 &RFC-8621 specifications and known limitations of the James implementation are defined <a href="https://github.com/apache/james-project/tree/master/server/protocols/jmap-rfc-8621/doc">here</a>)</p>
-</li>
-<li>
-<p><strong>ManagedSieve</strong></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Read more on <a href="implemented-standards.html" class="xref page">implemented standards</a>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_topology"><a class="anchor" href="#_topology"></a>Topology</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>While it is perfectly possible to deploy homogeneous James instances, with the same configuration and thus the same
-protocols and the same responsibilities one might want to investigate in
-<a href="specialized-instances.html" class="xref page">'Specialized instances'</a>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_components"><a class="anchor" href="#_components"></a>Components</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This section presents the various components of the Distributed server, providing context about
-their interactions, and about their implementations.</p>
-</div>
-<div class="sect2">
-<h3 id="_high_level_view"><a class="anchor" href="#_high_level_view"></a>High level view</h3>
-<div class="paragraph">
-<p>Here is a high level view of the various server components and their interactions:</p>
-</div>
-<div class="imageblock">
-<div class="content">
-<img src="../_images/server-components.png" alt="Server components mobilized for SMTP & IMAP">
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>The SMTP protocol receives a mail, and enqueue it on the MailQueue</p>
-</li>
-<li>
-<p>The MailetContainer will start processing the mail Asynchronously and will take business decisions like storing the
-email locally in a user mailbox. The behaviour of the MailetContainer is highly customizable thanks to the Mailets and
-the Matcher composibility.</p>
-</li>
-<li>
-<p>The Mailbox component is responsible of storing a user’s mails.</p>
-</li>
-<li>
-<p>The user can use the IMAP or the JMAP protocol to retrieve and read his mails.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>These components will be presented more in depth below.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_mail_processing"><a class="anchor" href="#_mail_processing"></a>Mail processing</h3>
-<div class="paragraph">
-<p>Mail processing allows to take asynchronously business decisions on
-received emails.</p>
-</div>
-<div class="paragraph">
-<p>Here are its components:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>The <code>spooler</code> takes mail out of the mailQueue and executes mail
-processing within the <code>mailet container</code>.</p>
-</li>
-<li>
-<p>The <code>mailet container</code> synchronously executes the user defined logic.
-This <code>logic' is written through the use of `mailet</code>, <code>matcher</code> and
-<code>processor</code>.</p>
-</li>
-<li>
-<p>A <code>mailet</code> represents an action: mail modification, envelop
-modification, a side effect, or stop processing.</p>
-</li>
-<li>
-<p>A <code>matcher</code> represents a condition to execute a mailet.</p>
-</li>
-<li>
-<p>A <code>processor</code> is a flow of pair of <code>matcher</code> and <code>mailet</code> executed
-sequentially. The <code>ToProcessor</code> mailet is a <code>goto</code> instruction to start
-executing another <code>processor</code></p>
-</li>
-<li>
-<p>A <code>mail repository</code> allows storage of a mail as part of its
-processing. Standard configuration relies on the following mail
-repository:</p>
-<div class="ulist">
-<ul>
-<li>
-<p><code>cassandra://var/mail/error/</code> : unexpected errors that occurred
-during mail processing. Emails impacted by performance related
-exceptions, or logical bug within James code are typically stored here.
-These mails could be reprocessed once the cause of the error is fixed.
-The <code>Mail.error</code> field can help diagnose the issue. Correlation with
-logs can be achieved via the use of the <code>Mail.name</code> field.</p>
-</li>
-<li>
-<p><code>cassandra://var/mail/address-error/</code> : mail addressed to a
-non-existing recipient of a handled local domain. These mails could be
-reprocessed once the user is created, for instance.</p>
-</li>
-<li>
-<p><code>cassandra://var/mail/relay-denied/</code> : mail for whom relay was
-denied: missing authentication can, for instance, be a cause. In
-addition to prevent disasters upon miss configuration, an email review
-of this mail repository can help refine a host spammer blacklist.</p>
-</li>
-<li>
-<p><code>cassandra://var/mail/rrt-error/</code> : runtime error upon Recipient
-Rewriting occurred. This is typically due to a loop.</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_mail_queue"><a class="anchor" href="#_mail_queue"></a>Mail Queue</h3>
-<div class="paragraph">
-<p>An email queue is a mandatory component of SMTP servers. It is a system
-that creates a queue of emails that are waiting to be processed for
-delivery. Email queuing is a form of Message Queuing – an asynchronous
-service-to-service communication. A message queue is meant to decouple a
-producing process from a consuming one. An email queue decouples email
-reception from email processing. It allows them to communicate without
-being connected. As such, the queued emails wait for processing until
-the recipient is available to receive them. As James is an Email Server,
-it also supports mail queue as well.</p>
-</div>
-<div class="sect3">
-<h4 id="_why_mail_queue_is_necessary"><a class="anchor" href="#_why_mail_queue_is_necessary"></a>Why Mail Queue is necessary</h4>
-<div class="paragraph">
-<p>You might often need to check mail queue to make sure all emails are
-delivered properly. At first, you need to know why email queues get
-clogged. Here are the two core reasons for that:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Exceeded volume of emails</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Some mailbox providers enforce email rate limits on IP addresses. The
-limits are based on the sender reputation. If you exceeded this rate and
-queued too many emails, the delivery speed will decrease.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Spam-related issues</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Another common reason is that your email has been busted by spam
-filters. The filters will let the emails gradually pass to analyze how
-the rest of the recipients react to the message. If there is slow
-progress, it’s okay. Your email campaign is being observed and assessed.
-If it’s stuck, there could be different reasons including the blockage
-of your IP address.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_why_combining_cassandra_rabbitmq_and_object_storage_for_mailqueue"><a class="anchor" href="#_why_combining_cassandra_rabbitmq_and_object_storage_for_mailqueue"></a>Why combining Cassandra, RabbitMQ and Object storage for MailQueue</h4>
-<div class="ulist">
-<ul>
-<li>
-<p>RabbitMQ ensures the messaging function, and avoids polling.</p>
-</li>
-<li>
-<p>Cassandra enables administrative operations such as browsing, deleting
-using a time series which might require fine performance tuning (see
-<a href="http://cassandra.apache.org/doc/latest/operating/index.html">Operating
-Casandra documentation</a>).</p>
-</li>
-<li>
-<p>Object Storage stores potentially large binary payload.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>However the current design do not implement delays. Delays allow to
-define the time a mail have to be living in the mailqueue before being
-dequeued and is used for example for exponential wait delays upon remote
-delivery retries, or</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_mailbox"><a class="anchor" href="#_mailbox"></a>Mailbox</h3>
-<div class="paragraph">
-<p>Storage for emails belonging for users.</p>
-</div>
-<div class="paragraph">
-<p>Metadata are stored in Cassandra while headers, bodies and attachments are stored
-within the <a href="#_blobstore">BlobStore</a>.</p>
-</div>
-<div class="sect3">
-<h4 id="_search_index"><a class="anchor" href="#_search_index"></a>Search index</h4>
-<div class="paragraph">
-<p>Emails are indexed asynchronously in OpenSearch via the <a href="#_event_bus">EventBus</a>
-in order to empower advanced and fast email full text search.</p>
-</div>
-<div class="paragraph">
-<p>Text extraction can be set up using <a href="https://tika.apache.org/">Tika</a>, allowing
-to extract the text from attachment, allowing to search your emails based on the attachment
-textual content. In such case, the OpenSearch indexer will call a Tika server prior
-indexing.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_quotas"><a class="anchor" href="#_quotas"></a>Quotas</h4>
-<div class="paragraph">
-<p>Current Quotas of users are hold in a Cassandra projection. Limitations can be defined via
-user, domain or globally.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_event_bus"><a class="anchor" href="#_event_bus"></a>Event Bus</h4>
-<div class="paragraph">
-<p>Distributed James relies on an event bus system to enrich mailbox capabilities. Each
-operation performed on the mailbox will trigger related events, that can
-be processed asynchronously by potentially any James node on a
-distributed system.</p>
-</div>
-<div class="paragraph">
-<p>Many different kind of events can be triggered during a mailbox
-operation, such as:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>MailboxEvent</code>: event related to an operation regarding a mailbox:</p>
-<div class="ulist">
-<ul>
-<li>
-<p><code>MailboxDeletion</code>: a mailbox has been deleted</p>
-</li>
-<li>
-<p><code>MailboxAdded</code>: a mailbox has been added</p>
-</li>
-<li>
-<p><code>MailboxRenamed</code>: a mailbox has been renamed</p>
-</li>
-<li>
-<p><code>MailboxACLUpdated</code>: a mailbox got its rights and permissions updated</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p><code>MessageEvent</code>: event related to an operation regarding a message:</p>
-<div class="ulist">
-<ul>
-<li>
-<p><code>Added</code>: messages have been added to a mailbox</p>
-</li>
-<li>
-<p><code>Expunged</code>: messages have been expunged from a mailbox</p>
-</li>
-<li>
-<p><code>FlagsUpdated</code>: messages had their flags updated</p>
-</li>
-<li>
-<p><code>MessageMoveEvent</code>: messages have been moved from a mailbox to an
-other</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p><code>QuotaUsageUpdatedEvent</code>: event related to quota update</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Mailbox listeners can register themselves on this event bus system to be
-called when an event is fired, allowing to do different kind of extra
-operations on the system, like:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Current quota calculation</p>
-</li>
-<li>
-<p>Message indexation with OpenSearch</p>
-</li>
-<li>
-<p>Mailbox annotations cleanup</p>
-</li>
-<li>
-<p>Ham/spam reporting to Spam filtering system</p>
-</li>
-<li>
-<p>…</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_deleted_messages_vault"><a class="anchor" href="#_deleted_messages_vault"></a>Deleted Messages Vault</h4>
-<div class="paragraph">
-<p>Deleted Messages Vault is an interesting feature that will help James
-users have a chance to:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>retain users deleted messages for some time.</p>
-</li>
-<li>
-<p>restore & export deleted messages by various criteria.</p>
-</li>
-<li>
-<p>permanently delete some retained messages.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>If the Deleted Messages Vault is enabled when users delete their mails,
-and by that we mean when they try to definitely delete them by emptying
-the trash, James will retain these mails into the Deleted Messages
-Vault, before an email or a mailbox is going to be deleted. And only
-administrators can interact with this component via
-wref:webadmin.adoc#_deleted-messages-vault[WebAdmin] REST APIs].</p>
-</div>
-<div class="paragraph">
-<p>However, mails are not retained forever as you have to configure a
-retention period before using it (with one-year retention by default if
-not defined). It’s also possible to permanently delete a mail if needed.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_data"><a class="anchor" href="#_data"></a>Data</h3>
-<div class="paragraph">
-<p>Storage for domains and users.</p>
-</div>
-<div class="paragraph">
-<p>Domains are persisted in Cassandra.</p>
-</div>
-<div class="paragraph">
-<p>Users can be managed in Cassandra, or via a LDAP (read only).</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_recipient_rewrite_tables"><a class="anchor" href="#_recipient_rewrite_tables"></a>Recipient rewrite tables</h3>
-<div class="paragraph">
-<p>Storage of Recipients Rewriting rules, in Cassandra.</p>
-</div>
-<div class="sect3">
-<h4 id="_mapping_types"><a class="anchor" href="#_mapping_types"></a>Mapping types</h4>
-<div class="paragraph">
-<p>James allows using various mapping types for better expressing the intent of your address rewriting logic:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>Domain mapping</strong>: Rewrites the domain of mail addresses. Use it for technical purposes, user will not
-be allowed to use the source in their FROM address headers. Domain mappings can be managed via the CLI and
-added via <a href="../operate/webadmin.html#_domain_mappings" class="xref page">WebAdmin</a></p>
-</li>
-<li>
-<p><strong>Domain aliases</strong>: Rewrites the domain of mail addresses. Express the idea that both domains can be used
-inter-changeably. User will be allowed to use the source in their FROM address headers. Domain aliases can
-be managed via <a href="../operate/webadmin.html#_get_the_list_of_aliases_for_a_domain" class="xref page">WebAdmin</a></p>
-</li>
-<li>
-<p><strong>Forwards</strong>: Replaces the source address by another one. Vehicles the intent of forwarding incoming mails
-to other users. Listing the forward source in the forward destinations keeps a local copy. User will not be
-allowed to use the source in their FROM address headers. Forward can
-be managed via <a href="../operate/webadmin.html#_address_forwards" class="xref page">WebAdmin</a></p>
-</li>
-<li>
-<p><strong>Groups</strong>: Replaces the source address by another one. Vehicles the intent of a group registration: group
-address will be swapped by group member addresses (Feature poor mailing list). User will not be
-allowed to use the source in their FROM address headers. Groups can
-be managed via <a href="../operate/webadmin.html#_address_group" class="xref page">WebAdmin</a></p>
-</li>
-<li>
-<p><strong>Aliases</strong>: Replaces the source address by another one. Represents user owned mail address, with which
-he can interact as if it was his main mail address. User will be allowed to use the source in their FROM
-address headers. Aliases can be managed via <a href="../operate/webadmin.html#_address_aliases" class="xref page">WebAdmin</a></p>
-</li>
-<li>
-<p><strong>Address mappings</strong>: Replaces the source address by another one. Use for technical purposes, this mapping type do
-not hold specific intent. Prefer using one of the above mapping types…​ User will not be allowed to use the source
-in their FROM address headers. Address mappings can be managed via the CLI or via
-<a href="../operate/webadmin.html#_address_mappings" class="xref page">WebAdmin</a></p>
-</li>
-<li>
-<p><strong>Regex mappings</strong>: Applies the regex on the supplied address. User will not be allowed to use the source
-in their FROM address headers. Regex mappings can be managed via the CLI or via
-<a href="../operate/webadmin.html#_regex_mapping" class="xref page">WebAdmin</a></p>
-</li>
-<li>
-<p><strong>Error</strong>: Throws an error upon processing. User will not be allowed to use the source
-in their FROM address headers. Errors can be managed via the CLI</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_blobstore"><a class="anchor" href="#_blobstore"></a>BlobStore</h3>
-<div class="paragraph">
-<p>Stores potentially large binary data.</p>
-</div>
-<div class="paragraph">
-<p>Mailbox component, Mail Queue component, Deleted Message Vault
-component relies on it.</p>
-</div>
-<div class="paragraph">
-<p>Supported backends include S3 compatible ObjectStorage (<a href="https://wiki.openstack.org/wiki/Swift">Swift</a>, S3 API).</p>
-</div>
-<div class="paragraph">
-<p>Encryption can be configured on top of ObjectStorage.</p>
-</div>
-<div class="paragraph">
-<p>Blobs can currently be deduplicated in order to reduce storage space. This means that two blobs with
-the same content will be stored one once.</p>
-</div>
-<div class="paragraph">
-<p>The downside is that deletion is more complicated, and a garbage collection needs to be run. A first implementation
-based on bloom filters can be used and triggered using the WebAdmin REST API.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_task_manager"><a class="anchor" href="#_task_manager"></a>Task Manager</h3>
-<div class="paragraph">
-<p>Allows to control and schedule long running tasks run by other
-components. Among other it enables scheduling, progress monitoring,
-cancellation of long running tasks.</p>
-</div>
-<div class="paragraph">
-<p>Distributed James leverage a task manager using Event Sourcing and RabbitMQ for messaging.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_event_sourcing"><a class="anchor" href="#_event_sourcing"></a>Event sourcing</h3>
-<div class="paragraph">
-<p><a href="https://martinfowler.com/eaaDev/EventSourcing.html">Event sourcing</a> implementation
-for the Distributed server stores events in Cassandra. It enables components
-to rely on event sourcing technics for taking decisions.</p>
-</div>
-<div class="paragraph">
-<p>A short list of usage are:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Data leak prevention storage</p>
-</li>
-<li>
-<p>JMAP filtering rules storage</p>
-</li>
-<li>
-<p>Validation of the MailQueue configuration</p>
-</li>
-<li>
-<p>Sending email warnings to user close to their quota</p>
-</li>
-<li>
-<p>Implementation of the TaskManager</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/architecture/specialized-instances.html b/james-distributed-app/3.8.1/architecture/specialized-instances.html
deleted file mode 100644
index 4bf6e67..0000000
--- a/james-distributed-app/3.8.1/architecture/specialized-instances.html
+++ /dev/null
@@ -1,471 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Specialized instances :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Architecture</a></li>
- <li><a href="specialized-instances.html">Specialized instances</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/architecture/specialized-instances.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Specialized instances</h1>
-<div class="paragraph">
-<p>While it is perfectly possible to deploy homogeneous James instances, with the same configuration and thus the same
-protocols and the same responsibilities one might want to investigate in 'Specialized instances'.</p>
-</div>
-<div class="paragraph">
-<p>This deployment topology consists of Distributed James servers with heterogeneous configurations on top of shared
-data-bases. Groups of James servers will thus handle various protocols and have different responsibilities.</p>
-</div>
-<div class="paragraph">
-<p>This approach limits cascading failures across protocols and services. Think of <strong>OutOfMemoryErrors</strong>, Cassandra driver
-queue overuse, CPUs starvation, etc.</p>
-</div>
-<div class="paragraph">
-<p>However, we can’t speak of micro-services here: all James instances runs the same code, James is still a monolith, and
-databases need to be shared across instances.</p>
-</div>
-<div class="imageblock">
-<div class="content">
-<img src="../_images/specialized-instances.png" alt="Example of Specialized instances topology">
-</div>
-</div>
-<div class="paragraph">
-<p>We speak of:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>Front-line servers</strong> serves protocols. James enables to easily turn protocols on and off. Typically, each protocol would
-be isolated in its own group of James instances: james-imap, james-jmap, james-smtp, james-webadmin, etc…​ Refer to
-protocols configuration files to learn more.</p>
-</li>
-<li>
-<p><strong>Back-office servers</strong> handles other services like:</p>
-</li>
-<li>
-<p>Mail processing.</p>
-</li>
-<li>
-<p>Remote delivery.</p>
-</li>
-<li>
-<p>Event processing.</p>
-</li>
-<li>
-<p>Task execution.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Front-line servers will likely not handle back office responsibilities (but be sure to have back-office servers that do!).</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="../configure/mailetcontainer.html" class="xref page">Mail processing can be switched off</a>.</p>
-</li>
-<li>
-<p><a href="../configure/listeners.html" class="xref page">Mailbox event processing can be switched off</a>.</p>
-</li>
-<li>
-<p><a href="../configure/rabbitmq.html" class="xref page">Task execution can be switched off</a>.</p>
-</li>
-<li>
-<p>Remote Delivery service is not started if the RemoteDelivery mailet is not positioned in mailetcontainer.xml.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Of course, the above instances can be collocated at will, to reach some intermediate deployments with fewer
-instances to mitigate costs.</p>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/benchmark/db-benchmark.html b/james-distributed-app/3.8.1/benchmark/db-benchmark.html
deleted file mode 100644
index 1535bd2..0000000
--- a/james-distributed-app/3.8.1/benchmark/db-benchmark.html
+++ /dev/null
@@ -1,1065 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Database benchmarks :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Performance benchmark</a></li>
- <li><a href="db-benchmark.html">Database benchmarks</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/benchmark/db-benchmark.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Database benchmarks</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This document provides basic performance of Distributed James' databases, benchmark methodologies as a basis for a James administrator who
-can test and evaluate if his Distributed James databases are performing well.</p>
-</div>
-<div class="paragraph">
-<p>It includes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>A sample deployment topology</p>
-</li>
-<li>
-<p>Propose benchmark methodology and base performance for each database. This aims to help operators to quickly identify
-performance issues and compliance of their databases.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_sample_deployment_topology"><a class="anchor" href="#_sample_deployment_topology"></a>Sample deployment topology</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>We deploy a sample topology of Distributed James with these following databases:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Apache Cassandra 4 as main database: 3 nodes, each node has 8 OVH vCores CPU and 30 GB memory limit (OVH b2-30 instance).</p>
-</li>
-<li>
-<p>OpenDistro 1.13.1 as search engine: 3 nodes, each node has 8 OVH vCores CPU and 30 GB memory limit (OVH b2-30 instance).</p>
-</li>
-<li>
-<p>RabbitMQ 3.8.17 as message queue: 3 Kubernetes pods, each pod has 0.6 OVH vCore CPU and 2 GB memory limit.</p>
-</li>
-<li>
-<p>OVH Swift S3 as an object storage</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>With the above system, our email service operates stably with valuable performance.
-For a more details, it can handle a load throughput up to about 1000 JMAP requests per second with 99th percentile latency is 400ms.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_benchmark_methodologies_and_base_performances"><a class="anchor" href="#_benchmark_methodologies_and_base_performances"></a>Benchmark methodologies and base performances</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>We are willing to share the benchmark methodologies and the result to you as a reference to evaluate your Distributed James' performance.
-Other evaluation methods are welcome, as long as your databases exhibit similar or even better performance than ours.
-It is up to your business needs. If your databases shows results that fall far from our baseline performance, there’s a good chance that
-there are problems with your system, and you need to check it out thoroughly.</p>
-</div>
-<div class="sect2">
-<h3 id="_benchmark_cassandra"><a class="anchor" href="#_benchmark_cassandra"></a>Benchmark Cassandra</h3>
-<div class="sect3">
-<h4 id="_benchmark_methodology"><a class="anchor" href="#_benchmark_methodology"></a>Benchmark methodology</h4>
-<div class="sect4">
-<h5 id="_benchmark_tool"><a class="anchor" href="#_benchmark_tool"></a>Benchmark tool</h5>
-<div class="paragraph">
-<p>We use <a href="https://cassandra.apache.org/doc/latest/cassandra/tools/cassandra_stress.html">cassandra-stress tool</a> - an official
-tool of Cassandra for stress loading tests.</p>
-</div>
-<div class="paragraph">
-<p>The cassandra-stress tool is a Java-based stress testing utility for basic benchmarking and load testing a Cassandra cluster.
-Data modeling choices can greatly affect application performance. Significant load testing over several trials is the best method for discovering issues with a particular data model. The cassandra-stress tool is an effective tool for populating a cluster and stress testing CQL tables and queries. Use cassandra-stress to:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Quickly determine how a schema performs.</p>
-</li>
-<li>
-<p>Understand how your database scales.</p>
-</li>
-<li>
-<p>Optimize your data model and settings.</p>
-</li>
-<li>
-<p>Determine production capacity.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>There are several operation types:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>write-only, read-only, and mixed workloads of standard data</p>
-</li>
-<li>
-<p>write-only and read-only workloads for counter columns</p>
-</li>
-<li>
-<p>user configured workloads, running custom queries on custom schemas</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect4">
-<h5 id="_how_to_benchmark"><a class="anchor" href="#_how_to_benchmark"></a>How to benchmark</h5>
-<div class="paragraph">
-<p>Here we are using a simple case to test and compare Cassandra performance between different setup environments.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">keyspace: stresscql
-
-keyspace_definition: |
- CREATE KEYSPACE stresscql WITH replication = {'class': 'SimpleStrategy', 'replication_factor': 3};
-
-table: mixed_workload
-
-table_definition: |
- CREATE TABLE mixed_workload (
- key uuid PRIMARY KEY,
- a blob,
- b blob
- ) WITH COMPACT STORAGE
-
-columnspec:
- - name: a
- size: uniform(1..10000)
- - name: b
- size: uniform(1..100000)
-
-insert:
- partitions: fixed(1)
-
-queries:
- read:
- cql: select * from mixed_workload where key = ?
- fields: samerow</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Create the yaml file as above and copy to a Cassandra node.</p>
-</div>
-<div class="paragraph">
-<p>Insert some sample data:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">cassandra-stress user profile=mixed_workload.yml n=100000 "ops(insert=1)" cl=ONE -mode native cql3 user=<user> password=<password> -node <IP> -rate threads=8 -graph file=./graph_insert.xml title=Benchmark revision=insert_ONE</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Read intensive scenario:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">cassandra-stress user profile=mixed_workload.yml n=100000 "ops(insert=1,read=4)" cl=ONE -mode native cql3 user=<user> password=<password> -node <IP> -rate threads=8 -graph file=./graph_mixed.xml title=Benchmark revision=mixed_ONE</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>In there:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>n=100000: The number of insert batches, not number of individual insert operations.</p>
-</li>
-<li>
-<p>rate threads=8: The number of concurrent threads. If not specified it will start with 4 threads and increase until server reaches a limit.</p>
-</li>
-<li>
-<p>ops(insert=1,read=4): This will execute insert and read queries in the ratio 1:4.</p>
-</li>
-<li>
-<p>graph: Export results to graph in html format.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_sample_benchmark_result"><a class="anchor" href="#_sample_benchmark_result"></a>Sample benchmark result</h4>
-<div class="imageblock">
-<div class="content">
-<img src="../_images/cassandra_stress_test_result_1.png" alt="cassandra stress test result 1">
-</div>
-</div>
-<div class="imageblock">
-<div class="content">
-<img src="../_images/cassandra_stress_test_result_2.png" alt="cassandra stress test result 2">
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_references"><a class="anchor" href="#_references"></a>References</h4>
-<div class="paragraph">
-<p><a href="https://www.datastax.com/blog/improved-cassandra-21-stress-tool-benchmark-any-schema-part-1">Datastax - Cassandra stress tool</a></p>
-</div>
-<div class="paragraph">
-<p><a href="https://www.instaclustr.com/deep-diving-cassandra-stress-part-3-using-yaml-profiles/">Deep Diving cassandra-stress – Part 3 (Using YAML Profiles)</a></p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_benchmark_opensearch"><a class="anchor" href="#_benchmark_opensearch"></a>Benchmark OpenSearch</h3>
-<div class="sect3">
-<h4 id="_benchmark_methodology_2"><a class="anchor" href="#_benchmark_methodology_2"></a>Benchmark methodology</h4>
-<div class="sect4">
-<h5 id="_benchmark_tool_2"><a class="anchor" href="#_benchmark_tool_2"></a>Benchmark tool</h5>
-<div class="paragraph">
-<p>We use <a href="https://github.com/opensearch-project/opensearch-benchmark">opensearch-benchmark</a> - an official OpenSearch benchmarking tool.
-It provides the following features:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Automatically create OpenSearch clusters, stress tests them, and delete them.</p>
-</li>
-<li>
-<p>Manage stress testing data and solutions by OpenSearch version.</p>
-</li>
-<li>
-<p>Present stress testing data in a comprehensive way, allowing you to compare and analyze the data of different stress tests and store the data on a particular OpenSearch instance for secondary analysis.</p>
-</li>
-<li>
-<p>Collect Java Virtual Machine (JVM) details, such as memory and garbage collection (GC) data, to locate performance problems.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect4">
-<h5 id="_how_to_benchmark_2"><a class="anchor" href="#_how_to_benchmark_2"></a>How to benchmark</h5>
-<div class="paragraph">
-<p>To install the <code>opensearch-benchmark</code> tool, you need Python 3.8+ including pip3 first, then run:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">python3 -m pip install opensearch-benchmark</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If you have any trouble or need more detailed instructions, please look in the <a href="https://github.com/opensearch-project/OpenSearch-Benchmark/blob/main/DEVELOPER_GUIDE.md">detailed installation guide</a>.</p>
-</div>
-<div class="paragraph">
-<p>Let’s see which workloads (simulation profiles) that <code>opensearch-benchmark</code> provides: <code><code>opensearch-benchmark list worloads</code></code>.
-For our James use case, we are interested in <code><code>pmc</code></code> workload: <code><code>Full-text benchmark with academic papers from PMC</code></code>.</p>
-</div>
-<div class="paragraph">
-<p>Run the below script to benchmark against your OpenSearch cluster:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">opensearch-benchmark execute_test --pipeline=benchmark-only --workload=[workload-name] --target-host=[ip_node1:port_node1],[ip_node2:port_node2],[ip_node3:port_node3] --client-options="use_ssl:false,verify_certs:false,basic_auth_user:'[user]',basic_auth_password:'[password]'"</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>In there:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>--pipeline=benchmark-only: benchmark against a running cluster</p>
-</li>
-<li>
-<p>workload-name: the workload you want to benchmark</p>
-</li>
-<li>
-<p>ip:port: OpenSearch Node' socket</p>
-</li>
-<li>
-<p>user/password: OpenSearch authentication credentials</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_sample_benchmark_result_2"><a class="anchor" href="#_sample_benchmark_result_2"></a>Sample benchmark result</h4>
-<div class="sect4">
-<h5 id="_pmc_worload"><a class="anchor" href="#_pmc_worload"></a>PMC worload</h5>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">| Metric | Task | Value | Unit |
-|---------------------------------------------------------------:|------------------------------:|------------:|--------:|
-| Min Throughput | index-append | 734.63 | docs/s |
-| Mean Throughput | index-append | 763.16 | docs/s |
-| Median Throughput | index-append | 746.5 | docs/s |
-| Max Throughput | index-append | 833.51 | docs/s |
-| 50th percentile latency | index-append | 4738.57 | ms |
-| 90th percentile latency | index-append | 8129.1 | ms |
-| 99th percentile latency | index-append | 11734.5 | ms |
-| 100th percentile latency | index-append | 14662.9 | ms |
-| 50th percentile service time | index-append | 4738.57 | ms |
-| 90th percentile service time | index-append | 8129.1 | ms |
-| 99th percentile service time | index-append | 11734.5 | ms |
-| 100th percentile service time | index-append | 14662.9 | ms |
-| error rate | index-append | 0 | % |
-| Min Throughput | default | 19.94 | ops/s |
-| Mean Throughput | default | 19.95 | ops/s |
-| Median Throughput | default | 19.95 | ops/s |
-| Max Throughput | default | 19.96 | ops/s |
-| 50th percentile latency | default | 23.1322 | ms |
-| 90th percentile latency | default | 25.4129 | ms |
-| 99th percentile latency | default | 29.1382 | ms |
-| 100th percentile latency | default | 29.4762 | ms |
-| 50th percentile service time | default | 21.4895 | ms |
-| 90th percentile service time | default | 23.589 | ms |
-| 99th percentile service time | default | 26.6134 | ms |
-| 100th percentile service time | default | 27.9068 | ms |
-| error rate | default | 0 | % |
-| Min Throughput | term | 19.93 | ops/s |
-| Mean Throughput | term | 19.94 | ops/s |
-| Median Throughput | term | 19.94 | ops/s |
-| Max Throughput | term | 19.95 | ops/s |
-| 50th percentile latency | term | 31.0684 | ms |
-| 90th percentile latency | term | 34.1419 | ms |
-| 99th percentile latency | term | 74.7904 | ms |
-| 100th percentile latency | term | 103.663 | ms |
-| 50th percentile service time | term | 29.6775 | ms |
-| 90th percentile service time | term | 32.4288 | ms |
-| 99th percentile service time | term | 36.013 | ms |
-| 100th percentile service time | term | 102.193 | ms |
-| error rate | term | 0 | % |
-| Min Throughput | phrase | 19.94 | ops/s |
-| Mean Throughput | phrase | 19.95 | ops/s |
-| Median Throughput | phrase | 19.95 | ops/s |
-| Max Throughput | phrase | 19.95 | ops/s |
-| 50th percentile latency | phrase | 23.0255 | ms |
-| 90th percentile latency | phrase | 26.1607 | ms |
-| 99th percentile latency | phrase | 31.2094 | ms |
-| 100th percentile latency | phrase | 45.5012 | ms |
-| 50th percentile service time | phrase | 21.5109 | ms |
-| 90th percentile service time | phrase | 24.4144 | ms |
-| 99th percentile service time | phrase | 26.1865 | ms |
-| 100th percentile service time | phrase | 43.5122 | ms |
-| error rate | phrase | 0 | % |
-
-----------------------------------
-[INFO] SUCCESS (took 1772 seconds)
-----------------------------------</code></pre>
-</div>
-</div>
-</div>
-<div class="sect4">
-<h5 id="_pmc_custom_workload"><a class="anchor" href="#_pmc_custom_workload"></a>PMC custom workload</h5>
-<div class="paragraph">
-<p>We customized the PMC workload by increasing search throughput target to figure out our OpenSearch cluster limit.</p>
-</div>
-<div class="paragraph">
-<p>The result is that with 25-30 request/s we have a 99th percentile latency of 1s.</p>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_references_2"><a class="anchor" href="#_references_2"></a>References</h4>
-<div class="paragraph">
-<p>The <code>opensearch-benchmark</code> tool seems to be a fork of the official benchmark tool <a href="https://github.com/elastic/rally">EsRally</a> of Elasticsearch.
-The <code>opensearch-benchmark</code> tool is not adopted widely yet, so we believe some EsRally references could help as well:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://www.alibabacloud.com/blog/esrally-official-stress-testing-tool-for-elasticsearch_597102">esrally: Official Stress Testing Tool for Elasticsearch</a></p>
-</li>
-<li>
-<p><a href="https://esrally.readthedocs.io/en/latest/adding_tracks.html">Create a custom EsRally track</a></p>
-</li>
-<li>
-<p><a href="https://discuss.elastic.co/t/why-the-percentile-latency-is-several-times-more-than-service-time/69630">Why the percentile latency is several times more than service time</a></p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_benchmark_rabbitmq"><a class="anchor" href="#_benchmark_rabbitmq"></a>Benchmark RabbitMQ</h3>
-<div class="sect3">
-<h4 id="_benchmark_methodology_3"><a class="anchor" href="#_benchmark_methodology_3"></a>Benchmark methodology</h4>
-<div class="sect4">
-<h5 id="_benchmark_tool_3"><a class="anchor" href="#_benchmark_tool_3"></a>Benchmark tool</h5>
-<div class="paragraph">
-<p>We use <a href="https://github.com/rabbitmq/rabbitmq-perf-test">rabbitmq-perf-test</a> tool.</p>
-</div>
-</div>
-<div class="sect4">
-<h5 id="_how_to_benchmark_3"><a class="anchor" href="#_how_to_benchmark_3"></a>How to benchmark</h5>
-<div class="paragraph">
-<p>Using PerfTestMulti for more friendly:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Provide input scenario from a single file</p>
-</li>
-<li>
-<p>Provide output result as a single file. Can be visualized result file by the chart (graph WebUI)</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Run a command like below:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">bin/runjava com.rabbitmq.perf.PerfTestMulti [scenario-file] [result-file]</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>In order to visualize result, coping [result-file] to <code><code>/html/examples/[result-file]</code></code>.
-Start webserver to view graph by the command:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">bin/runjava com.rabbitmq.perf.WebServer</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Then browse: <a href="http://localhost:8080/examples/sample.html" class="bare">http://localhost:8080/examples/sample.html</a></p>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_sample_benchmark_result_3"><a class="anchor" href="#_sample_benchmark_result_3"></a>Sample benchmark result</h4>
-<div class="ulist">
-<ul>
-<li>
-<p>Scenario file:</p>
-</li>
-</ul>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">[{'name': 'consume', 'type': 'simple',
-'uri': 'amqp://james:eeN7Auquaeng@localhost:5677',
-'params':
- [{'time-limit': 30, 'producer-count': 2, 'consumer-count': 4}]}]</code></pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Result file:</p>
-</li>
-</ul>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{
- "consume": {
- "send-bytes-rate": 0,
- "recv-msg-rate": 4330.225080385852,
- "avg-latency": 18975254,
- "send-msg-rate": 455161.3183279743,
- "recv-bytes-rate": 0,
- "samples": [{
- "elapsed": 15086,
- "send-bytes-rate": 0,
- "recv-msg-rate": 0,
- "send-msg-rate": 0.06628662335940608,
- "recv-bytes-rate": 0
- },
- {
- "elapsed": 16086,
- "send-bytes-rate": 0,
- "recv-msg-rate": 1579,
- "max-latency": 928296,
- "min-latency": 278765,
- "avg-latency": 725508,
- "send-msg-rate": 388994,
- "recv-bytes-rate": 0
- },
- {
- "elapsed": 48184,
- "send-bytes-rate": 0,
- "recv-msg-rate": 3768.4918347742555,
- "max-latency": 32969370,
- "min-latency": 31852685,
- "avg-latency": 32385432,
- "send-msg-rate": 0,
- "recv-bytes-rate": 0
- },
- {
- "elapsed": 49186,
- "send-bytes-rate": 0,
- "recv-msg-rate": 4416.167664670658,
- "max-latency": 33953465,
- "min-latency": 32854771,
- "avg-latency": 33373113,
- "send-msg-rate": 0,
- "recv-bytes-rate": 0
- }]
- }
-}</code></pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Key result points:</p>
-</li>
-</ul>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<colgroup>
-<col style="width: 33.3333%;">
-<col style="width: 33.3333%;">
-<col style="width: 33.3334%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Metrics</th>
-<th class="tableblock halign-left valign-top">Unit</th>
-<th class="tableblock halign-left valign-top">Result</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Publisher throughput (the sending rate)</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">messages / second</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">3111</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Consumer throughput (the receiving rate)</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">messages / second</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">4404</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_benchmark_s3_storage"><a class="anchor" href="#_benchmark_s3_storage"></a>Benchmark S3 storage</h3>
-<div class="sect3">
-<h4 id="_benchmark_methodology_4"><a class="anchor" href="#_benchmark_methodology_4"></a>Benchmark methodology</h4>
-<div class="sect4">
-<h5 id="_benchmark_tool_4"><a class="anchor" href="#_benchmark_tool_4"></a>Benchmark tool</h5>
-<div class="paragraph">
-<p>We use <a href="https://github.com/dvassallo/s3-benchmark">s3-benchmark</a> tool.</p>
-</div>
-</div>
-<div class="sect4">
-<h5 id="_how_to_benchmark_4"><a class="anchor" href="#_how_to_benchmark_4"></a>How to benchmark</h5>
-<div class="olist arabic">
-<ol class="arabic">
-<li>
-<p>Make sure you set up appropriate S3 credentials with <code>awscli</code>.</p>
-</li>
-<li>
-<p>If you are using a compatible S3 storage of cloud providers like OVH, you would need to configure
-<code>awscli-plugin-endpoint</code>. E.g: <a href="https://docs.ovh.com/au/en/storage/getting_started_with_the_swift_S3_API/">Getting started with the OVH Swift S3 API</a></p>
-</li>
-<li>
-<p>Install <code>s3-benchmark</code> tool and run the command:</p>
-</li>
-</ol>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./s3-benchmark -endpoint=[endpoint] -region=[region] -bucket-name=[bucket-name] -payloads-min=[payload-min] -payloads-max=[payload-max] threads-max=[threads-max]</code></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_sample_benchmark_result_4"><a class="anchor" href="#_sample_benchmark_result_4"></a>Sample benchmark result</h4>
-<div class="paragraph">
-<p>We did S3 performance testing with suitable email objects sizes: 4 KB, 128 KB, 1 MB, 8 MB.</p>
-</div>
-<div class="paragraph">
-<p>Result:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">--- SETUP --------------------------------------------------------------------------------------------------------------------
-
-Uploading 4 KB objects
- 100% |████████████████████████████████████████| [4s:0s]
-Uploading 128 KB objects
- 100% |████████████████████████████████████████| [9s:0s]
-Uploading 1 MB objects
- 100% |████████████████████████████████████████| [8s:0s]
-Uploading 8 MB objects
- 100% |████████████████████████████████████████| [10s:0s]
-
---- BENCHMARK ----------------------------------------------------------------------------------------------------------------
-
-Download performance with 4 KB objects (b2-30)
- +-------------------------------------------------------------------------------------------------+
- | Time to First Byte (ms) | Time to Last Byte (ms) |
-+---------+----------------+------------------------------------------------+------------------------------------------------+
-| Threads | Throughput | avg min p25 p50 p75 p90 p99 max | avg min p25 p50 p75 p90 p99 max |
-+---------+----------------+------------------------------------------------+------------------------------------------------+
-| 8 | 0.6 MB/s | 36 10 17 22 36 57 233 249 | 37 10 17 22 36 57 233 249 |
-| 9 | 0.6 MB/s | 30 10 15 21 33 45 82 234 | 30 10 15 21 33 45 83 235 |
-| 10 | 0.2 MB/s | 55 11 18 22 28 52 248 1075 | 55 11 18 22 28 52 249 1075 |
-| 11 | 0.3 MB/s | 66 11 18 23 45 233 293 683 | 67 11 19 23 45 233 293 683 |
-| 12 | 0.6 MB/s | 35 12 19 22 43 55 67 235 | 35 12 19 22 43 56 67 235 |
-| 13 | 0.2 MB/s | 68 11 19 26 58 79 279 1037 | 68 11 19 26 58 80 279 1037 |
-| 14 | 0.6 MB/s | 43 17 20 24 52 56 230 236 | 43 17 20 25 52 56 230 236 |
-| 15 | 0.2 MB/s | 69 11 16 23 50 66 274 1299 | 69 11 16 24 50 66 274 1299 |
-| 16 | 0.5 MB/s | 52 9 19 31 81 95 228 237 | 53 9 19 31 81 95 229 237 |
-+---------+----------------+------------------------------------------------+------------------------------------------------+
-
-Download performance with 128 KB objects (b2-30)
- +-------------------------------------------------------------------------------------------------+
- | Time to First Byte (ms) | Time to Last Byte (ms) |
-+---------+----------------+------------------------------------------------+------------------------------------------------+
-| Threads | Throughput | avg min p25 p50 p75 p90 p99 max | avg min p25 p50 p75 p90 p99 max |
-+---------+----------------+------------------------------------------------+------------------------------------------------+
-| 8 | 3.3 MB/s | 71 16 22 28 39 66 232 1768 | 73 16 23 29 43 67 233 1769 |
-| 9 | 3.6 MB/s | 74 9 19 23 34 58 239 1646 | 75 10 20 24 37 59 240 1647 |
-| 10 | 2.9 MB/s | 97 16 21 24 48 89 656 2034 | 99 17 21 26 49 92 657 2035 |
-| 11 | 3.0 MB/s | 100 10 21 26 39 64 1049 2029 | 101 11 21 27 40 65 1050 2030 |
-| 12 | 3.0 MB/s | 76 12 19 24 44 56 256 2012 | 77 13 20 25 48 69 258 2013 |
-| 13 | 6.1 MB/s | 73 10 13 20 43 223 505 1026 | 74 10 15 21 43 224 506 1027 |
-| 14 | 5.5 MB/s | 81 11 15 23 51 240 666 1060 | 82 12 16 23 54 241 667 1060 |
-| 15 | 2.7 MB/s | 80 10 19 28 43 59 234 2222 | 84 11 25 34 47 60 236 2224 |
-| 16 | 18.6 MB/s | 58 10 19 26 61 224 248 266 | 61 10 22 29 65 224 249 267 |
-+---------+----------------+------------------------------------------------+------------------------------------------------+
-
-Download performance with 1 MB objects (b2-30)
- +-------------------------------------------------------------------------------------------------+
- | Time to First Byte (ms) | Time to Last Byte (ms) |
-+---------+----------------+------------------------------------------------+------------------------------------------------+
-| Threads | Throughput | avg min p25 p50 p75 p90 p99 max | avg min p25 p50 p75 p90 p99 max |
-+---------+----------------+------------------------------------------------+------------------------------------------------+
-| 8 | 56.4 MB/s | 41 12 26 34 43 57 94 235 | 136 30 69 100 161 284 345 396 |
-| 9 | 55.2 MB/s | 53 19 32 39 50 69 238 247 | 149 26 84 117 164 245 324 655 |
-| 10 | 33.9 MB/s | 74 17 27 37 50 77 456 1060 | 177 29 97 134 205 273 484 1076 |
-| 11 | 57.3 MB/s | 56 26 35 44 57 71 251 298 | 185 40 93 129 216 329 546 871 |
-| 12 | 37.7 MB/s | 66 21 33 43 58 73 102 1024 | 202 24 81 125 205 427 839 1222 |
-| 13 | 57.6 MB/s | 59 24 35 40 58 71 275 289 | 215 40 94 181 288 393 500 674 |
-| 14 | 47.1 MB/s | 73 18 46 56 66 75 475 519 | 229 30 116 221 272 441 603 686 |
-| 15 | 58.2 MB/s | 65 11 40 51 63 75 260 294 | 243 29 132 174 265 485 831 849 |
-| 16 | 23.1 MB/s | 96 14 46 55 62 80 124 2022 | 278 31 124 187 249 634 827 2028 |
-+---------+----------------+------------------------------------------------+------------------------------------------------+
-
-Download performance with 8 MB objects (b2-30)
- +-------------------------------------------------------------------------------------------------+
- | Time to First Byte (ms) | Time to Last Byte (ms) |
-+---------+----------------+------------------------------------------------+------------------------------------------------+
-| Threads | Throughput | avg min p25 p50 p75 p90 p99 max | avg min p25 p50 p75 p90 p99 max |
-+---------+----------------+------------------------------------------------+------------------------------------------------+
-| 8 | 58.4 MB/s | 88 35 65 79 88 96 288 307 | 1063 458 564 759 928 1151 4967 6841 |
-| 9 | 50.4 MB/s | 137 32 52 69 145 286 509 1404 | 1212 160 471 581 1720 2873 3744 4871 |
-| 10 | 58.2 MB/s | 77 46 54 66 77 98 275 285 | 1319 377 432 962 1264 3232 4266 6151 |
-| 11 | 58.4 MB/s | 97 32 63 72 80 91 323 707 | 1429 325 593 722 1648 3020 6172 6370 |
-| 12 | 58.5 MB/s | 108 26 65 81 91 261 301 519 | 1569 472 696 1101 1915 3175 4066 5110 |
-| 13 | 56.1 MB/s | 115 35 69 83 93 125 329 1092 | 1712 458 801 1165 2354 3559 3865 5945 |
-| 14 | 58.6 MB/s | 103 26 70 78 88 112 309 656 | 1807 789 999 1269 1998 3258 5201 6651 |
-| 15 | 58.3 MB/s | 113 31 55 67 79 134 276 1490 | 1947 497 1081 1756 2730 3557 3799 3974 |
-| 16 | 58.0 MB/s | 99 35 67 79 96 146 282 513 | 2091 531 882 1136 2161 6034 6686 6702 |
-+---------+----------------+------------------------------------------------+------------------------------------------------+</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>We believe that the actual OVH Swift S3' throughput should be at least about 100 MB/s. This was not fully achieved due to
-network limitations of the client machine performing the benchmark.</p>
-</div>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/benchmark/index.html b/james-distributed-app/3.8.1/benchmark/index.html
deleted file mode 100644
index 7921a96..0000000
--- a/james-distributed-app/3.8.1/benchmark/index.html
+++ /dev/null
@@ -1,410 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Performance testing the Distributed server :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item is-current-page" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Performance benchmark</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/benchmark/index.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Performance testing the Distributed server</h1>
-<div class="paragraph">
-<p>The following pages detail how to do performance testing for the Distributed server also its database.</p>
-</div>
-<div class="paragraph">
-<p>Once you have a Distributed James server up and running you then need to ensure it operates correctly and has a decent performance.
-You may need to do performance testings periodically to make sure your James performs well.</p>
-</div>
-<div class="paragraph">
-<p>We introduced <a href="james-benchmark.html" class="xref page">tools and base benchmark result for Distributed James</a> also <a href="db-benchmark.html" class="xref page">James database’s base performance and how to benchmark them</a>
-to cover this topic.</p>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/benchmark/james-benchmark.html b/james-distributed-app/3.8.1/benchmark/james-benchmark.html
deleted file mode 100644
index f3b1ab4..0000000
--- a/james-distributed-app/3.8.1/benchmark/james-benchmark.html
+++ /dev/null
@@ -1,600 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server benchmark :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Performance benchmark</a></li>
- <li><a href="james-benchmark.html">James benchmarks</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/benchmark/james-benchmark.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server benchmark</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This document provides benchmark methodology and basic performance of Distributed James as a basis for a James administrator who
-can test and evaluate if his Distributed James is performing well.</p>
-</div>
-<div class="paragraph">
-<p>It includes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>A sample Distributed James deployment topology</p>
-</li>
-<li>
-<p>Propose benchmark methodology</p>
-</li>
-<li>
-<p>Sample performance results</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This aims to help operators quickly identify performance issues.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_sample_deployment_topology"><a class="anchor" href="#_sample_deployment_topology"></a>Sample deployment topology</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>We deploy a sample topology of Distributed James with these following components:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Distributed James: 3 Kubernetes pods, each pod has 2 OVH vCore CPU and 4 GB memory limit.</p>
-</li>
-<li>
-<p>Apache Cassandra 4 as main database: 3 nodes, each node has 8 OVH vCores CPU and 30 GB memory limit (OVH b2-30 instance).</p>
-</li>
-<li>
-<p>OpenDistro 1.13.1 as search engine: 3 nodes, each node has 8 OVH vCores CPU and 30 GB memory limit (OVH b2-30 instance).</p>
-</li>
-<li>
-<p>RabbitMQ 3.8.17 as message queue: 3 Kubernetes pods, each pod has 0.6 OVH vCore CPU and 2 GB memory limit.</p>
-</li>
-<li>
-<p>OVH Swift S3 as an object storage</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_benchmark_methodology_and_base_performance"><a class="anchor" href="#_benchmark_methodology_and_base_performance"></a>Benchmark methodology and base performance</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_provision_testing_data"><a class="anchor" href="#_provision_testing_data"></a>Provision testing data</h3>
-<div class="paragraph">
-<p>Before doing the performance test, you should make sure you have a Distributed James up and running with some provisioned testing
-data so that it is representative of reality.</p>
-</div>
-<div class="paragraph">
-<p>Please follow these steps to provision testing data:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Prepare James with a custom <code>mailetcontainer.xml</code> having Random storing mailet. This help us easily setting a good amount of
-provisioned emails.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Add this under transport processor</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre><mailet match="All" class="RandomStoring"/></pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Modify <a href="https://github.com/apache/james-project/tree/master/server/apps/distributed-app/docs/modules/ROOT/pages/benchmark/provision.sh">provision.sh</a>
-upon your need (number of users, mailboxes, emails to be provisioned).</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Currently, this script provisions 10 users, 15 mailboxes and hundreds of emails for example. Normally to make the performance test representative, you
-should provision thousands of users, thousands of mailboxes and millions of emails.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Add the permission to execute the script:</p>
-</li>
-</ul>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>chmod +x provision.sh</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Install postfix (to get the smtp-source command):</p>
-</li>
-</ul>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>sudo apt-get install postfix</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Run the provision script:</p>
-</li>
-</ul>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>./provision.sh</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>After provisioning once, you should remove the Random storing mailet and move on to performance testing phase.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_provide_performance_testing_method"><a class="anchor" href="#_provide_performance_testing_method"></a>Provide performance testing method</h3>
-<div class="paragraph">
-<p>We introduce the tailored <a href="https://github.com/linagora/james-gatling">James Gatling</a> which bases on <a href="https://gatling.io/">Gatling - Load testing framework</a>
-for performance testing against IMAP/JMAP servers. Other testing method is welcome as long as you feel it is appropriate.</p>
-</div>
-<div class="paragraph">
-<p>Here are steps to do performance testing with James Gatling:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Setup James Gatling with <code>sbt</code> build tool</p>
-</li>
-<li>
-<p>Configure the <code>Configuration.scala</code> to point to your Distributed James IMAP/JMAP server(s). For more configuration details, please read
-<a href="https://github.com/linagora/james-gatling#readme">James Gatling Readme</a>.</p>
-</li>
-<li>
-<p>Run the performance testing simulation:</p>
-</li>
-</ul>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>$ sbt
-> gatling:testOnly SIMULATION_FQDN</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>In there: <code>SIMULATION_FQDN</code> is fully qualified class name of a performance test simulation.</p>
-</div>
-<div class="paragraph">
-<p>We did provide a lot of simulations in <code>org.apache.james.gatling.simulation</code> path. You can have a look and choose the suitable simulation.
-<code>sbt gatling:testOnly org.apache.james.gatling.simulation.imap.PlatformValidationSimulation</code> is a good starting point. Or you can even customize your simulation also!</p>
-</div>
-<div class="paragraph">
-<p>Some symbolic simulations we often use:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>IMAP: <code>org.apache.james.gatling.simulation.imap.PlatformValidationSimulation</code></p>
-</li>
-<li>
-<p>JMAP rfc8621: <code>org.apache.james.gatling.simulation.jmap.rfc8621.PushPlatformValidationSimulation</code></p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_base_performance_result"><a class="anchor" href="#_base_performance_result"></a>Base performance result</h3>
-<div class="paragraph">
-<p>A sample IMAP performance testing result (PlatformValidationSimulation):</p>
-</div>
-<div class="imageblock">
-<div class="content">
-<img src="../_images/james-imap-base-performance.png" alt="james imap base performance">
-</div>
-</div>
-<div class="paragraph">
-<p>If you get a IMAP performance far below this base performance, you should consider investigating for performance issues.</p>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/configure/batchsizes.html b/james-distributed-app/3.8.1/configure/batchsizes.html
deleted file mode 100644
index f598627..0000000
--- a/james-distributed-app/3.8.1/configure/batchsizes.html
+++ /dev/null
@@ -1,451 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — batchsizes.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Core components</li>
- <li><a href="batchsizes.html">batchsizes.properties</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/batchsizes.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — batchsizes.properties</h1>
-<div class="paragraph">
-<p>This files allow to define the amount of data that should be fetched 'at once' when interacting with the mailbox. This is
-needed as IMAP can generate some potentially large requests.</p>
-</div>
-<div class="paragraph">
-<p>Increasing these values tend to fasten individual requests, at the cost of enabling potential higher load.</p>
-</div>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/batchsizes.properties">example</a>
-to get some examples and hints.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. batchsizes.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">fetch.metadata</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional, defaults to 200. How many messages should be read in a batch when using FetchType.MetaData</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">fetch.headers</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional, defaults to 200. How many messages should be read in a batch when using FetchType.Header</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">fetch.body</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional, defaults to 100. How many messages should be read in a batch when using FetchType.Body</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">fetch.full</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional, defaults to 50. How many messages should be read in a batch when using FetchType.Full</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">copy</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional, defaults to 200. How many messages should be copied in a batch.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">move</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional, defaults to 200. How many messages should be moved in a batch.</p></td>
-</tr>
-</tbody>
-</table>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/configure/blobstore.html b/james-distributed-app/3.8.1/configure/blobstore.html
deleted file mode 100644
index 11ff687..0000000
--- a/james-distributed-app/3.8.1/configure/blobstore.html
+++ /dev/null
@@ -1,818 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — blobstore.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Storage dependencies</li>
- <li><a href="blobstore.html">blobstore.properties</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/blobstore.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — blobstore.properties</h1>
-<div class="sect1">
-<h2 id="_blobstore"><a class="anchor" href="#_blobstore"></a>BlobStore</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This file is optional. If omitted, the <strong>cassandra</strong> blob store will be used.</p>
-</div>
-<div class="paragraph">
-<p>BlobStore is the dedicated component to store blobs, non-indexable content.
-James uses the BlobStore for storing blobs which are usually mail contents, attachments, deleted mails…​</p>
-</div>
-<div class="paragraph">
-<p>You can choose the underlying implementation of BlobStore to fit with your James setup.</p>
-</div>
-<div class="paragraph">
-<p>It could be the implementation on top of Cassandra or file storage service S3 compatible like Openstack Swift and AWS S3.</p>
-</div>
-<div class="paragraph">
-<p>Consult <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/blob.properties">blob.properties</a>
-in GIT to get some examples and hints.</p>
-</div>
-<div class="sect2">
-<h3 id="_implementation_choice"><a class="anchor" href="#_implementation_choice"></a>Implementation choice</h3>
-<div class="paragraph">
-<p><strong>implementation</strong> :</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>cassandra: use cassandra based BlobStore</p>
-</li>
-<li>
-<p>objectstorage: use Swift/AWS S3 based BlobStore</p>
-</li>
-<li>
-<p>file: (experimental) use directly the file system. Useful for legacy architecture based on shared ISCI SANs and/or
-distributed file system with no object store available.</p>
-</li>
-</ul>
-</div>
-<div class="admonitionblock warning">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-warning" title="Warning"></i>
-</td>
-<td class="content">
-JAMES-3591 Cassandra is not made to store large binary content, its use will be suboptimal compared to
-Alternatives (namely S3 compatible BlobStores backed by for instance S3, MinIO or Ozone)
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>The generated startup warning log can be deactivated via the <code>cassandra.blob.store.disable.startup.warning</code> environment
-variable being positioned to <code>false</code>.</p>
-</div>
-<div class="paragraph">
-<p><strong>deduplication.enable</strong>: Mandatory. Supported value: true and false.</p>
-</div>
-<div class="paragraph">
-<p>If you choose to enable deduplication, the mails with the same content will be stored only once.</p>
-</div>
-<div class="admonitionblock warning">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-warning" title="Warning"></i>
-</td>
-<td class="content">
-Once this feature is enabled, there is no turning back as turning it off will lead to the deletion of all
-the mails sharing the same content once one is deleted.
-</td>
-</tr>
-</table>
-</div>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-note" title="Note"></i>
-</td>
-<td class="content">
-If you are upgrading from James 3.5 or older, the deduplication was enabled.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>Deduplication requires a garbage collector mechanism to effectively drop blobs. A first implementation
-based on bloom filters can be used and triggered using the WebAdmin REST API. See
-<a href="../operate/webadmin.html#_running_blob_garbage_collection" class="xref page">Running blob garbage collection</a>.</p>
-</div>
-<div class="paragraph">
-<p>In order to avoid concurrency issues upon garbage collection, we slice the blobs in generation, the two more recent
-generations are not garbage collected.</p>
-</div>
-<div class="paragraph">
-<p><strong>deduplication.gc.generation.duration</strong>: Allow controlling the duration of one generation. Longer implies better deduplication
-but deleted blobs will live longer. Duration, defaults on 30 days, the default unit is in days.</p>
-</div>
-<div class="paragraph">
-<p><strong>deduplication.gc.generation.family</strong>: Every time the duration is changed, this integer counter must be incremented to avoid
-conflicts. Defaults to 1.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_encryption_choice"><a class="anchor" href="#_encryption_choice"></a>Encryption choice</h3>
-<div class="paragraph">
-<p>Data can be optionally encrypted with a symmetric key using AES before being stored in the blobStore. As many user relies
-on third party for object storage, a compromised third party will not escalate to a data disclosure. Of course, a
-performance price have to be paid, as encryption takes resources.</p>
-</div>
-<div class="paragraph">
-<p><strong>encryption.aes.enable</strong> : Optional boolean, defaults to false.</p>
-</div>
-<div class="paragraph">
-<p>If AES encryption is enabled, then the following properties MUST be present:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>encryption.aes.password</strong> : String</p>
-</li>
-<li>
-<p><strong>encryption.aes.salt</strong> : Hexadecimal string</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The following properties CAN be supplied:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>encryption.aes.private.key.algorithm</strong> : String, defaulting to PBKDF2WithHmacSHA512. Previously was
-PBKDF2WithHmacSHA1.</p>
-</li>
-</ul>
-</div>
-<div class="admonitionblock warning">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-warning" title="Warning"></i>
-</td>
-<td class="content">
-Once chosen this choice can not be reverted, all the data is either clear or encrypted. Mixed encryption
-is not supported.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>Here is an example of how you can generate the above values (be mindful to customize the byte lengths in order to add
-enough entropy.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre># Password generation
-openssl rand -base64 64
-
-# Salt generation
-generate salt with : openssl rand -hex 16</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>AES blob store supports the following system properties that could be configured in <code>jvm.properties</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre># Threshold from which we should buffer the blob to a file upon encrypting
-# Unit supported: K, M, G, default to no unit
-james.blob.aes.file.threshold.encrypt=100K
-
-# Threshold from which we should buffer the blob to a file upon decrypting
-# Unit supported: K, M, G, default to no unit
-james.blob.aes.file.threshold.decrypt=256K
-
-# Maximum size of a blob. Larger blobs will be rejected.
-# Unit supported: K, M, G, default to no unit
-james.blob.aes.blob.max.size=100M</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_cassandra_blobstore_cache"><a class="anchor" href="#_cassandra_blobstore_cache"></a>Cassandra BlobStore Cache</h3>
-<div class="paragraph">
-<p>A Cassandra cache can be enabled to reduce latency when reading small blobs frequently.
-A dedicated keyspace with a replication factor of one is then used.
-Cache eviction policy is TTL based.
-Only blobs below a given threshold will be stored.
-To be noted that blobs are stored within a single Cassandra row, hence a low threshold should be used.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. blobstore.properties cache related content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cache.enable</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">DEFAULT: false, optional, must be a boolean. Whether the cache should be enabled.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cache.cassandra.ttl</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">DEFAULT: 7 days, optional, must be a duration. Cache eviction policy is TTL based.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cache.sizeThresholdInBytes</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">DEFAULT: 8192, optional, must be a positive integer. Unit: bytes.
-Supported units: bytes, Kib, MiB, GiB, TiB
-Maximum size of stored objects expressed in bytes.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="sect2">
-<h3 id="_object_storage_configuration"><a class="anchor" href="#_object_storage_configuration"></a>Object storage configuration</h3>
-<div class="sect3">
-<h4 id="_aws_s3_configuration"><a class="anchor" href="#_aws_s3_configuration"></a>AWS S3 Configuration</h4>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 2. blobstore.properties S3 related properties</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.s3.endPoint</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">S3 service endpoint</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.s3.region</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">S3 region</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.s3.accessKeyId</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys">S3 access key id</a></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.s3.secretKey</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys">S3 access key secret</a></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.s3.http.concurrency</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Allow setting the number of concurrent HTTP requests allowed by the Netty driver.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.s3.truststore.path</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">optional: Verify the S3 server certificate against this trust store file.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.s3.truststore.type</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">optional: Specify the type of the trust store, e.g. JKS, PKCS12</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.s3.truststore.secret</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">optional: Use this secret/password to access the trust store; default none</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.s3.truststore.algorithm</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">optional: Use this specific trust store algorithm; default SunX509</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.s3.trustall</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">optional: boolean. Defaults to false. Cannot be set to true with other trustore options. Wether James should validate
-S3 endpoint SSL certificates.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.s3.read.timeout</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">optional: HTTP read timeout. duration, default value being second. Leaving it empty relies on S3 driver defaults.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.s3.write.timeout</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">optional: HTTP write timeout. duration, default value being second. Leaving it empty relies on S3 driver defaults.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.s3.connection.timeout</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">optional: HTTP connection timeout. duration, default value being second. Leaving it empty relies on S3 driver defaults.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.s3.in.read.limit</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">optional: Object read in memory will be rejected if they exceed the size limit exposed here. Size, exemple <code>100M</code>.
-Supported units: K, M, G, defaults to B if no unit is specified. If unspecified, big object won’t be prevented
-from being loaded in memory. This settings complements protocol limits.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.s3.upload.retry.maxAttempts</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">optional: Integer. Default is zero. This property specifies the maximum number of retry attempts allowed for failed upload operations.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.s3.upload.retry.backoffDurationMillis</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">optional: Long (Milliseconds). Default is 10 (miliseconds).
-Only takes effect when the "objectstorage.s3.upload.retry.maxAttempts" property is declared.
-This property determines the duration (in milliseconds) to wait between retry attempts for failed upload operations.
-This delay is known as backoff. The jitter factor is 0.5</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="sect3">
-<h4 id="_buckets_configuration"><a class="anchor" href="#_buckets_configuration"></a>Buckets Configuration</h4>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 3. Bucket configuration</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.bucketPrefix</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Bucket is a concept in James and similar to Containers in Swift or Buckets in AWS S3.
-BucketPrefix is the prefix of bucket names in James BlobStore</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.namespace</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">BlobStore default bucket name. Most of blobs storing in BlobStore are inside the default bucket.
-Unless a special case like storing blobs of deleted messages.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_blob_export"><a class="anchor" href="#_blob_export"></a>Blob Export</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Blob Exporting is the mechanism to help James to export a blob from an user to another user.
-It is commonly used to export deleted messages (consult <a href="/server/config-vault">configuring deleted messages vault</a>).
-The deleted messages are transformed into a blob and James will export that blob to the target user.</p>
-</div>
-<div class="paragraph">
-<p>This configuration helps you choose the blob exporting mechanism fit with your James setup and it is only applicable with Guice products.</p>
-</div>
-<div class="paragraph">
-<p>Consult <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/blob.properties">blob.properties</a>
-in GIT to get some examples and hints.</p>
-</div>
-<div class="paragraph">
-<p>Configuration for exporting blob content:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 4. blobstore.properties content</caption>
-<colgroup>
-<col style="width: 100%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">blob.export.implementation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">localFile: Local File Exporting Mechanism (explained below). Default: localFile</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">linshare: LinShare Exporting Mechanism (explained below)</p></td>
-</tr>
-</tbody>
-</table>
-<div class="sect2">
-<h3 id="_local_file_blob_export_configuration"><a class="anchor" href="#_local_file_blob_export_configuration"></a>Local File Blob Export Configuration</h3>
-<div class="paragraph">
-<p>For each request, this mechanism retrieves the content of a blob and save it to a distinct local file, then send an email containing the absolute path of that file to the target mail address.</p>
-</div>
-<div class="paragraph">
-<p>Note: that absolute file path is the file location on James server. Therefore, if there are two or more James servers connected, it should not be considered an option.</p>
-</div>
-<div class="paragraph">
-<p><strong>blob.export.localFile.directory</strong>: The directory URL to store exported blob data in files, and the URL following
-<a href="http://james.apache.org/server/3/apidocs/org/apache/james/filesystem/api/FileSystem.html">James File System scheme</a>.
-Default: <a href="file://var/blobExporting" class="bare">file://var/blobExporting</a></p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_linshare_blob_export_configuration"><a class="anchor" href="#_linshare_blob_export_configuration"></a>LinShare Blob Export Configuration</h3>
-<div class="paragraph">
-<p>Instead of exporting blobs in local file system, using <a href="https://www.linshare.org">LinShare</a>
-helps you upload your blobs and people you have been shared to can access those blobs by accessing to
-LinShare server and download them.</p>
-</div>
-<div class="paragraph">
-<p>This way helps you to share via whole network as long as they can access to LinShare server.</p>
-</div>
-<div class="paragraph">
-<p>To get an example or details explained, visit <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/blob.properties">blob.properties</a></p>
-</div>
-<div class="paragraph">
-<p><strong>blob.export.linshare.url</strong>: The URL to connect to LinShare</p>
-</div>
-<div class="paragraph">
-<p><strong>blob.export.linshare.token</strong>: The authentication token to connect to LinShare</p>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/configure/cassandra.html b/james-distributed-app/3.8.1/configure/cassandra.html
deleted file mode 100644
index 779b1f9..0000000
--- a/james-distributed-app/3.8.1/configure/cassandra.html
+++ /dev/null
@@ -1,627 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — cassandra.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Storage dependencies</li>
- <li><a href="cassandra.html">cassandra.properties</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/cassandra.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — cassandra.properties</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This configuration file allow setting some configuration properties in conjunction to
-Cassandra driver native configuration.</p>
-</div>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/cassandra.properties">example</a>
-to get some examples and hints.</p>
-</div>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/cassandra-driver.conf">example</a>
-to get some examples and hints for Cassandra driver native configuration.</p>
-</div>
-<div class="paragraph">
-<p>Cassandra native configuration allows configuring SSL, timeouts, logs and metrics as well as execution profiles.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_configuration"><a class="anchor" href="#_configuration"></a>Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Here are generic properties:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. cassandra.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandra.nodes</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">List of some nodes of the cassandra’s cluster in following format host:port or host, if the port is not specified we use 9042</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandra.keyspace.create</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Indicate if the keyspace should be created by James. Optional, default value: <strong>false</strong>
-If set to true James will attempt to create the keyspace when starting up.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandra.keyspace</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Is the name of the keyspace used by James. Optional, default value: <strong>apache_james</strong></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandra.user</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Username used as a credential for contacting Cassandra cluster. Optional, default is absent,
-required if <strong>cassandra.password</strong> is supplied</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandra.password</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Password used as a credential for contacting Cassandra cluster. Optional, default is absent,
-required if <strong>cassandra.user</strong> is supplied</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandra.replication.factor</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Is the replication factor used upon keyspace creation. Modifying this property while the keyspace already exists
-will have no effect. Optional. Default value 1.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandra.local.dc</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Allows specifying the local DC as part of the load balancing policy. Specifying it
-would result in the use of <code>new TokenAwarePolicy(DCAwareRoundRobinPolicy.builder().withLocalDc(value).build())</code> as a LoadBalancingPolicy.
-This value is useful in a multi-DC Cassandra setup. Be aware of <a href="../architecture/consistency-model.html#_about_multi_data_center_setups" class="xref page">limitation of multi-DC setups for James</a>
-Not specifying this value results in the driver’s default load balancing policy to be used.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">optimistic.consistency.level.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Allows specifying consistency level ONE for reads in Cassandra BlobStore.
-Falls back to default read consistency level if the blob is missing. Defaults to false.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_cassandra_mailbox_configuration"><a class="anchor" href="#_cassandra_mailbox_configuration"></a>Cassandra Mailbox Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p><strong>cassandra.properties</strong> file furthermore expose some options to tune the Cassandra Mailbox behaviour.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 2. cassandra.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailbox.read.repair.chance</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 0.1 (10% chance).
-Must be between 0 and 1 (inclusive). Controls the probability of doing a read-repair upon mailbox read.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailbox.read.repair.chance</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 0.1 (10% chance).
-Must be between 0 and 1 (inclusive). Controls the probability of doing a read-repair upon mailbox read.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailbox.counters.read.repair.chance.max</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 0.1 (10% chance).
-Must be between 0 and 1 (inclusive). Controls the probability of doing a read-repair upon mailbox counters read.
-Formula: read_repair_chance = min(mailbox.counters.read.repair.chance.max, (100/unseens)*mailbox.counters.read.repair.chance.one.hundred)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailbox.counters.read.repair.chance.one.hundred</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 0.01 (1% chance).
-Must be between 0 and 1 (inclusive). Controls the probability of doing a read-repair upon mailbox counters read.
-Formula: read_repair_chance = min(mailbox.counters.read.repair.chance.max, (100/unseens)*mailbox.counters.read.repair.chance.one.hundred)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailbox.max.retry.acl</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 1000.
-Controls the number of retries upon Cassandra ACL updates.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailbox.max.retry.modseq</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 100000.
-Controls the number of retries upon Cassandra ModSeq generation.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailbox.max.retry.uid</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 100000.
-Controls the number of retries upon Cassandra Uid generation.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailbox.max.retry.message.flags.update</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 1000.
-Controls the number of retries upon Cassandra flags update, in MessageMapper.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailbox.max.retry.message.id.flags.update</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 1000.
-Controls the number of retries upon Cassandra flags update, in MessageIdMapper.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">chunk.size.message.read</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 100.
-Controls the number of messages to be retrieved in parallel.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailbox.blob.part.size</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 102400 (100KB).
-Controls the size of blob parts used to store messages in the Cassandra blobStore.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailbox.read.strong.consistency</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Boolean, defaults to true. Disabling should be considered experimental.
-If enabled, regular consistency level is used for read transactions for mailbox. Not doing so might result
-in stale reads as the system.paxos table will not be checked for latest updates. Better performance are expected
-by turning it off. Note that reads performed as part of write transactions are always performed with a strong
-consistency.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">uid.read.strong.consistency.unsafe</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Boolean, defaults to true. Disabling should be considered experimental.
-If enabled, regular consistency level is used for read transactions for uid upon read oepration (eg IMAP status, select).
-Not doing so might result in stale reads as the system.paxos table will not be checked for latest updates.
-Better performance are expected by turning it off.
-Note that reads performed as part of write transactions are always performed with a strong consistency.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">modseq.read.strong.consistency.unsafe</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Boolean, defaults to true. Disabling should be considered experimental.
-If enabled, regular consistency level is used for read transactions for modseq upon read operation (eg IMAP status, select).
-Not doing so might result in stale reads as the system.paxos table will not be checked for latest updates.
-Better performance are expected by turning it off.
-Note that reads performed as part of write transactions are always performed with a strong consistency.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">message.read.strong.consistency</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Boolean, defaults to true. Disabling should be considered experimental.
-If enabled, regular consistency level is used for read transactions for message. Not doing so might result
-in stale reads as the system.paxos table will not be checked for latest updates. Better performance are expected
-by turning it off. Note that reads performed as part of write transactions are always performed with a strong
-consistency.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">message.write.strong.consistency.unsafe</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Boolean, defaults to true. Disabling should be considered experimental and unsafe.
-If disabled, Lightweight transactions will no longer be used upon messages operation (table <code>imapUidTable</code>).
-As message flags updates relies so far on a read-before-write model, it exposes yourself to data races leading to
-potentially update loss. Better performance are expected
-by turning it off. Reads performed as part of write transaction are also performed with a relaxed consistency.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailrepository.strong.consistency</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Boolean, defaults to true. Allows not to use lightweight transactions in CassandraMailRepository.
- If disabled we implement an idempotent behaviour (duplicates are overridden, missing entries upon deletes are ignored).</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">acl.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Boolean, defaults to true. Allows disabling ACLs: if set to false, delegation will fail and users will only
-have access to the mailboxes they own. ACLs can represent a high volume of requests. If you do not propose mailbox sharing
-features to your users, you can consider disabling them in order to improve performance.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">email.change.ttl</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Duration, default to 60 days. Cassandra Time-to-live for Email change records. Setting time-to-live to zero means refusing to use time-to-live on email changes.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailbox.change.ttl</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Duration, default to 60 days. Cassandra Time-to-live for Mailbox change records. Setting time-to-live to zero means refusing to use time-to-live on mailbox changes.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">uid.modseq.increment</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional, default to 0. Defensive value to add to uids and modseqs generated. This can be used as an heuristic to maintain
-consistency even when consensus of Lightweight Transactions is broken, exemple during a disaster recovery process.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/configure/collecting-contacts.html b/james-distributed-app/3.8.1/configure/collecting-contacts.html
deleted file mode 100644
index 022a4bd..0000000
--- a/james-distributed-app/3.8.1/configure/collecting-contacts.html
+++ /dev/null
@@ -1,455 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Contact collection :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Extensions</li>
- <li><a href="collecting-contacts.html">Contact collection</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/collecting-contacts.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Contact collection</h1>
-<div class="sect1">
-<h2 id="_motivation"><a class="anchor" href="#_motivation"></a>Motivation</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Many modern applications combines email and contacts.</p>
-</div>
-<div class="paragraph">
-<p>We want recipients of emails sent by a user to automatically be added to this user contacts, for convenience. This
-should even be performed when a user sends emails via SMTP for example using thunderbird.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_design"><a class="anchor" href="#_design"></a>Design</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The idea is to send AMQP messages holding information about mail envelope for a traitment via a tierce application.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_configuration"><a class="anchor" href="#_configuration"></a>Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>We can achieve this goal by combining simple mailets building blocks.</p>
-</div>
-<div class="paragraph">
-<p>Here is a sample pipeline achieving aforementioned objectives :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="SenderIsLocal" class="ContactExtractor">
- <attribute>extractedContacts</attribute>
-</mailet>
-<mailet match="All" class="AmqpForwardAttribute">
- <uri>amqp://${env:JAMES_AMQP_USERNAME}:${env:JAMES_AMQP_PASSWORD}@${env:JAMES_AMQP_HOST}:${env:JAMES_AMQP_PORT}</uri>
- <exchange>collector:email</exchange>
- <attribute>extractedContacts</attribute>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>A sample message looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "userEmail": "sender@james.org",
- "emails": ["to@james.org"]
-}</pre>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/configure/collecting-events.html b/james-distributed-app/3.8.1/configure/collecting-events.html
deleted file mode 100644
index a29ab89..0000000
--- a/james-distributed-app/3.8.1/configure/collecting-events.html
+++ /dev/null
@@ -1,489 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Event collection :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Extensions</li>
- <li><a href="collecting-events.html">Event collection</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/collecting-events.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Event collection</h1>
-<div class="sect1">
-<h2 id="_motivation"><a class="anchor" href="#_motivation"></a>Motivation</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Many calendar application do add events invitation received by email directly in ones calendar.</p>
-</div>
-<div class="paragraph">
-<p>Such behaviours requires the calendar application to be aware of the ICalendar related emails a user received.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_design"><a class="anchor" href="#_design"></a>Design</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The idea is to write a portion of mailet pipeline extracting Icalendar attachments and to hold them as attachments that
-can later be sent to other applications over AMQP to be treated in an asynchronous, decoupled fashion.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_configuration"><a class="anchor" href="#_configuration"></a>Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>We can achieve this goal by combining simple mailets building blocks.</p>
-</div>
-<div class="paragraph">
-<p>Here is a sample pipeline achieving aforementioned objectives :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><!-- ICAL pipeline -->
-<mailet match="All" class="StripAttachment">
- <mimeType>text/calendar</mimeType>
- <attribute>rawIcalendar</attribute>
-</mailet>
-<mailet match="All" class="MimeDecodingMailet">
- <attribute>rawIcalendar</attribute>
-</mailet>
-<mailet match="All" class="ICalendarParser">
- <sourceAttribute>rawIcalendar</sourceAttribute>
- <destinationAttribute>icalendar</destinationAttribute>
-</mailet>
-<mailet match="All" class="ICALToHeader">
- <attribute>icalendar</attribute>
-</mailet>
-<mailet match="All" class="ICALToJsonAttribute">
- <source>icalendar</source>
- <destination>icalendarAsJson</destination>
- <rawSource>rawIcalendar</rawSource>
-</mailet>
-<mailet match="All" class="AmqpForwardAttribute">
- <uri>amqp://${env:JAMES_AMQP_USERNAME}:${env:JAMES_AMQP_PASSWORD}@${env:JAMES_AMQP_HOST}:${env:JAMES_AMQP_PORT}</uri>
- <exchange>james:events</exchange>
- <attribute>icalendarAsJson</attribute>
-</mailet>
-<!-- End of ICAL pipeline --></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>A sample message looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "ical": "RAW_DATA_AS_TEXT_FOLLOWING_ICS_FORMAT",
- "sender": "other@james.apache.org",
- "recipient": "any@james2.apache.org",
- "replyTo": "other@james.apache.org",
- "uid": "f1514f44bf39311568d640727cff54e819573448d09d2e5677987ff29caa01a9e047feb2aab16e43439a608f28671ab7c10e754ce92be513f8e04ae9ff15e65a9819cf285a6962bc",
- "dtstamp": "20170106T115036Z",
- "method": "REQUEST",
- "sequence": "0",
- "recurrence-id": null
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The following pipeline positions the X-MEETING-UID in the Header in order for mail user agent to correlate events with this mail.
-The sample look like:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">X-MEETING-UID: f1514f44bf39311568d640727cff54e819573448d09d2e5677987ff29caa01a9e047feb2aab16e43439a608f28671ab7c10e754ce92be513f8e04ae9ff15e65a9819cf285a6962bc</code></pre>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/configure/dns.html b/james-distributed-app/3.8.1/configure/dns.html
deleted file mode 100644
index 054842b..0000000
--- a/james-distributed-app/3.8.1/configure/dns.html
+++ /dev/null
@@ -1,475 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — dnsservice.xml :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Core components</li>
- <li><a href="dns.html">dnsservice.xml</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/dns.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — dnsservice.xml</h1>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/dnsservice.xml">example</a>
-to get some examples and hints.</p>
-</div>
-<div class="paragraph">
-<p>Specifies DNS Server information for use by various components inside Apache James Server.</p>
-</div>
-<div class="paragraph">
-<p>DNS Transport services are controlled by a configuration block in
-the dnsservice.xml. This block affects SMTP remote delivery.</p>
-</div>
-<div class="paragraph">
-<p>The dnsservice tag defines the boundaries of the configuration
-block. It encloses all the relevant configuration for the DNS server.
-The behavior of the DNS service is controlled by the attributes and
-children of this tag.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. dnsservice.xml content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">servers</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Information includes a list of DNS Servers to be used by James. These are
-specified by the server elements, each of which is a child element of the
-servers element. Each server element is the IP address of a single DNS server.
-The server elements can have multiple server children. Enter ip address of your DNS server, one IP address per server
-element. If no DNS servers are found and you have not specified any below, 127.0.0.1 will be used</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">autodiscover</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false - If you use autodiscover and add DNS servers manually a combination of all the DNS servers will be used.
-If autodiscover is true, James will attempt to autodiscover the DNS servers configured on your underlying system.
-Currently, this works if the OS has a unix-like /etc/resolv.xml,
-or the system is Windows based with ipconfig or winipcfg. Change autodiscover to false if you would like to turn off autodiscovery
-and set the DNS servers manually in the servers section</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">authoritative</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>true/false</strong> - This tag specifies whether or not
-to require authoritative (non-cached) DNS records; to only accept DNS responses that are
-authoritative for the domain. It is primarily useful in an intranet/extranet environment.
-This should always be <strong>false</strong> unless you understand the implications.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">maxcachesize</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Maximum number of entries to maintain in the DNS cache (typically 50000)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">negativeCacheTTL</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Sets the maximum length of time that negative records will be stored in the DNS negative cache in
-seconds (a negative record means the name has not been found in the DNS). Values for this cache
-can be positive meaning the time in seconds before retrying to resolve the name, zero meaning no
-cache or a negative value meaning infinite caching.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">singleIPperMX</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false (default) - Specifies if Apache James Server must try a single server for each multihomed mx host</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">verbose</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Turn on general debugging statements</p></td>
-</tr>
-</tbody>
-</table>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/configure/domainlist.html b/james-distributed-app/3.8.1/configure/domainlist.html
deleted file mode 100644
index 2ab2fc0..0000000
--- a/james-distributed-app/3.8.1/configure/domainlist.html
+++ /dev/null
@@ -1,461 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — domainlist.xml :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Core components</li>
- <li><a href="domainlist.html">domainlist.xml</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/domainlist.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — domainlist.xml</h1>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/domainlist.xml">example</a>
-to get some examples and hints.</p>
-</div>
-<div class="paragraph">
-<p>This configuration block is defined by the <strong>domainlist</strong> tag.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. domainlist.xml content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">domainnames</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Domainnames identifies the DNS namespace served by this instance of James.
-These domainnames are used for both matcher/mailet processing and SMTP auth
-to determine when a mail is intended for local delivery - Only applicable for XMLDomainList. The entries mentionned here will be created upon start.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">autodetect</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false - If autodetect is true, James wil attempt to discover its own host name AND
-use any explicitly specified servernames.
-If autodetect is false, James will use only the specified domainnames. Defaults to false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">autodetectIP</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false - If autodetectIP is not false, James will also allow add the IP address for each servername.
-The automatic IP detection is to support RFC 2821, Sec 4.1.3, address literals. Defaults to false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">defaultDomain</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the default domain which will be used if an email is send to a recipient without a domain part.
-If no defaultdomain is set the first domain of the DomainList gets used. If the default is not yet contained by the Domain List, the domain will be created upon start.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">read.cache.enable</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Experimental. Boolean, defaults to false.
-Whether or not to cache domainlist.contains calls. Enable a faster execution however writes will take time
-to propagate.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">read.cache.expiracy</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Experimental. String (duration), defaults to 10 seconds (10s). Supported units are ms, s, m, h, d, w, month, y.
-Expiracy of the cache. Longer means less reads are performed to the backend but writes will take longer to propagate.
-Low values (a few seconds) are advised.</p></td>
-</tr>
-</tbody>
-</table>
-<div class="paragraph">
-<p>To override autodetected domainnames simply add explicit domainname elements.
-In most cases this will be necessary. By default, the domainname 'localhost' is specified. This can be removed, if required.</p>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/configure/dsn.html b/james-distributed-app/3.8.1/configure/dsn.html
deleted file mode 100644
index 03df09e..0000000
--- a/james-distributed-app/3.8.1/configure/dsn.html
+++ /dev/null
@@ -1,663 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Delivery Submission Notifications :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Extensions</li>
- <li><a href="dsn.html">ESMTP DSN support</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/dsn.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Delivery Submission Notifications</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>DSN introduced in <a href="https://tools.ietf.org/html/rfc3461">RFC-3461</a> allows a SMTP sender to demand status messages,
-defined in <a href="https://tools.ietf.org/html/rfc3464">RFC-3464</a> to be sent back to the <code>Return-Path</code> upon delivery
-progress.</p>
-</div>
-<div class="paragraph">
-<p>DSN support is not enabled by default, as it needs specific configuration of the
-<a href="mailetcontainer.html" class="xref page">mailetcontainer.xml</a> to be specification compliant.</p>
-</div>
-<div class="paragraph">
-<p>To enable it you need to:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Add DSN SMTP hooks as part of the SMTP server stack</p>
-</li>
-<li>
-<p>Configure <a href="mailetcontainer.html" class="xref page">mailetcontainer.xml</a> to generate DSN bounces when needed</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_enabling_dsn_in_smtp_server_stack"><a class="anchor" href="#_enabling_dsn_in_smtp_server_stack"></a>Enabling DSN in SMTP server stack</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>For this simply add the <code>DSN hooks</code> in the handler chain in <code>smtpserver.xml</code> :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><smtpserver enabled="true">
- <...> <!-- The rest of your SMTP configuration, unchanged -->
- <handlerchain>
- <handler class="org.apache.james.smtpserver.dsn.DSNEhloHook"/>
- <handler class="org.apache.james.smtpserver.dsn.DSNMailParameterHook"/>
- <handler class="org.apache.james.smtpserver.dsn.DSNRcptParameterHook"/>
- <handler class="org.apache.james.smtpserver.dsn.DSNMessageHook"/>
- <...> <!-- other handlers, like: -->
- <handler class="org.apache.james.smtpserver.CoreCmdHandlerLoader"/> <!-- for instance -->
- </handlerchain>
-</smtpserver></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_enabling_dsn_generation_as_part_of_mail_processing"><a class="anchor" href="#_enabling_dsn_generation_as_part_of_mail_processing"></a>Enabling DSN generation as part of mail processing</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>For the below conditions to be matched we assume you follow
-<a href="remote-delivery-error-handling.html" class="xref page">RemoteDelivery error handling for MXs</a>, which is a
-requirement for detailed RemoteDelivery error and delay handling on top of the Distributed server.</p>
-</div>
-<div class="paragraph">
-<p>Here is a sample <a href="mailetcontainer.html" class="xref page">mailetcontainer.xml</a> achieving the following DSN generation:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Generate a generic <code>delivered</code> notification if LocalDelivery succeeded, if requested</p>
-</li>
-<li>
-<p>Generate a generic <code>failed</code> notification in case of local errors, if requested</p>
-</li>
-<li>
-<p>Generate a specific <code>failed</code> notification in case of a non existing local user, if requested</p>
-</li>
-<li>
-<p>Generate a specific <code>failed</code> notification in case of an address rewriting loop, if requested</p>
-</li>
-<li>
-<p>Generate a <code>failed</code> notification in case of remote permanent errors, if requested. We blame the remote server…​</p>
-</li>
-<li>
-<p>Generate a <code>delayed</code> notification in case of temporary remote errors we are about to retry, if requested. We blame the remote server…​</p>
-</li>
-<li>
-<p>Generate a <code>failed</code> notification in case of temporary remote errors we are not going to retry (failed too many time), if requested. We blame the remote server…​</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailetcontainer enableJmx="true">
- <!-- Common processing settings are unchanged -->
-
- <processors>
- <processor state="root" enableJmx="true">\
- <!-- Content of root processor is unchanged -->
- </processor>
-
- <processor state="transport" enableJmx="true">
- <!-- transport processor unchanged -->
- </processor>
-
- <processor state="error" enableJmx="true">
- <mailet match="DSNFailureRequested" class="DSNBounce">
- <prefix>[FAILED]</prefix>
- <passThrough>true</passThrough>
- <messageString>Hi. This is the James mail server at [machine].
-I'm afraid I wasn't able to deliver your message to the following addresses.
-This is a permanent error; I've given up. Sorry it didn't work out. Below
-I include the list of recipients, and the reason why I was unable to deliver
-your message.</messageString>
- <action>failed</action>
- <defaultStatus>5.0.0</defaultStatus>
- </mailet>
- <mailet match="All" class="ToRepository">
- <repositoryPath>cassandra://var/mail/error/</repositoryPath>
- </mailet>
- </processor>
-
- <processor state="local-delivery" enableJmx="true">
- <!-- Your local-delivery pipeline -->
- <mailet match="All" class="LocalDelivery">
- <!-- Do not abort the pipeline yet -->
- <consume>false</consume>
- </mailet>
- <!-- Tell the world we succeeded -->
- <mailet match="DSNSuccessRequested" class="DSNBounce">
- <prefix>[SUCCESS]</prefix>
- <passThrough>true</passThrough>
- <messageString>Hi. This is the James mail server at [machine].
-I successfully delivered your message to the following addresses.
-Note that it indicates your recipients received the message but do
-not imply they read it.</messageString>
- <action>delivered</action>
- <defaultStatus>2.0.0</defaultStatus>
- </mailet>
- <mailet match="All" class="Null"/> <!-- ignore people not having requesting a dsn success bounce -->
- </processor>
-
- <processor state="relay" enableJmx="true">
- <!-- Perform at most 5 RemoteDelivery attempts -->
- <mailet match="AtMost=5" class="RemoteDelivery">
- <outgoingQueue>outgoing</outgoingQueue>
- <maxRetries>0</maxRetries>
- <maxDnsProblemRetries>0</maxDnsProblemRetries>
- <deliveryThreads>10</deliveryThreads>
- <sendpartial>true</sendpartial>
- <!-- Use a custom processor for error handling -->
- <bounceProcessor>remote-delivery-error</bounceProcessor>
- </mailet>
- <!-- When retries are exceeded, consider the mail as a permanent failure -->
- <mailet match="DSNFailureRequested" class="DSNBounce">
- <prefix>[FAILED]</prefix>
- <passThrough>true</passThrough>
- <messageString>Hi. This is the James mail server at [machine].
-I'm afraid I wasn't able to deliver your message to the following addresses.
-This is a permanent error; I've given up. Sorry it didn't work out.
-The remote server we should relay this mail to keep on failing.
-Below I include the list of recipients, and the reason why I was unable to deliver
-your message.</messageString>
- <action>failed</action>
- <defaultStatus>5.0.0</defaultStatus>
- </mailet>
- <mailet match="All" class="ToRepository">
- <repositoryPath>cassandra://var/mail/error/remote-delivery/permanent/</repositoryPath>
- </mailet>
- </processor>
-
- <processor state="remote-delivery-error" enableJmx="true">
- <matcher name="dsn-permanent" match="org.apache.james.mailetcontainer.impl.matchers.And">
- <matcher match="IsRemoteDeliveryPermanentError"/>
- <matcher match="DSNFailureRequested"/>
- </matcher>
- <matcher name="dsn-temporary" match="org.apache.james.mailetcontainer.impl.matchers.And">
- <matcher match="IsRemoteDeliveryTemporaryError"/>
- <matcher match="DSNDelayRequested"/>
- </matcher>
-
- <mailet match="dsn-permanent" class="DSNBounce">
- <prefix>[FAILED]</prefix>
- <passThrough>true</passThrough>
- <messageString>Hi. This is the James mail server at [machine].
-I'm afraid I wasn't able to deliver your message to the following addresses.
-This is a permanent error; I've given up. Sorry it didn't work out.
-The remote server we should relay this mail to returns a permanent error.
-Below I include the list of recipients, and the reason why I was unable to deliver
-your message.</messageString>
- <action>failed</action>
- <defaultStatus>5.0.0</defaultStatus>
- </mailet>
-
- <mailet match="dsn-temporary" class="DSNBounce">
- <prefix>[DELAYED]</prefix>
- <passThrough>true</passThrough>
- <messageString>Hi. This is the James mail server at [machine].
-I'm afraid I wasn't able to deliver your message to the following addresses yet.
-This is a temporary error: I will keep on trying.
-Below I include the list of recipients, and the reason why I was unable to deliver
-your message.</messageString>
- <action>delayed</action>
- <defaultStatus>4.0.0</defaultStatus>
- </mailet>
-
- <!-- Error management for remote delivery error handling as described in remote-delivery-error-handling.adoc -->
- </processor>
-
- <processor state="local-address-error" enableJmx="true">
- <mailet match="DSNFailureRequested" class="DSNBounce">
- <prefix>[FAILED]</prefix>
- <passThrough>true</passThrough>
- <messageString>Hi. This is the James mail server at [machine].
-I'm afraid I wasn't able to deliver your message to the following addresses.
-This is a permanent error; I've given up. Sorry it didn't work out.
-The following addresses do not exist here. Sorry.</messageString>
- <action>failed</action>
- <defaultStatus>5.0.0</defaultStatus>
- </mailet>
- <mailet match="All" class="ToRepository">
- <repositoryPath>cassandra://var/mail/address-error/</repositoryPath>
- </mailet>
- </processor>
-
- <processor state="relay-denied" enableJmx="true">
- <!-- This is an abuse, you likely do not want to be polite with these people. we just keep a copy for later audit & replay -->
- <mailet match="All" class="ToRepository">
- <repositoryPath>cassandra://var/mail/relay-denied/</repositoryPath>
- <notice>Warning: You are sending an e-mail to a remote server. You must be authenticated to perform such an operation</notice>
- </mailet>
- </processor>
-
- <processor state="rrt-error" enableJmx="false">
- <mailet match="All" class="ToRepository">
- <repositoryPath>cassandra://var/mail/rrt-error/</repositoryPath>
- <passThrough>true</passThrough>
- </mailet>
- <mailet match="IsSenderInRRTLoop" class="Null"/>
- <mailet match="DSNFailureRequested" class="DSNBounce">
- <prefix>[FAILED]</prefix>
- <passThrough>true</passThrough>
- <messageString>Hi. This is the James mail server at [machine].
-I'm afraid I wasn't able to deliver your message to the following addresses.
-This is a permanent error; I've given up. Sorry it didn't work out.
-The following addresses is caught in a rewriting loop. An admin should come and fix it (you likely want to report it).
-Once resolved the admin should be able to resume the processing of your email.
-Below I include the list of recipients, and the reason why I was unable to deliver
-your message.</messageString>
- <action>failed</action>
- <defaultStatus>5.1.6/defaultStatus>
- </mailet>
- </processor>
- </processors>
-</mailetcontainer></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_limitations"><a class="anchor" href="#_limitations"></a>Limitations</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The out of the box tooling do not allow generating <code>relayed</code> DSN notification as RemoteDelivery misses a success
-callback.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/configure/extensions.html b/james-distributed-app/3.8.1/configure/extensions.html
deleted file mode 100644
index 4a8f24b..0000000
--- a/james-distributed-app/3.8.1/configure/extensions.html
+++ /dev/null
@@ -1,473 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — extensions.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Extensions</li>
- <li><a href="extensions.html">extensions.properties</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/extensions.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — extensions.properties</h1>
-<div class="paragraph">
-<p>This files enables an operator to define additional bindings used to instantiate others extensions</p>
-</div>
-<div class="paragraph">
-<p><strong>guice.extension.module</strong>: come separated list of fully qualified class name. These classes need to implement Guice modules.</p>
-</div>
-<div class="paragraph">
-<p>Here is an example of such a class :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>public class MyServiceModule extends AbstractModule {
- @Override
- protected void configure() {
- bind(MyServiceImpl.class).in(Scopes.SINGLETON);
- bind(MyService.class).to(MyServiceImpl.class);
- }
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Recording it in extensions.properties :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>guice.extension.module=com.project.MyServiceModule</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Enables to inject MyService into your extensions.</p>
-</div>
-<div class="paragraph">
-<p><strong>guice.extension.tasks</strong>: come separated list of fully qualified class name.</p>
-</div>
-<div class="paragraph">
-<p>The extension can rely on the Task manager to supervise long-running task execution (progress, await, cancellation, scheduling…​).
-These extensions need to implement Task extension modules.</p>
-</div>
-<div class="paragraph">
-<p>Here is an example of such a class :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>public class RspamdTaskExtensionModule implements TaskExtensionModule {
-
- @Inject
- public RspamdTaskExtensionModule() {
- }
-
- @Override
- public Set<TaskDTOModule<? extends Task, ? extends TaskDTO>> taskDTOModules() {
- return Set.of(...);
- }
-
- @Override
- public Set<AdditionalInformationDTOModule<? extends TaskExecutionDetails.AdditionalInformation, ? extends AdditionalInformationDTO>> taskAdditionalInformationDTOModules() {
- return Set.of(...);
- }
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Recording it in extensions.properties :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>guice.extension.tasks=com.project.RspamdTaskExtensionModule</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Read <a href="../extending/index.html#_defining_custom_injections_for_your_extensions" class="xref page">this page</a> for more details.</p>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/configure/healthcheck.html b/james-distributed-app/3.8.1/configure/healthcheck.html
deleted file mode 100644
index 6f010b7..0000000
--- a/james-distributed-app/3.8.1/configure/healthcheck.html
+++ /dev/null
@@ -1,440 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — healthcheck.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Core components</li>
- <li><a href="healthcheck.html">healthcheck.properties</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/healthcheck.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — healthcheck.properties</h1>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/healthcheck.properties">example</a>
-to get some examples and hints.</p>
-</div>
-<div class="paragraph">
-<p>Use this configuration to define the initial delay and period for the PeriodicalHealthChecks. It is only applicable with Guice products.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. healthcheck.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">healthcheck.period</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Define the period between two periodical health checks (default: 60s). Units supported are (ms - millisecond, s - second, m - minute, h - hour, d - day). Default unit is millisecond.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">reception.check.user</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">User to be using for running the "mail reception" health check. The user must exist.
-If not specified, the mail reception check is a noop.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">reception.check.timeout</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Period after which mail reception is considered faulty. Defaults to one minute.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">additional.healthchecks</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">List of fully qualified HealthCheck class names in addition to James' default healthchecks. Default to empty list.</p></td>
-</tr>
-</tbody>
-</table>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/configure/imap.html b/james-distributed-app/3.8.1/configure/imap.html
deleted file mode 100644
index 4bff820..0000000
--- a/james-distributed-app/3.8.1/configure/imap.html
+++ /dev/null
@@ -1,663 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — imapserver.xml :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Protocols</li>
- <li><a href="imap.html">imapserver.xml</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/imap.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — imapserver.xml</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/imapserver.xml">example</a>
-to get some examples and hints.</p>
-</div>
-<div class="paragraph">
-<p>The IMAP4 service is controlled by a configuration block in the imap4server.xml.
-The imap4server tag defines the boundaries of the configuration block. It encloses
-all the relevant configuration for the IMAP4 server. The behavior of the IMAP4 service is
-controlled by the attributes and children of this tag.</p>
-</div>
-<div class="paragraph">
-<p>This tag has an optional boolean attribute - <strong>enabled</strong> - that defines whether the service is active or not.
-The value defaults to "true" if not present.</p>
-</div>
-<div class="paragraph">
-<p>The standard children of the imapserver tag are:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. imapserver.xml content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">bind</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure this to bind to a specific inetaddress. This is an optional integer value. This value is the port on which this IMAP4 server is configured
-to listen. If the tag or value is absent then the service
-will bind to all network interfaces for the machine If the tag or value is omitted, the value will default to the standard IMAP4 port
-port 143 is the well-known/IANA registered port for IMAP
-port 993 is the well-known/IANA registered port for IMAPS ie over SSL/TLS</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connectionBacklog</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Number of connection backlog of the server (maximum number of queued connection requests)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">compress</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false - Use or don’t use COMPRESS extension. Defaults to false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">maxLineLength</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Maximal allowed line-length before a BAD response will get returned to the client
-This should be set with caution as a to high value can make the server a target for DOS (Denial of Service)!</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">inMemorySizeLimit</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Size limit before we will start to stream to a temporary file.
-Defaults to 10MB. Must be a positive integer, optionally with a unit: B, K, M, G.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">literalSizeLimit</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Maximum size of a literal (IMAP APPEND).
-Defaults to 0 (unlimited). Must be a positive integer, optionally with a unit: B, K, M, G.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">plainAuthDisallowed</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated. Should use <code>auth.plainAuthEnabled</code>, <code>auth.requireSSL</code> instead.
-Whether to enable Authentication PLAIN if the connection is not encrypted via SSL or STARTTLS. Defaults to <code>true</code>.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">auth.plainAuthEnabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Whether to enable Authentication PLAIN/ LOGIN command. Defaults to <code>true</code>.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">auth.requireSSL</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false. Defaults to <code>true</code>. Whether to require SSL to authenticate. If this is required, the IMAP server will disable authentication on unencrypted channels.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">auth.oidc.oidcConfigurationURL</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Provide OIDC url address for information to user. Only configure this when you want to authenticate IMAP server using a OIDC provider.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">auth.oidc.jwksURL</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Provide url to get OIDC’s JSON Web Key Set to validate user token. Only configure this when you want to authenticate IMAP server using a OIDC provider.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">auth.oidc.claim</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Claim string uses to identify user. E.g: "email_address". Only configure this when you want to authenticate IMAP server using a OIDC provider.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">auth.oidc.scope</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">An OAuth scope that is valid to access the service (RF: RFC7628). Only configure this when you want to authenticate IMAP server using a OIDC provider.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">timeout</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Default to 30 minutes. After this time, inactive channels that have not performed read, write, or both operation for a while
-will be closed. Negative value disable this behaviour.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">enableIdle</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Default to true. If enabled IDLE commands will generate a server heartbeat on a regular period.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">idleTimeInterval</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Defaults to 120. Needs to be a strictly positive integer.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">idleTimeIntervalUnit</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Default to SECONDS. Needs to be a parseable TimeUnit.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">disabledCaps</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Implemented server capabilities NOT to advertise to the client. Coma separated list. Defaults to no disabled capabilities.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jmxName</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The name given to the configuration</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tls</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set to true to support STARTTLS or SSL for the Socket.
-To use this you need to copy sunjce_provider.jar to /path/james/lib directory. To create a new keystore execute:
-<code>keytool -genkey -alias james -keyalg RSA -storetype PKCS12 -keystore /path/to/james/conf/keystore</code>.
-Please note that each IMAP server exposed on different port can specify its own keystore, independently from any other
-TLS based protocols.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">handler.helloName</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">This is the name used by the server to identify itself in the IMAP4
-protocol. If autodetect is TRUE, the server will discover its
-own host name and use that in the protocol. If discovery fails,
-the value of 'localhost' is used. If autodetect is FALSE, James
-will use the specified value.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connectiontimeout</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Connection timeout in seconds</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connectionLimit</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum simultaneous incoming connections for this service</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connectionLimitPerIP</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum simultaneous incoming connections per IP for this service</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">concurrentRequests</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Maximum number of IMAP requests executed simultaneously. Past that limit requests are queued. Defaults to 20.
-Negative values deactivate this feature, leading to unbounded concurrency.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">maxQueueSize</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Upper bound to the IMAP throttler queue. Upon burst, requests that cannot be queued are rejected and not executed.
-Integer, defaults to 4096, must be positive, 0 means no queue.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">proxyRequired</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Enables proxy support for this service for incoming connections. HAProxy’s protocol
-(<a href="https://www.haproxy.org/download/2.7/doc/proxy-protocol.txt" class="bare">https://www.haproxy.org/download/2.7/doc/proxy-protocol.txt</a>) is used and might be compatible
-with other proxies (e.g. traefik). If enabled, it is <strong>required</strong> to initiate the connection
-using HAProxy’s proxy protocol.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">bossWorkerCount</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum count of boss threads. Boss threads are responsible for accepting incoming IMAP connections
-and initializing associated resources. Optional integer, by default, boss threads are not used and this responsibility is being dealt with
-by IO threads.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ioWorkerCount</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum count of IO threads. IO threads are responsible for receiving incoming IMAP messages and framing them
-(split line by line). IO threads also take care of compression and SSL encryption. Their tasks are short-lived and non-blocking.
-Optional integer, defaults to 2 times the count of CPUs.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ignoreIDLEUponProcessing</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false - Allow disabling the heartbeat handler. Defaults to true.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">useEpoll</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false - If true uses native EPOLL implementation for Netty otherwise uses NIO. Defaults to false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">gracefulShutdown</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false - If true attempts a graceful shutdown, which is safer but can take time. Defaults to true.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">highWriteBufferWaterMark</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Netty’s write buffer high watermark configuration. Unit supported: none, K, M. Netty defaults applied.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">lowWriteBufferWaterMark</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Netty’s write buffer low watermark configuration. Unit supported: none, K, M. Netty defaults applied.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_oidc_setup"><a class="anchor" href="#_oidc_setup"></a>OIDC setup</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>James IMAP support XOAUTH2 authentication mechanism which allow authenticating against a OIDC providers.
-Please configure <code>auth.oidc</code> part to use this.</p>
-</div>
-<div class="paragraph">
-<p>We do supply an <a href="https://github.com/apache/james-project/tree/master/examples/oidc">example</a> of such a setup.
-It uses the Keycloak OIDC provider, but usage of similar technologies is definitely doable.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_extending_imap"><a class="anchor" href="#_extending_imap"></a>Extending IMAP</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>IMAP decoders, processors and encoder can be customized. <a href="../extending/imap.html" class="xref page">Read more</a>.</p>
-</div>
-<div class="paragraph">
-<p>Check this <a href="https://github.com/apache/james-project/tree/master/examples/custom-imap">example</a>.</p>
-</div>
-<div class="paragraph">
-<p>The following configuration properties are available for extensions:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 2. imapserver.xml content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">imapPackages</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure (union) of IMAP packages. IMAP packages bundles decoders (parsing IMAP commands) processors and encoders,
-thus enable implementing new IMAP commands or replace existing IMAP processors. List of FQDNs, which can be located in
-James extensions.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">additionalConnectionChecks</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure (union) of additional connection checks. ConnectionCheck will check if the connection IP is secure or not.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">customProperties</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Properties for custom extension. Each tag is a property entry, and holds a string under the form key=value.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_mail_user_agents_auto_configuration"><a class="anchor" href="#_mail_user_agents_auto_configuration"></a>Mail user agents auto-configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Check this example on <a href="https://github.com/apache/james-project/tree/master/examples/imap-autoconf">Mail user agents auto-configuration</a>.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/configure/index.html b/james-distributed-app/3.8.1/configure/index.html
deleted file mode 100644
index 561dfd6..0000000
--- a/james-distributed-app/3.8.1/configure/index.html
+++ /dev/null
@@ -1,624 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Configuration :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item is-current-page" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/index.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Configuration</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This section presents how to configure the Distributed server.</p>
-</div>
-<div class="paragraph">
-<p>The Distributed Server relies on separated files for configuring various components. Some files follow a <strong>xml</strong> format
-and some others follow a <strong>property</strong> format. Some files can be omitted, in which case the functionality can be disabled,
-or rely on reasonable defaults.</p>
-</div>
-<div class="paragraph">
-<p>The following configuration files are exposed:</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_for_protocols"><a class="anchor" href="#_for_protocols"></a>For protocols</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>By omitting these files, the underlying protocols will be disabled.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="imap.html" class="xref page"><strong>imapserver.xml</strong></a> allows configuration for the IMAP protocol <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/imapserver.xml">example</a></p>
-</li>
-<li>
-<p><a href="jmap.html" class="xref page"><strong>jmap.properties</strong></a> allows to configure the JMAP protocol <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/jmap.properties">example</a></p>
-</li>
-<li>
-<p><a href="jmx.html" class="xref page"><strong>jmx.properties</strong></a> allows configuration of JMX being used by the Command Line Interface <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/jmx.properties">example</a></p>
-</li>
-<li>
-<p><a href="smtp.html#_lmtp_configuration" class="xref page"><strong>lmtpserver.xml</strong></a> allows configuring the LMTP protocol <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/lmtpserver.xml">example</a></p>
-</li>
-<li>
-<p><strong>managesieveserver.xml</strong> allows configuration for ManagedSieve (unsupported) <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/managesieveserver.xml">example</a></p>
-</li>
-<li>
-<p><a href="pop3.html" class="xref page"><strong>pop3server.xml</strong></a> allows configuration for the POP3 protocol (experimental) <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/pop3server.xml">example</a></p>
-</li>
-<li>
-<p><a href="smtp.html" class="xref page"><strong>smtpserver.xml</strong></a> allows configuration for the SMTP protocol <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/smtpserver.xml">example</a></p>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="smtp-hooks.html" class="xref page">This page</a> list SMTP hooks that can be used out of the box with the Distributed Server.</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p><a href="webadmin.html" class="xref page"><strong>webadmin.properties</strong></a> enables configuration for the WebAdmin protocol <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/webadmin.properties">example</a></p>
-</li>
-<li>
-<p><a href="ssl.html" class="xref page">This page</a> details SSL & TLS configuration.</p>
-</li>
-<li>
-<p><a href="sieve.html" class="xref page">This page</a> details Sieve setup and how to enable ManageSieve.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_for_storage_dependencies"><a class="anchor" href="#_for_storage_dependencies"></a>For storage dependencies</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Except specific documented cases, these files are required, at least to establish a connection with the storage components.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="blobstore.html" class="xref page"><strong>blobstore.properties</strong></a> allows to configure the BlobStore <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/blob.properties">example</a></p>
-</li>
-<li>
-<p><a href="cassandra.html" class="xref page"><strong>cassandra.properties</strong></a> allows to configure the Cassandra driver <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/cassandra.properties">example</a></p>
-</li>
-<li>
-<p><a href="opensearch.html" class="xref page"><strong>opensearch.properties</strong></a> allows to configure OpenSearch driver <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/opensearch.properties">example</a></p>
-</li>
-<li>
-<p><a href="rabbitmq.html" class="xref page"><strong>rabbitmq.properties</strong></a> allows configuration for the RabbitMQ driver <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/rabbitmq.properties">example</a></p>
-</li>
-<li>
-<p><a href="redis.html" class="xref page"><strong>redis.properties</strong></a> allows configuration for the Redis driver <a href="https://github.com/apache/james-project/blob/fabfdf4874da3aebb04e6fe4a7277322a395536a/server/mailet/rate-limiter-redis/redis.properties">example</a>, that is used by optional
-distributed rate limiting component.</p>
-</li>
-<li>
-<p><a href="tika.html" class="xref page"><strong>tika.properties</strong></a> allows configuring Tika as a backend for text extraction <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/tika.properties">example</a></p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_for_core_components"><a class="anchor" href="#_for_core_components"></a>For core components</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>By omitting these files, sane default values are used.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="batchsizes.html" class="xref page"><strong>batchsizes.properties</strong></a> allows to configure mailbox read batch sizes <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/batchsizes.properties">example</a></p>
-</li>
-<li>
-<p><a href="dns.html" class="xref page"><strong>dnsservice.xml</strong></a> allows to configure DNS resolution <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/dnsservice.xml">example</a></p>
-</li>
-<li>
-<p><a href="domainlist.html" class="xref page"><strong>domainlist.xml</strong></a> allows to configure Domain storage <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/domainlist.xml">example</a></p>
-</li>
-<li>
-<p><a href="healthcheck.html" class="xref page"><strong>healthcheck.properties</strong></a> allows to configure periodical healthchecks <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/healthcheck.properties">example</a></p>
-</li>
-<li>
-<p><a href="mailetcontainer.html" class="xref page"><strong>mailetcontainer.xml</strong></a> allows configuring mail processing <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/mailetcontainer.xml">example</a></p>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="mailets.html" class="xref page">This page</a> list matchers that can be used out of the box with the Distributed Server.</p>
-</li>
-<li>
-<p><a href="matchers.html" class="xref page">This page</a> list matchers that can be used out of the box with the Distributed Server.</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p><a href="mailrepositorystore.html" class="xref page"><strong>mailrepositorystore.xml</strong></a> enables registration of allowed MailRepository protcols and link them to MailRepository implementations <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/mailrepositorystore.xml">example</a></p>
-</li>
-<li>
-<p><a href="recipientrewritetable.html" class="xref page"><strong>recipientrewritetable.xml</strong></a> enables advanced configuration for the Recipient Rewrite Table component <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/recipientrewritetable.xml">example</a></p>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="matchers.html" class="xref page">This page</a> allows choosing the indexing technology.</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p><a href="usersrepository.html" class="xref page"><strong>usersrepository.xml</strong></a> allows configuration of user storage <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/usersrepository.xml">example</a></p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_for_extensions"><a class="anchor" href="#_for_extensions"></a>For extensions</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>By omitting these files, no extra behaviour is added.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="vault.html" class="xref page"><strong>deletedMessageVault.properties</strong></a> allows to configure the DeletedMessageVault <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/deletedMessageVault.properties">example</a></p>
-</li>
-<li>
-<p><a href="listeners.html" class="xref page"><strong>listeners.xml</strong></a> enables configuration of Mailbox Listeners <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/listeners.xml">example</a></p>
-</li>
-<li>
-<p><a href="extensions.html" class="xref page"><strong>extensions.properties</strong></a> allows to extend James behaviour by loading your extensions in it <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/extensions.properties">example</a></p>
-</li>
-<li>
-<p><a href="jvm.html" class="xref page"><strong>jvm.properties</strong></a> lets you specify additional system properties without cluttering your command line</p>
-</li>
-<li>
-<p><a href="spam.html" class="xref page">This page</a> documents Anti-Spam setup with SpamAssassin, Rspamd.</p>
-</li>
-<li>
-<p><a href="remote-delivery-error-handling.html" class="xref page">This page</a> proposes a simple strategy for RemoteDelivery error handling.</p>
-</li>
-<li>
-<p><a href="collecting-contacts.html" class="xref page">This page</a> documents contact collection</p>
-</li>
-<li>
-<p><a href="collecting-events.html" class="xref page">This page</a> documents event collection</p>
-</li>
-<li>
-<p><a href="dsn.html" class="xref page">this page</a> specified how to support SMTP Delivery Submission Notification (<a href="https://tools.ietf.org/html/rfc3461">RFC-3461</a>)</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_system_properties"><a class="anchor" href="#_system_properties"></a>System properties</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Some tuning can be done via system properties. This includes:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. System properties</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">james.message.memory.threshold</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">(Optional). String (size, integer + size units, example: <code>12 KIB</code>, supported units are bytes KIB MIB GIB TIB). Defaults to 100KIB.
-This governs the threshold MimeMessageInputStreamSource relies on for storing MimeMessage content on disk.
-Below, data is stored in memory. Above data is stored on disk.
-Lower values will lead to longer processing time but will minimize heap memory usage. Modern SSD hardware
-should however support a high throughput. Higher values will lead to faster single mail processing at the cost
-of higher heap usage.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">james.message.usememorycopy</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Boolean. Defaults to false. Recommended value is false.
-Should MimeMessageWrapper use a copy of the message in memory? Or should bigger message exceeding james.message.memory.threshold
-be copied to temporary files?</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/configure/jmap.html b/james-distributed-app/3.8.1/configure/jmap.html
deleted file mode 100644
index 5de1184..0000000
--- a/james-distributed-app/3.8.1/configure/jmap.html
+++ /dev/null
@@ -1,676 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — jmap.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Protocols</li>
- <li><a href="jmap.html">jmap.properties</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/jmap.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — jmap.properties</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p><a href="https://jmap.io/">JMAP</a> is intended to be a new standard for email clients to connect to mail
-stores. It therefore intends to primarily replace IMAP + SMTP submission. It is also designed to be more
-generic. It does not replace MTA-to-MTA SMTP transmission.</p>
-</div>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/jmap.properties">example</a>
-to get some examples and hints.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. jmap.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true/false. Governs whether JMAP should be enabled</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jmap.port</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 80. The port this server will be listening on. This value must be a valid
-port, ranging between 1 and 65535 (inclusive)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tls.keystoreURL</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Keystore to be used for generating authentication tokens for password authentication mechanism.
-This should not be the same keystore than the ones used by TLS based protocols.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tls.secret</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Password used to read the keystore</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jwt.publickeypem.url</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Coma separated list of RSA public keys URLs to validate JWT tokens allowing requests to bypass authentication.
-Defaults to an empty list.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">url.prefix</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Configuration urlPrefix for JMAP routes. Default value: <a href="http://localhost" class="bare">http://localhost</a>.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">websocket.url.prefix</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. URL for JMAP WebSocket route. Default value: ws://localhost</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">email.send.max.size</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Configuration max size for message created in RFC-8621.
-Default value: None. Supported units are B (bytes) K (KB) M (MB) G (GB).</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">max.size.attachments.per.mail</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 20MB. RFC-8621 <code>maxSizeAttachmentsPerEmail</code> advertised to JMAP client as part of the
-<code>urn:ietf:params:jmap:mail</code> capability. This needs to be at least 33% lower than <code>email.send.max.size</code> property
-(in order to account for text body, headers, base64 encoding and MIME structures).
-JMAP clients would use this property in order not to create too big emails.
-Default value: None. Supported units are B (bytes) K (KB) M (MB) G (GB).</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">upload.max.size</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Configuration max size for each upload file in new JMAP-RFC-8621.
-Default value: 30M. Supported units are B (bytes) K (KB) M (MB) G (GB).</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">upload.quota.limit</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Configure JMAP upload quota for total existing uploads' size per user. User exceeding the upload quota would result in old uploads being cleaned up.
-Default value: 200M. Supported units are B (bytes) K (KB) M (MB) G (GB).</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">view.email.query.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional boolean. Defaults to false. Should simple Email/query be resolved against a Cassandra projection, or should we resolve them against OpenSearch?
-This enables a higher resilience, but the projection needs to be correctly populated.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">user.provisioning.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional boolean. Defaults to true. Governs whether authenticated users that do not exist locally should be created in the users repository.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">authentication.strategy.rfc8621</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional List[String] with delimiter <code>,</code> . Specify which authentication strategies system admin want to use for JMAP RFC-8621 server.
-The implicit package name is <code>org.apache.james.jmap.http</code>. If you have a custom authentication strategy outside this package, you have to specify its FQDN.
-If no authentication strategy is specified, JMAP RFC-8621 server will fallback to default strategies:
-<code>JWTAuthenticationStrategy</code>, <code>BasicAuthenticationStrategy</code>.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jmap.version.default</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional string. Defaults to <code>rfc-8621</code>. Allowed values: rfc-8621
-Which version of the JMAP protocol should be served when none supplied in the Accept header.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">dynamic.jmap.prefix.resolution.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional boolean. Defaults to false. Supported Jmap session endpoint returns dynamic prefix in response.
-When its config is true, and the HTTP request to Jmap session endpoint has a <code>X-JMAP-PREFIX</code> header with the value <code><a href="http://new-domain/prefix" class="bare">http://new-domain/prefix</a></code>,
-then <code>apiUrl, downloadUrl, uploadUrl, eventSourceUrl, webSocketUrl</code> in response will be changed with a new prefix. Example: The <code>apiUrl</code> will be "http://new-domain/prefix/jmap".
-If the HTTP request to Jmap session endpoint has the <code>X-JMAP-WEBSOCKET-PREFIX</code> header with the value <code>ws://new-domain/prefix</code>,
-then <code>capabilities."urn:ietf:params:jmap:websocket".url</code> in response will be "ws://new-domain/prefix/jmap/ws".</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">webpush.prevent.server.side.request.forgery</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional boolean. Prevent server side request forgery by preventing calls to the private network ranges. Defaults to true, can be disabled for testing.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandra.filter.projection.activated</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional boolean. Defaults to false. Casandra backends only. Whether to use or not the Cassandra projection
-for JMAP filters. This projection optimizes reads, but needs to be correctly populated. Turning it on on
-systems with filters already defined would result in those filters to be not read.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">delay.sends.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional boolean. Defaults to false. Whether to support or not the delay send with JMAP protocol.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">disabled.capabilities</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional, defaults to empty. Coma separated list of JMAP capabilities to reject.
-This allows to prevent users from using some specific JMAP extensions.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">email.get.full.max.size</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional, default value is 5. The max number of items for EmailGet full reads.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">get.max.size</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional, default value is 500. The max number of items for /get methods.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">set.max.size</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional, default value is 500. The max number of items for /set methods.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_wire_tapping"><a class="anchor" href="#_wire_tapping"></a>Wire tapping</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Enabling <strong>TRACE</strong> on <code>org.apache.james.jmap.wire</code> enables reactor-netty wiretap, logging of
-all incoming and outgoing requests, outgoing requests. This will log also potentially sensible information
-like authentication credentials.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_oidc_set_up"><a class="anchor" href="#_oidc_set_up"></a>OIDC set up</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The use of <code>XUserAuthenticationStrategy</code> allow delegating the authentication responsibility to a third party system,
-which could be used to set up authentication against an OIDC provider.</p>
-</div>
-<div class="paragraph">
-<p>We do supply an <a href="https://github.com">example</a> of such a setup. It combines the <a href="https://www.keycloak.org/">Keycloack</a>
-OIDC provider with the <a href="https://www.krakend.io/">Krackend</a> API gateway, but usage of similar technologies is definitely doable.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_generating_a_jwt_key_pair"><a class="anchor" href="#_generating_a_jwt_key_pair"></a>Generating a JWT key pair</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Apache James can alternatively be configured to check the validity of JWT tokens itself. No revocation mechanism is
-supported in such a setup, and the <code>sub</code> claim is used to identify the user. The key configuration is static.</p>
-</div>
-<div class="paragraph">
-<p>This requires the <code>JWTAuthenticationStrategy</code> authentication strategy to be used.</p>
-</div>
-<div class="paragraph">
-<p>The Distributed server enforces the use of RSA-SHA-256.</p>
-</div>
-<div class="paragraph">
-<p>One can use OpenSSL to generate a JWT key pair :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre># private key
-openssl genrsa -out rs256-4096-private.rsa 4096
-# public key
-openssl rsa -in rs256-4096-private.rsa -pubout > rs256-4096-public.pem</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The private key can be used to generate JWT tokens, for instance
-using <a href="https://github.com/vandium-io/jwtgen">jwtgen</a>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>jwtgen -a RS256 -p rs256-4096-private.rsa 4096 -c "sub=bob@domain.tld" -e 3600 -V</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>This token can then be passed as <code>Bearer</code> of the <code>Authorization</code> header :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -H "Authorization: Bearer $token" -XPOST http://127.0.0.1:80/jmap -d '...'</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The public key can be referenced as <code>jwt.publickeypem.url</code> of the <code>jmap.properties</code> configuration file.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_annotated_specification"><a class="anchor" href="#_annotated_specification"></a>Annotated specification</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The [annotated documentation](<a href="https://github.com/apache/james-project/tree/master/server/protocols/jmap-rfc-8621/doc/specs/spec" class="bare">https://github.com/apache/james-project/tree/master/server/protocols/jmap-rfc-8621/doc/specs/spec</a>)
-presents the limits of the JMAP RFC-8621 implementation part of the Apache James project. We furthermore implement
-[JSON Meta Application Protocol (JMAP) Subprotocol for WebSocket](<a href="https://tools.ietf.org/html/rfc8887" class="bare">https://tools.ietf.org/html/rfc8887</a>).</p>
-</div>
-<div class="paragraph">
-<p>Some methods / types are not yet implemented, some implementations are naive, and the PUSH is not supported yet.</p>
-</div>
-<div class="paragraph">
-<p>Users are invited to read these limitations before using actively the JMAP RFC-8621 implementation, and should ensure their
-client applications only uses supported operations.</p>
-</div>
-<div class="paragraph">
-<p>Contributions enhancing support are furthermore welcomed.</p>
-</div>
-<div class="paragraph">
-<p>The list of tested JMAP clients are:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Experiments had been run on top of [LTT.RS](<a href="https://github.com/iNPUTmice/lttrs-android" class="bare">https://github.com/iNPUTmice/lttrs-android</a>). Version in the Accept
-headers needs to be explicitly set to <code>rfc-8621</code>. [Read more](<a href="https://github.com/linagora/james-project/pull/4089" class="bare">https://github.com/linagora/james-project/pull/4089</a>).</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_jmap_auto_configuration"><a class="anchor" href="#_jmap_auto_configuration"></a>JMAP auto-configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p><a href="https://datatracker.ietf.org/doc/html/rfc8620">RFC-8620</a> defining JMAP core RFC defines precisely service location.</p>
-</div>
-<div class="paragraph">
-<p>James already redirects <code><a href="http://jmap.domain.tld/.well-known/jmap" class="bare">http://jmap.domain.tld/.well-known/jmap</a></code> to the JMAP session.</p>
-</div>
-<div class="paragraph">
-<p>You can further help your clients by publishing extra SRV records.</p>
-</div>
-<div class="paragraph">
-<p>Eg:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>_jmap._tcp.domain.tld. 3600 IN SRV 0 1 443 jmap.domain.tld.</pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_jmap_reverse_proxy_set_up"><a class="anchor" href="#_jmap_reverse_proxy_set_up"></a>JMAP reverse-proxy set up</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>James implementation adds the value of <code>X-Real-IP</code> header as part of the logging MDC.</p>
-</div>
-<div class="paragraph">
-<p>This allows for reverse proxies to cary other the IP address of the client down to the JMAP server for diagnostic purpose.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/configure/jmx.html b/james-distributed-app/3.8.1/configure/jmx.html
deleted file mode 100644
index 1fb7f69..0000000
--- a/james-distributed-app/3.8.1/configure/jmx.html
+++ /dev/null
@@ -1,515 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — jmx.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Protocols</li>
- <li><a href="jmx.html">jmx.properties</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/jmx.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — jmx.properties</h1>
-<div class="sect1">
-<h2 id="_disclaimer"><a class="anchor" href="#_disclaimer"></a>Disclaimer</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>JMX poses several security concerns and had been leveraged to conduct arbitrary code execution.
-This threat is mitigated by not allowing remote connections to JMX, setting up authentication and pre-authentication filters.
-However, we recommend to either run James in isolation (docker / own virtual machine) or disable JMX altogether.<br/></p>
-</div>
-<div class="paragraph">
-<p>James JMX endpoint provides command line utilities and exposes a few metrics, also available on the metric endpoint.</p></p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_configuration"><a class="anchor" href="#_configuration"></a>Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This is used to configure the JMX MBean server via which all management is achieved.</p>
-</div>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/jmx.properties">example</a>
-in GIT to get some examples and hints.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. jmx.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jmx.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Boolean. Should the JMX server be enabled? Defaults to <code>true</code>.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jmx.address</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The IP address (host name) the MBean Server will bind/listen to.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jmx.port</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The port number the MBean Server will bind/listen to.</p></td>
-</tr>
-</tbody>
-</table>
-<div class="paragraph">
-<p>To access from a remote location, it has been reported that <code>-Dcom.sun.management.jmxremote.ssl=false</code> is needed as
-a JVM argument.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_jmx_security"><a class="anchor" href="#_jmx_security"></a>JMX Security</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>In order to set up JMX authentication, we need to put <code>jmxremote.password</code> and <code>jmxremote.access</code> file
-to <code>/conf</code> directory.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>jmxremote.password</code>: define the username and password, that will be used by the client (here is james-cli)</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>File’s content example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">james-admin pass1</code></pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>jmxremote.access</code>: define the pair of username and access permission</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>File’s content example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">james-admin readwrite</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>When James runs with option <code>-Djames.jmx.credential.generation=true</code>, James will automatically generate <code>jmxremote.password</code> if the file does not exist.
-Then the default username is <code>james-admin</code> and a random password. This option defaults to true.</p>
-</div>
-<div class="sect2">
-<h3 id="_james_cli"><a class="anchor" href="#_james_cli"></a>James-cli</h3>
-<div class="paragraph">
-<p>When the JMX server starts with authentication configuration, it will require the client need provide username/password for bypass.
-To do that, we need set arguments <code>-username</code> and <code>-password</code> for the command request.</p>
-</div>
-<div class="paragraph">
-<p>Command example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">james-cli -h 127.0.0.1 -p 9999 -username james-admin -password pass1 listdomains</code></pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/configure/jvm.html b/james-distributed-app/3.8.1/configure/jvm.html
deleted file mode 100644
index 7e2e2a7..0000000
--- a/james-distributed-app/3.8.1/configure/jvm.html
+++ /dev/null
@@ -1,533 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — jvm.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="jvm.html">Distributed James Server — jvm.properties</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/jvm.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — jvm.properties</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This file may contain any additional system properties for tweaking JVM execution. When you normally would add a command line option <code>-Dmy.property=whatever</code>, you can put it in this file as <code>my.property=whatever</code> instead. These properties will be added as system properties on server start.</p>
-</div>
-<div class="paragraph">
-<p>Note that in some rare cases this might not work,
-when a property affects very early JVM start behaviour.</p>
-</div>
-<div class="paragraph">
-<p>For testing purposes, you may specify a different file path via the command line option <code>-Dextra.props=/some/other/jvm.properties</code>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_control_the_threshold_memory"><a class="anchor" href="#_control_the_threshold_memory"></a>Control the threshold memory</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This governs the threshold MimeMessageInputStreamSource relies on for storing MimeMessage content on disk.</p>
-</div>
-<div class="paragraph">
-<p>In <code>jvm.properties</code></p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>james.message.memory.threshold=12K</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>(Optional). String (size, integer + size units, example: <code>12 KIB</code>, supported units are bytes KIB MIB GIB TIB). Defaults to 100KIB.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_enable_the_copy_of_message_in_memory"><a class="anchor" href="#_enable_the_copy_of_message_in_memory"></a>Enable the copy of message in memory</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Should MimeMessageWrapper use a copy of the message in memory? Or should bigger message exceeding james.message.memory.threshold
-be copied to temporary files?</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>james.message.usememorycopy=true</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Optional. Boolean. Defaults to false. Recommended value is false.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_running_resource_leak_detection"><a class="anchor" href="#_running_resource_leak_detection"></a>Running resource leak detection</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>It is used to detect a resource not be disposed of before it’s garbage-collected.</p>
-</div>
-<div class="paragraph">
-<p>In <code>jvm.properties</code></p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>james.lifecycle.leak.detection.mode=advanced</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Allowed mode values are: none, simple, advanced, testing</p>
-</div>
-<div class="paragraph">
-<p>The purpose of each mode is introduced in <code>config-system.xml</code></p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_disabling_host_information_in_protocol_mdc_logging_context"><a class="anchor" href="#_disabling_host_information_in_protocol_mdc_logging_context"></a>Disabling host information in protocol MDC logging context</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Should we add the host in the MDC logging context for incoming IMAP, SMTP, POP3? Doing so, a DNS resolution
-is attempted for each incoming connection, which can be costly. Remote IP is always added to the logging context.</p>
-</div>
-<div class="paragraph">
-<p>In <code>jvm.properties</code></p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>james.protocols.mdc.hostname=false</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Optional. Boolean. Defaults to true.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_change_the_encoding_type_used_for_the_blobid"><a class="anchor" href="#_change_the_encoding_type_used_for_the_blobid"></a>Change the encoding type used for the blobId</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>By default, the blobId is encoded in base64 url. The property <code>james.blob.id.hash.encoding</code> allows to change the encoding type.
-The support value are: base16, hex, base32, base32Hex, base64, base64Url.</p>
-</div>
-<div class="paragraph">
-<p>Ex in <code>jvm.properties</code></p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>james.blob.id.hash.encoding=base16</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Optional. String. Defaults to base64Url.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_jmap_quota_draft_compatibility"><a class="anchor" href="#_jmap_quota_draft_compatibility"></a>JMAP Quota draft compatibility</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Some JMAP clients depend on the JMAP Quota draft specifications. The property <code>james.jmap.quota.draft.compatibility</code> allows
-to enable JMAP Quota draft compatibility for those clients and allow them a time window to adapt to the RFC-9245 JMAP Quota.</p>
-</div>
-<div class="paragraph">
-<p>Optional. Boolean. Default to false.</p>
-</div>
-<div class="paragraph">
-<p>Ex in <code>jvm.properties</code></p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>james.jmap.quota.draft.compatibility=true</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>To enable the compatibility.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/configure/listeners.html b/james-distributed-app/3.8.1/configure/listeners.html
deleted file mode 100644
index 1a1e0d8..0000000
--- a/james-distributed-app/3.8.1/configure/listeners.html
+++ /dev/null
@@ -1,636 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — listeners.xml :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Extensions</li>
- <li><a href="listeners.html">listeners.xml</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/listeners.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — listeners.xml</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>Distributed James relies on an event bus system to enrich mailbox capabilities. Each
-operation performed on the mailbox will trigger related events, that can
-be processed asynchronously by potentially any James node on a
-distributed system.</p>
-</div>
-<div class="paragraph">
-<p>Mailbox listeners can register themselves on this event bus system to be
-called when an event is fired, allowing to do different kind of extra
-operations on the system.</p>
-</div>
-<div class="paragraph">
-<p>Distributed James allows the user to register potentially user defined additional mailbox listeners.</p>
-</div>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/listener.xml">example</a>
-to get some examples and hints.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_configuration"><a class="anchor" href="#_configuration"></a>Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The <executeGroupListeners> controls whether to launch group mailbox listener consumption. Defaults to true. Use with caution:
-never disable on standalone james servers, and ensure at least some instances do consume group mailbox listeners within a
-clustered topology.</p>
-</div>
-<div class="paragraph">
-<p>Mailbox listener configuration is under the XML element <listener>.</p>
-</div>
-<div class="paragraph">
-<p>Some MailboxListener allows you to specify if you want to run them synchronously or asynchronously. To do so,
-for MailboxListener that supports this, you can use the <strong>async</strong> attribute (optional, per mailet default) to govern the execution mode.
-If <strong>true</strong> the execution will be scheduled in a reactor elastic scheduler. If <strong>false</strong>, the execution is synchronous.</p>
-</div>
-<div class="paragraph">
-<p>Already provided additional listeners are documented below.</p>
-</div>
-<div class="sect2">
-<h3 id="_spamassassinlistener"><a class="anchor" href="#_spamassassinlistener"></a>SpamAssassinListener</h3>
-<div class="paragraph">
-<p>Provides per user real-time HAM/SPAM feedback to a SpamAssassin server depending on user actions.</p>
-</div>
-<div class="paragraph">
-<p>This mailet is asynchronous by default, but this behaviour can be overridden by the <strong>async</strong>
-configuration property.</p>
-</div>
-<div class="paragraph">
-<p>This MailboxListener is supported.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><listeners>
- <!-- ... -->
- <listener>
- <class>org.apache.james.mailbox.spamassassin.SpamAssassinListener</class>
- </listener>
-</listeners></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Please note that a <code>spamassassin.properties</code> file is needed. Read also
-<a href="spam.html" class="xref page">this page</a> for extra configuration required to support this feature.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_rspamdlistener"><a class="anchor" href="#_rspamdlistener"></a>RspamdListener</h3>
-<div class="paragraph">
-<p>Provides HAM/SPAM feedback to a Rspamd server depending on user actions.</p>
-</div>
-<div class="paragraph">
-<p>This MailboxListener is supported.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><listeners>
- <!-- ... -->
- <listener>
- <class>org.apache.james.rspamd.RspamdListener</class>
- </listener>
-</listeners></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Please note that a <code>rspamd.properties</code> file is needed. Read also
-<a href="spam.html" class="xref page">this page</a> for extra configuration required to support this feature.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_mailboxoperationlogginglistener"><a class="anchor" href="#_mailboxoperationlogginglistener"></a>MailboxOperationLoggingListener</h3>
-<div class="paragraph">
-<p>Provides more insights on mailbox operationsby logging them.</p>
-</div>
-<div class="paragraph">
-<p>This MailboxListener is supported.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><listeners>
- <listener>
- <class>org.apache.james.mailbox.cassandra.MailboxOperationLoggingListener</class>
- </listener>
- <!-- ... -->
-</listeners></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_quotathresholdcrossinglistener"><a class="anchor" href="#_quotathresholdcrossinglistener"></a>QuotaThresholdCrossingListener</h3>
-<div class="paragraph">
-<p>Sends emails to users exceeding 80% and 99% of their quota to warn them (for instance).</p>
-</div>
-<div class="paragraph">
-<p>Here are the following properties you can configure:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. QuotaThresholdCrossingListener configuration properties</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Useful when configuring several time this listener. You might want to do so to use different rendering templates for
-different occupation thresholds.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">gracePeriod</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Period during which no more email for a given threshold should be sent.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">subjectTemplate</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Mustache template for rendering the subject of the warning email.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">bodyTemplate</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Mustache template for rendering the body of the warning email.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">thresholds</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Floating number between 0 and 1 representing the threshold of quota occupation from which a mail should be sent.
-Configuring several thresholds is supported.</p></td>
-</tr>
-</tbody>
-</table>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><listeners>
- <!-- ... -->
- <listener>
- <class>org.apache.james.mailbox.quota.mailing.listeners.QuotaThresholdCrossingListener</class>
- <group>QuotaThresholdCrossingListener-upper-threshold</group>
- <configuration>
- <thresholds>
- <threshold>
- <value>0.8</value>
- </threshold>
- </thresholds>
- <name>thirst</name>
- <subjectTemplate>conf://templates/QuotaThresholdMailSubject.mustache</subjectTemplate>
- <bodyTemplate>conf://templates/QuotaThresholdMailBody.mustache</bodyTemplate>
- <gracePeriod>1week/</gracePeriod>
- </configuration>
- </listener>
-</listeners></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Here are examples of templates you can use:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>For subject template: <code>conf://templates/QuotaThresholdMailSubject.mustache</code></p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>Warning: Your email usage just exceeded a configured threshold</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>For body template: <code>conf://templates/QuotaThresholdMailBody.mustache</code></p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>You receive this email because you recently exceeded a threshold related to the quotas of your email account.
-
-{{#hasExceededSizeThreshold}}
-You currently occupy more than {{sizeThreshold}} % of the total size allocated to you.
-You currently occupy {{usedSize}}{{#hasSizeLimit}} on a total of {{limitSize}} allocated to you{{/hasSizeLimit}}.
-
-{{/hasExceededSizeThreshold}}
-{{#hasExceededCountThreshold}}
-You currently occupy more than {{countThreshold}} % of the total message count allocated to you.
-You currently have {{usedCount}} messages{{#hasCountLimit}} on a total of {{limitCount}} allowed for you{{/hasCountLimit}}.
-
-{{/hasExceededCountThreshold}}
-You need to be aware that actions leading to exceeded quotas will be denied. This will result in a degraded service.
-To mitigate this issue you might reach your administrator in order to increase your configured quota. You might also delete some non important emails.</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>This MailboxListener is supported.</p>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/configure/mailetcontainer.html b/james-distributed-app/3.8.1/configure/mailetcontainer.html
deleted file mode 100644
index 1808ecc..0000000
--- a/james-distributed-app/3.8.1/configure/mailetcontainer.html
+++ /dev/null
@@ -1,536 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — mailetcontainer.xml :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Core components</li>
- <li><a href="mailetcontainer.html">mailetcontainer.xml</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/mailetcontainer.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — mailetcontainer.xml</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This documents explains how to configure Mail processing. Mails pass through the MailetContainer. The
-MailetContainer is a Matchers (condition for executing a mailet) and Mailets (execution units that perform
-actions based on incoming mail) pipeline arranged into processors (List of mailet/matcher pairs allowing
-better logical organisation). You can read more about these concepts on
-<a href="../architecture/index.html#_mail_processing" class="xref page">the mailet container feature description</a>.</p>
-</div>
-<div class="paragraph">
-<p>Apache James Server includes a number of <a href="mailets.html" class="xref page">Packaged Mailets</a> and
-<a href="matchers.html" class="xref page">Packaged Matchers</a>.</p>
-</div>
-<div class="paragraph">
-<p>Furthermore, you can write and use with James <a href="../extending/mail-processing.html" class="xref page">your own mailet and matchers</a>.</p>
-</div>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/mailetcontainer.xml">example</a>
-to get some examples and hints.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. mailetcontainer.xml content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">context.postmaster</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The body of this element is the address that the server
-will consider its postmaster address. This address will be listed as the sender address
-of all error messages that originate from James. Also, all messages addressed to
-postmaster@<servername>, where <servername> is one of the domain names whose
-mail is being handled by James, will be redirected to this email address.
-Set this to the appropriate email address for error reports
-If this is set to a non-local email address, the mail server
-will still function, but will generate a warning on startup.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">spooler.threads</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Number of simultaneous threads used to spool the mails. Set to zero, it disables mail processing - use with
-caution.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">spooler.errorRepository</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Mail repository to store email in after several unrecoverable errors. Mails failing processing, for which
-the Mailet Container could not handle Error, will be stored there after their processing had been attempted
-5 times. Note that if standard java Exception occurs, <strong>Error handling</strong> section below will be applied
-instead.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_the_mailet_tag"><a class="anchor" href="#_the_mailet_tag"></a>The Mailet Tag</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Consider the following simple <strong>mailet</strong> tag:</p></p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="RemoteAddrNotInNetwork=127.0.0.1" class="ToProcessor">
- <processor>spam</processor>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The mailet tag has two required attributes, <strong>match</strong> and <strong>class</strong>.</p>
-</div>
-<div class="paragraph">
-<p>The <strong>match</strong> attribute is set to the value of the specific Matcher class to be instantiated with a an
-optional argument. If present, the argument is separated from the Matcher class name by an '='. Semantic
-interpretation of the argument is left to the particular mailet.</p>
-</div>
-<div class="paragraph">
-<p>The <strong>class</strong> attribute is set to the value of the Mailet class that is to be instantiated.</p>
-</div>
-<div class="paragraph">
-<p>Finally, the children of the <strong>mailet</strong> tag define the configuration that is passed to the Mailet. The
-tags used in this section should have no attributes or children. The names and bodies of the elements will be passed to
-the mailet as (name, value) pairs.</p>
-</div>
-<div class="paragraph">
-<p>So in the example above, a Matcher instance of RemoteAddrNotInNetwork would be instantiated, and the value "127.0.0.1"
-would be passed to the matcher. The Mailet of the pair will be an instance of ToProcessor, and it will be passed the (name, value)
-pair of ("processor", "spam").</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_error_handling"><a class="anchor" href="#_error_handling"></a>Error handling</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>If an exception is encountered during the execution of a mailet or a matcher, the default behaviour is to
-process the mail using the <strong>error</strong> processor.</p>
-</div>
-<div class="paragraph">
-<p>The <strong>onMailetException</strong> property allows you to override this behaviour. You can specify another
-processor than the <strong>error</strong> one for handling the errors of this mailet.</p>
-</div>
-<div class="paragraph">
-<p>The <strong>ignore</strong> special value also allows to continue processing and ignore the error.</p>
-</div>
-<div class="paragraph">
-<p>The <strong>propagate</strong> special value causes the mailet container to rethrow the
-exception, propagating it to the execution context. In an SMTP execution context, the spooler will then requeue
-the item and automatic retries will be setted up - note that attempts will be done for each recipients. In LMTP
-(if LMTP is configured to execute the mailetContainer), the entire mail transaction is reported as failed to the caller.</p>
-</div>
-<div class="paragraph">
-<p>Moreover, the <strong>onMatcherException</strong> allows you to override matcher error handling. You can
-specify another processor than the <strong>error</strong> one for handling the errors of this mailet. The <strong>matchall</strong>
-special value also allows you to match all recipients when there is an error. The <strong>nomatch</strong>
-special value also allows you to match no recipients when there is an error.</p>
-</div>
-<div class="paragraph">
-<p>Here is a short example to illustrate this:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match=RecipientIsLocal class="LocalDelivery">
- <onMailetException>deliveryError</onMailetException>
- <onMatcherException>nomatch</onMatcherException>
-</mailet></pre>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/configure/mailets.html b/james-distributed-app/3.8.1/configure/mailets.html
deleted file mode 100644
index a7502ce..0000000
--- a/james-distributed-app/3.8.1/configure/mailets.html
+++ /dev/null
@@ -1,3094 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Mailets :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Core components</li>
- <li><a href="mailets.html">Packaged Mailets</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/mailets.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Mailets</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This documentation page lists and documents Mailet that can be used within the
-Distributed Server MailetContainer in order to write your own mail processing logic with out-of-the-box components.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_supported_mailets"><a class="anchor" href="#_supported_mailets"></a>Supported mailets</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_adddeliveredtoheader"><a class="anchor" href="#_adddeliveredtoheader"></a>AddDeliveredToHeader</h3>
-<div class="paragraph">
-<p>This mailet adds the de-facto standard QMail Delivered-To header.</p>
-</div>
-<div class="paragraph">
-<p>Upon processing by LocalDelivery, a Delivered-To header matching the recipient mail address will be added before storage.</p>
-</div>
-<div class="paragraph">
-<p>Example</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="AddDeliveredToHeader"></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_addfooter"><a class="anchor" href="#_addfooter"></a>AddFooter</h3>
-<div class="paragraph">
-<p>Takes the message and attaches a footer message to it. Right now, it only
-supports simple messages. Needs to have additions to make it support
-messages with alternate content types or with attachments.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_addsubjectprefix"><a class="anchor" href="#_addsubjectprefix"></a>AddSubjectPrefix</h3>
-<div class="paragraph">
-<p>Add an prefix (tag) to the subject of a message <br></p>
-</div>
-<div class="paragraph">
-<p>Sample Configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="RecipientIs=robot@james.apache.org" class="TagMessage">
- <subjectPrefix>[robot]</subjectPrefix>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_amqpforwardattribute"><a class="anchor" href="#_amqpforwardattribute"></a>AmqpForwardAttribute</h3>
-<div class="paragraph">
-<p>This mailet forwards the attributes values to a AMPQ.</p>
-</div>
-<div class="paragraph">
-<p>It takes 4 parameters:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>attribute (mandatory): content to be forwarded, expected to be a Map<String, byte[]>
-where the byte[] content is issued from a MimeBodyPart.
-It is typically generated from the StripAttachment mailet.</p>
-</li>
-<li>
-<p>uri (mandatory): AMQP URI defining the server where to send the attachment.</p>
-</li>
-<li>
-<p>exchange (mandatory): name of the AMQP exchange.</p>
-</li>
-<li>
-<p>routing_key (optional, default to empty string): name of the routing key on this exchange.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This mailet will sent the data attached to the mail as an attribute holding a map.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_bounce"><a class="anchor" href="#_bounce"></a>Bounce</h3>
-<div class="paragraph">
-<p>Generates a response to the reverse-path address. Note that this is different
-than a mail-client’s reply, which would use the Reply-To or From header.</p>
-</div>
-<div class="paragraph">
-<p>Bounced messages are attached in their entirety (headers and content) and the
-resulting MIME part type is "message/rfc822".</p>
-</div>
-<div class="paragraph">
-<p>The reverse-path and the Return-Path header of the response is set to "null"
-("<>"), meaning that no reply should be sent.</p>
-</div>
-<div class="paragraph">
-<p>A sender of the notification message can optionally be specified. If one is
-not specified, the postmaster’s address will be used.</p>
-</div>
-<div class="paragraph">
-<p>A notice text can be specified, and in such case will be inserted into the
-notification inline text.</p>
-</div>
-<div class="paragraph">
-<p>If the notified message has an "error message" set, it will be inserted into
-the notification inline text. If the <strong>attachError</strong> init
-parameter is set to true, such error message will be attached to the
-notification message.</p>
-</div>
-<div class="paragraph">
-<p>Supports the <strong>passThrough</strong> init parameter (true if missing).</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="Bounce">
- <sender>*an address or postmaster or sender or unaltered, default=postmaster*</sender>
- <attachError>*true or false, default=false*</attachError>
- <message>*notice attached to the original message text (optional)*</message>
- <prefix>*optional subject prefix prepended to the original message*</prefix>
- <inline>*default=none*</inline>
- <attachment>*default=message*</attachment>
- <passThrough>*true or false, default=true*</passThrough>
- <fakeDomainCheck>*true or false, default=true*</fakeDomainCheck>
- <debug>*true or false, default=false*</debug>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The behaviour of this mailet is equivalent to using Resend with the following
-configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="Resend">
- <sender>*an address or postmaster or sender or unaltered*</sender>
- <attachError>*true or false*</attachError>
- <message>**dynamically built**</message>
- <prefix>*a string*</prefix>
- <passThrough>true or false</passThrough>
- <fakeDomainCheck>*true or false*</fakeDomainCheck>
- <recipients>*sender*</recipients>
- <reversePath>null</reversePath>
- <inline>see Resend</inline>
- <attachment>see Resend</attachment>
- <isReply>true</isReply>
- <debug>*true or false*</debug>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>notice</strong> and <strong>sendingAddress</strong> can be used instead of <strong>message</strong>
-and <strong>sender</strong>; such names are kept for backward compatibility.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_contactextractor"><a class="anchor" href="#_contactextractor"></a>ContactExtractor</h3>
-<div class="paragraph">
-<p>Collects the sender and the recipients of a message and store them as JSON in a
-specified message attribute.</p>
-</div>
-<div class="paragraph">
-<p>Here is the JSON format:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "userEmail" : "sender@james.org",
- "emails" : [ "to@james.org", "cc@james.org" ]
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="ContactExtractor">
- <attribute>ExtractedContacts</attribute>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_convertto7bit"><a class="anchor" href="#_convertto7bit"></a>ConvertTo7Bit</h3>
-<div class="paragraph">
-<p>Make sure the message stream is 7bit. Every 8bit part is encoded to
-quoted-printable or base64 and the message is saved.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_dkimsign"><a class="anchor" href="#_dkimsign"></a>DKIMSign</h3>
-<div class="paragraph">
-<p>This mailet sign a message using the DKIM protocol
-If the privateKey is encoded using a password then you can pass
-the password as privateKeyPassword parameter.</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration with inlined private key:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match=&quot;All&quot; class=&quot;DKIMSign&quot;>
- <signatureTemplate>v=1; s=selector; d=example.com; h=from:to:received:received; a=rsa-sha256; bh=; b=;</signatureTemplate>
- <privateKey>
- -----BEGIN RSA PRIVATE KEY-----
- MIICXAIBAAKBgQDYDaYKXzwVYwqWbLhmuJ66aTAN8wmDR+rfHE8HfnkSOax0oIoT
- M5zquZrTLo30870YMfYzxwfB6j/Nz3QdwrUD/t0YMYJiUKyWJnCKfZXHJBJ+yfRH
- r7oW+UW3cVo9CG2bBfIxsInwYe175g9UjyntJpWueqdEIo1c2bhv9Mp66QIDAQAB
- AoGBAI8XcwnZi0Sq5N89wF+gFNhnREFo3rsJDaCY8iqHdA5DDlnr3abb/yhipw0I
- /1HlgC6fIG2oexXOXFWl+USgqRt1kTt9jXhVFExg8mNko2UelAwFtsl8CRjVcYQO
- cedeH/WM/mXjg2wUqqZenBmlKlD6vNb70jFJeVaDJ/7n7j8BAkEA9NkH2D4Zgj/I
- OAVYccZYH74+VgO0e7VkUjQk9wtJ2j6cGqJ6Pfj0roVIMUWzoBb8YfErR8l6JnVQ
- bfy83gJeiQJBAOHk3ow7JjAn8XuOyZx24KcTaYWKUkAQfRWYDFFOYQF4KV9xLSEt
- ycY0kjsdxGKDudWcsATllFzXDCQF6DTNIWECQEA52ePwTjKrVnLTfCLEG4OgHKvl
- Zud4amthwDyJWoMEH2ChNB2je1N4JLrABOE+hk+OuoKnKAKEjWd8f3Jg/rkCQHj8
- mQmogHqYWikgP/FSZl518jV48Tao3iXbqvU9Mo2T6yzYNCCqIoDLFWseNVnCTZ0Q
- b+IfiEf1UeZVV5o4J+ECQDatNnS3V9qYUKjj/krNRD/U0+7eh8S2ylLqD3RlSn9K
- tYGRMgAtUXtiOEizBH6bd/orzI9V9sw8yBz+ZqIH25Q=
- -----END RSA PRIVATE KEY-----
- </privateKey>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Sample configuration with file-provided private key:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match=&quot;All&quot; class=&quot;DKIMSign&quot;>
- <signatureTemplate>v=1; s=selector; d=example.com; h=from:to:received:received; a=rsa-sha256; bh=; b=;</signatureTemplate>
- <privateKeyFilepath>dkim-signing.pem</privateKeyFilepath>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>By default the mailet assume that Javamail will convert LF to CRLF when sending
-so will compute the hash using converted newlines. If you don’t want this
-behaviour then set forceCRLF attribute to false.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_dkimverify"><a class="anchor" href="#_dkimverify"></a>DKIMVerify</h3>
-<div class="paragraph">
-<p>This mailet verify a message using the DKIM protocol</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="DKIMVerify">
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>By default the mailet assume that Javamail will use LF instead of CRLF
-so it will verify the hash using converted newlines. If you don’t want this
-behaviour then set forceCRLF attribute to false.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_dsnbounce"><a class="anchor" href="#_dsnbounce"></a>DSNBounce</h3>
-<div class="paragraph">
-<p>Generates a Delivery Status Notification (DSN) Note that this is different
-than a mail-client’s reply, which would use the Reply-To or From header.</p>
-</div>
-<div class="paragraph">
-<p>Bounced messages are attached in their entirety (headers and content) and the
-resulting MIME part type is "message/rfc822".</p>
-</div>
-<div class="paragraph">
-<p>The reverse-path and the Return-Path header of the response is set to "null"
-("<>"), meaning that no reply should be sent.</p>
-</div>
-<div class="paragraph">
-<p>A sender of the notification message can optionally be specified. If one is
-not specified, the postmaster’s address will be used.</p>
-</div>
-<div class="paragraph">
-<p>Supports the <code>passThrough</code> init parameter (true if missing).</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="DSNBounce">
- <sender>*an address or postmaster or sender or unaltered, default=postmaster*</sender>
- <prefix>*optional subject prefix prepended to the original message*</prefix>
- <attachment>*message, heads or none, default=message*</attachment>
- <messageString>*the message sent in the bounce, the first occurrence of the pattern [machine] is replaced with the name of the executing machine, default=Hi. This is the James mail server at [machine] ... *</messageString>
- <passThrough>*true or false, default=true*</passThrough>
- <debug>*true or false, default=false*</debug>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_expires"><a class="anchor" href="#_expires"></a>Expires</h3>
-<div class="paragraph">
-<p>Sanitizes or adds an expiration date to a message, in the form of an <code>Expires</code>
-header (RFC 4021).</p>
-</div>
-<div class="paragraph">
-<p>The mailet can force an existing expiration date to be within the bounds
-given by <code>minAge</code>, <code>maxAge</code>, or both. <code>minAge</code> specifies the minimum time
-the date must lie in the future, while <code>maxAge</code> specifies a maximum.</p>
-</div>
-<div class="paragraph">
-<p>If a message has no expiration date, the mailet can add one according to
-the optional <code>defaultAge</code> parameter.</p>
-</div>
-<div class="paragraph">
-<p>All parameter values should be expressed in the following format: <code>Nunit</code>.
-<code>N</code> should be positive. <code>unit</code> could be either in the short form
-(<code>h</code>, <code>d</code>, <code>w</code>, <code>y</code> etc.), or in the long form (<code>hours</code>, days`, <code>weeks</code>,
-<code>months</code>, <code>years</code>). The default unit is <code>days</code>.</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="Expires">
- <minAge>12h</minAge>
- <defaultAge>7d</defaultAge>
- <maxAge>8w</maxAge>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>By itself the <code>Expires</code> header is informational only. But some variants of James
-will let you delete expired messages through the
-<a href="../operate/webadmin.html#_administrating_messages" class="xref page">WebAdmin</a> interface:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/messages?byExpiresHeader</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_extractmdnoriginaljmapmessageid"><a class="anchor" href="#_extractmdnoriginaljmapmessageid"></a>ExtractMDNOriginalJMAPMessageId</h3>
-<div class="paragraph">
-<p>This mailet handles MDN messages and define a header X-JAMES-MDN-JMAP-MESSAGE-ID referencing
-the original message (by its Jmap Id) asking for the recipient to send an MDN.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_forward"><a class="anchor" href="#_forward"></a>Forward</h3>
-<div class="paragraph">
-<p>Replaces incoming recipients with those specified, and resends the message
-unaltered.</p>
-</div>
-<div class="paragraph">
-<p>Can be totally replaced by an equivalent usage of {@link Resend} (see below),
-simply replacing <strong><forwardto></strong> with <strong><recipients></strong>.</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="Forward">
- <forwardTo>*comma delimited list of email addresses*</forwardTo>
- <passThrough>*true or false, default=false*</passThrough>
- <fakeDomainCheck>*true or false, default=true*</fakeDomainCheck>
- <debug>*true or false, default=false*</debug>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The behaviour of this mailet is equivalent to using Resend with the following
-configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="Resend">
- <forwardTo>comma delimited list of email addresses</recipients>
- <passThrough>true or false</passThrough>
- <fakeDomainCheck>*true or false*</fakeDomainCheck>
- <debug>*true or false*</debug>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>forwardto</strong> can be used instead of <strong>forwardTo</strong>; such name is kept
-for backward compatibility.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_icalendarparser"><a class="anchor" href="#_icalendarparser"></a>ICalendarParser</h3>
-<div class="paragraph">
-<p>This mailet can be combined with the Strip attachment mailet.</p>
-</div>
-<div class="paragraph">
-<p>The ICS body part byte array is arranged as map then this mailet should look for ICS and parse it
-with Ical4J then store it as a mail attribute</p>
-</div>
-<div class="paragraph">
-<p>Configuration: The mailet contains 2 mandatory attributes</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> <mailet match="All" class="ICalendarParser" >
- <sourceAttribute>source.attribute.name</sourceAttribute>
- <!-- The attribute which contains output value of StripAttachment mailet -- >
- <destAttribute>dest.attribute.name</destAttribute>
- <!-- The attribute store the map of Calendar -- >
- </mailet ></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_icaltoheader"><a class="anchor" href="#_icaltoheader"></a>ICALToHeader</h3>
-<div class="paragraph">
-<p>ICALToHeader takes a Map of filenames to ICAL4J calendars, will pick the first Calendar,
-and add it to the headers of the e-mail.</p>
-</div>
-<div class="paragraph">
-<p>The following headers will be added : X_MEETING_UID, X_MEETING_METHOD, X_MEETING_RECURRENCE_ID, X_MEETING_SEQUENCE,
-X_MEETING_DTSTAMP</p>
-</div>
-<div class="paragraph">
-<p>The only configuration parameter for this mailet is the attribute the ICAL4J Calendar map should be attached to,
-named <strong>attribute</strong>.</p>
-</div>
-<div class="paragraph">
-<p>Configuration example :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match=??? class=ICALToHeader>
- <attribute>icalendars</attribute>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_icaltojsonattribute"><a class="anchor" href="#_icaltojsonattribute"></a>ICALToJsonAttribute</h3>
-<div class="paragraph">
-<p>ICALToJsonAttribute takes a map of ICAL4J objects attached as attribute, and
-output the map of corresponding json bytes as an other attribute, with unique String keys.</p>
-</div>
-<div class="paragraph">
-<p>The JSON contains the following fields :</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>ical</strong> : the raw ical string, in UTF-8</p>
-</li>
-<li>
-<p><strong>sender</strong> : the sender of the mail (compulsory, mail without sender will be discarded)</p>
-</li>
-<li>
-<p><strong>recipient</strong> : the recipient of the mail. If the mail have several recipients, each recipient will have its own JSON.</p>
-</li>
-<li>
-<p><strong>uid</strong> : the UID of the ical (optional)</p>
-</li>
-<li>
-<p><strong>sequence</strong> : the sequence of the ical (optional)</p>
-</li>
-<li>
-<p><strong>dtstamp</strong> : the date stamp of the ical (optional)</p>
-</li>
-<li>
-<p><strong>method</strong> : the method of the ical (optional)</p>
-</li>
-<li>
-<p><strong>recurrence-id</strong> : the recurrence-id of the ical (optional)</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Example are included in test call ICalToJsonAttributeTest.</p>
-</div>
-<div class="paragraph">
-<p>Configuration example :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match=??? class=ICALToJsonAttribute>
- <sourceAttribute>icalendars</sourceAttribute>
- <destinationAttribute>icalendarJson</destinationAttribute>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_icssanitizer"><a class="anchor" href="#_icssanitizer"></a>ICSSanitizer</h3>
-<div class="paragraph">
-<p>Some senders embed 'text/calendar' content as part of Mime bodypart headers with an empty body.</p>
-</div>
-<div class="paragraph">
-<p>This mailet duplicate the 'text/calendar' content to the Mime body part.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="ICSSanitizer"/></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_localdelivery"><a class="anchor" href="#_localdelivery"></a>LocalDelivery</h3>
-<div class="paragraph">
-<p>Receives a Mail from the Queue and takes care of delivery of the
-message to local inboxes.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_logmessage"><a class="anchor" href="#_logmessage"></a>LogMessage</h3>
-<div class="paragraph">
-<p>Logs Message Headers and/or Body.
-If the "passThrough" in confs is true the mail will be left untouched in
-the pipe. If false will be destroyed. Default is true.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_mailattributeslisttomimeheaders"><a class="anchor" href="#_mailattributeslisttomimeheaders"></a>MailAttributesListToMimeHeaders</h3>
-<div class="paragraph">
-<p>Convert attributes of type Collection<String> to headers</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="MailAttributesToMimeHeaders">
- <simplemapping>org.apache.james.attribute1;headerName1</simplemapping>
- <simplemapping>org.apache.james.attribute2;headerName2</simplemapping>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_mailattributestomimeheaders"><a class="anchor" href="#_mailattributestomimeheaders"></a>MailAttributesToMimeHeaders</h3>
-<div class="paragraph">
-<p>Convert attributes of type Collection<String> to headers</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="MailAttributesToMimeHeaders">
- <simplemapping>org.apache.james.attribute1;headerName1</simplemapping>
- <simplemapping>org.apache.james.attribute2;headerName2</simplemapping>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_metricsmailet"><a class="anchor" href="#_metricsmailet"></a>MetricsMailet</h3>
-<div class="paragraph">
-<p>This Metrics mailet increments a counter on every incoming emails.</p>
-</div>
-<div class="paragraph">
-<p>This counter is accessible via JMX, or grafana. Read <a href="../operate/metrics.html" class="xref page">more about metrics</a>.</p>
-</div>
-<div class="paragraph">
-<p>Example :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="all" class="MetricsMailet">
- <metricName>relayDenied</metricName>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will increment a counter relayDenied</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_mailattributestomimeheaders_2"><a class="anchor" href="#_mailattributestomimeheaders_2"></a>MailAttributesToMimeHeaders</h3>
-<div class="paragraph">
-<p>This mailet replace the mail attribute map of key to MimePart
-by a map of key to the MimePart content (as bytes).</p>
-</div>
-<div class="paragraph">
-<p>It takes only one parameter:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>attribute (mandatory): mime content to be decoded, expected to be a Map<String, byte[]></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Then all this map attribute values will be replaced by their content.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_notifypostmaster"><a class="anchor" href="#_notifypostmaster"></a>NotifyPostmaster</h3>
-<div class="paragraph">
-<p>Sends a notification message to the Postmaster.</p>
-</div>
-<div class="paragraph">
-<p>A sender of the notification message can optionally be specified. If one is
-not specified, the postmaster’s address will be used.</p>
-</div>
-<div class="paragraph">
-<p>The "To:" header of the notification message can be set to "unaltered"; if
-missing will be set to the postmaster.</p>
-</div>
-<div class="paragraph">
-<p>A notice text can be specified, and in such case will be inserted into the
-notification inline text.</p>
-</div>
-<div class="paragraph">
-<p>If the notified message has an "error message" set, it will be inserted into
-the notification inline text. If the <strong>attachError</strong> init
-parameter is set to true, such error message will be attached to the
-notification message.</p>
-</div>
-<div class="paragraph">
-<p>The notified messages are attached in their entirety (headers and content)
-and the resulting MIME part type is "message/rfc822".</p>
-</div>
-<div class="paragraph">
-<p>Supports the <strong>passThrough</strong> init parameter (true if missing).</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="NotifyPostmaster">
- <sender>*an address or postmaster or sender or unaltered, default=postmaster*</sender>
- <attachError>*true or false, default=false*</attachError>
- <message>*notice attached to the original message text (optional)*</message>
- <prefix>*optional subject prefix prepended to the original message, default="Re:"*</prefix>
- <inline>*default=none*</inline>
- <attachment>*default=message*</attachment>
- <passThrough>*true or false, default=true*</passThrough>
- <fakeDomainCheck>*true or false, default=true*</fakeDomainCheck>
- <to>*unaltered (optional, defaults to postmaster)*</to>
- <debug>*true or false, default=false*</debug>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The behaviour of this mailet is equivalent to using Resend with the following
-configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="Resend">
- <sender>*an address or postmaster or sender or unaltered*</sender>
- <attachError>*true or false*</attachError>
- <message>*<b>dynamically built</b>*</message>
- <prefix>*a string*</prefix>
- <passThrough>*true or false*</passThrough>
- <fakeDomainCheck>*true or false*</fakeDomainCheck>
- <to>*<b>unaltered or postmaster</b>*</to>
- <recipients><b>postmaster</b></recipients>
- <inline>see {@link Resend}</inline>
- <attachment>see {@link Resend}</attachment>
- <isReply>true</isReply>
- <debug>*true or false*</debug>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>notice</strong>, <strong>sendingAddress</strong> and <strong>attachError</strong> can be used
-instead of <strong>message</strong>, <strong>sender</strong> and <strong>attachError</strong>; such names
-are kept for backward compatibility.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_notifysender"><a class="anchor" href="#_notifysender"></a>NotifySender</h3>
-<div class="paragraph">
-<p>Sends a notification message to the sender of a message.</p>
-</div>
-<div class="paragraph">
-<p>A sender of the notification message can optionally be specified. If one is
-not specified, the postmaster’s address will be used.</p>
-</div>
-<div class="paragraph">
-<p>The "To:" header of the notification message can be set to "unaltered"; if
-missing will be set to the sender of the notified message.</p>
-</div>
-<div class="paragraph">
-<p>A notice text can be specified, and in such case will be inserted into the
-notification inline text.</p>
-</div>
-<div class="paragraph">
-<p>If the notified message has an "error message" set, it will be inserted into
-the notification inline text. If the <strong>attachError</strong> init
-parameter is set to true, such error message will be attached to the
-notification message.</p>
-</div>
-<div class="paragraph">
-<p>The notified messages are attached in their entirety (headers and content)
-and the resulting MIME part type is "message/rfc822".</p>
-</div>
-<div class="paragraph">
-<p>Supports the <strong>passThrough</strong> init parameter (true if missing).</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="NotifySender">
- <sender>*an address or postmaster or sender or unaltered, default=postmaster*</sender>
- <attachError>*true or false, default=false*</attachError>
- <prefix>*optional subject prefix prepended to the original message*</prefix>
- <inline>default=none*</inline>
- <attachment>default=message*</attachment>
- <passThrough>*true or false, default=true*</passThrough>
- <fakeDomainCheck>*true or false, default=true*</fakeDomainCheck>
- <to>*unaltered or sender or from(optional, defaults to sender)*</to>
- <debug>*true or false, default=false*</debug>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The behaviour of this mailet is equivalent to using Resend with the following
-configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="Resend">
- <sender>*an address or postmaster or sender or unaltered*</sender>
- <attachError>*true or false*</attachError>
- <message>*<b>dynamically built</b>*</message>
- <prefix>*a string*</prefix>
- <passThrough>true</passThrough>
- <fakeDomainCheck>*true or false*</fakeDomainCheck>
- <to>*unaltered or sender or from&lt*;/to>
- <recipients><b>sender</b></recipients>
- <inline>none</inline>
- <attachment>message</attachment>
- <isReply>true</isReply>
- <debug>*true or false*</debug>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>notice</strong>, <strong>sendingAddress</strong> and <strong>attachError</strong> can be used
-instead of <strong>message</strong>, <strong>sender</strong> and <strong>attachError</strong>; such names
-are kept for backward compatibility.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_null"><a class="anchor" href="#_null"></a>Null</h3>
-<div class="paragraph">
-<p>Simplest Mailet which destroys any incoming messages by setting their state to GHOST.</p>
-</div>
-<div class="paragraph">
-<p>This effectively stops all processing of this mail.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_postmasteralias"><a class="anchor" href="#_postmasteralias"></a>PostmasterAlias</h3>
-<div class="paragraph">
-<p>Rewrites recipient addresses to make sure email for the postmaster is
-always handled. This mailet is silently inserted at the top of the root
-spool processor. All recipients mapped to postmaster@<servernames> are
-changed to the postmaster account as specified in the server conf.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_randomstoring"><a class="anchor" href="#_randomstoring"></a>RandomStoring</h3>
-<div class="paragraph">
-<p>Process messages and randomly assign them to 4 to 8 mailboxes.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_recipientrewritetable"><a class="anchor" href="#_recipientrewritetable"></a>RecipientRewriteTable</h3>
-<div class="paragraph">
-<p>Mailet which should get used when using RecipientRewriteTable-Store to
-implementations for mappings of forwards and aliases.</p>
-</div>
-<div class="paragraph">
-<p>By specifying an 'errorProcessor' you can specify your logic upon RecipientRewriteTable failures.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> <mailet match="All" class="RecipientRewriteTable">
- <errorProcessor>rrt-errors</errorProcessor>
- </mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The <strong>rewriteSenderUponForward</strong> option (default to true) can be used to prevent senders to be rewritten upon forwards in the transport envelope
-(JAMES 3.8.0 default behaviour). <strong>WARNING</strong>: Please note that not rewriting the sender will cause issues forwarding emails
-from external senders to external addresses as the DKIM and SPF records will not be matching the ones of the sending
-domain.</p>
-</div>
-<div class="paragraph">
-<p>The <strong>forwardAutoSubmittedEmails</strong> option (default to false) can be used to prevent forwarding bounces as such a scenario
-can lead to an infinite loop if the forward recipient bounces the email.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_recipienttolowercase"><a class="anchor" href="#_recipienttolowercase"></a>RecipientToLowerCase</h3>
-<div class="paragraph">
-<p>GenericMailet which convert all Recipients to lowercase.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_redirect"><a class="anchor" href="#_redirect"></a>Redirect</h3>
-<div class="paragraph">
-<p>A mailet providing configurable redirection services.</p>
-</div>
-<div class="paragraph">
-<p>Can produce listserver, forward and notify behaviour, with the original
-message intact, attached, appended or left out altogether.</p>
-</div>
-<div class="paragraph">
-<p>It differs from Resend because (i) some defaults are different,
-notably for the following parameters: <strong><recipients></strong>,
-<strong><to></strong>, <strong><reversePath></strong> and <strong><inline></strong>; (ii)
-because it allows the use of the <strong><static></strong> parameter;.</p>
-</div>
-<div class="paragraph">
-<p>Use <code>Resend</code> if you need full control, <code>Redirect</code> if
-the more automatic behaviour of some parameters is appropriate.</p>
-</div>
-<div class="paragraph">
-<p>This built in functionality is controlled by the configuration as laid out
-below. In the table please note that the parameters controlling message
-headers accept the <b>"unaltered"</b> value, whose meaning is to
-keep the associated header unchanged and, unless stated differently,
-corresponds to the assumed default if the parameter is missing.</p>
-</div>
-<div class="paragraph">
-<p>The configuration parameters are:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. Redirect parameters</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">recipients</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A comma delimited list of addresses for recipients of this message; it will
-use the "to" list if not specified, and "unaltered" if
-none of the lists is specified.</p>
-<p class="tableblock">These addresses will only appear in the To: header if no "to" list
-is supplied.</p>
-<p class="tableblock">Such addresses can contain "full names", like <strong>Mr. John D. Smith
-<<a href="mailto:john.smith@xyz.com">john.smith@xyz.com</a>></strong>.</p>
-<p class="tableblock">The list can include constants "sender", "from",
-"replyTo", "postmaster", "reversePath",
-"recipients", "to", "null" and
-"unaltered"; "replyTo" uses the ReplyTo header if
-available, otherwise the From header if available, otherwise the Sender
-header if available, otherwise the return-path; "from" is made
-equivalent to "sender", and "to" is made equivalent to
-"recipients"; "null" is ignored.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">to</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A comma delimited list of addresses to appear in the To: header; the email
-will be delivered to any of these addresses if it is also in the recipients
-list.</p>
-<p class="tableblock">The recipients list will be used if this list is not supplied; if none of the
-lists is specified it will be "unaltered".</p>
-<p class="tableblock">Such addresses can contain "full names", like <strong>Mr. John D. Smith
-<<a href="mailto:john.smith@xyz.com">john.smith@xyz.com</a>></strong>.</p>
-<p class="tableblock">The list can include constants "sender", "from",
-"replyTo", "postmaster", "reversePath",
-"recipients", "to", "null" and
-"unaltered"; "from" uses the From header if available,
-otherwise the Sender header if available, otherwise the return-path;
-"replyTo" uses the ReplyTo header if available, otherwise the From
-header if available, otherwise the Sender header if available, otherwise the
-return-path; "recipients" is made equivalent to "to"; if
-"null" is specified alone it will remove this header.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">sender</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">single email address to appear in the From: and Return-Path: headers and
-become the sender.</p>
-<p class="tableblock">It can include constants "sender", "postmaster" and
-"unaltered"; "sender" is equivalent to
-"unaltered".</p>
-<p class="tableblock">Default: "unaltered".</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">message</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A text message to insert into the body of the email.</p>
-<p class="tableblock">Default: no message is inserted.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">inline</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">One of the following items:</p>
-<p class="tableblock">* unaltered The original message is the new
-message, for forwarding/aliasing
-* heads The
-headers of the original message are appended to the message
-* body The
-body of the original is appended to the new message
-*
-all &nbsp
-; Both headers and body are appended
-* none
-Neither body nor headers are appended
-</ul>
-Default: "body".</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">attachment</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">One of the following items:</p>
-<p class="tableblock">* heads The headers of the original are
-attached as text
-* body The body of the original is
-attached as text
-* all Both
-headers and body are attached as a single text file
-* none Nothing is attached
-* message The original message is attached as type message/rfc822,
-this means that it can, in many cases, be opened, resent, fw’d, replied to
-etc by email client software.</p>
-<p class="tableblock">Default: "none".</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">passThrough</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false, if true the original message continues in the mailet processor
-after this mailet is finished. False causes the original to be stopped.</p>
-<p class="tableblock">Default: false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">fakeDomainCheck</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false, if true will check if the sender domain is valid.</p>
-<p class="tableblock">Default: true.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">attachError</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false, if true any error message available to the mailet is appended
-to the message body (except in the case of inline == unaltered).</p>
-<p class="tableblock">Default: false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">replyTo</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A single email address to appear in the Reply-To: header.</p>
-<p class="tableblock">It can include constants "sender", "postmaster"
-"null" and "unaltered"; if "null" is specified
-it will remove this header.</p>
-<p class="tableblock">Default: "unaltered".</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">reversePath</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A single email address to appear in the Return-Path: header.</p>
-<p class="tableblock">It can include constants "sender", "postmaster" and
-"null"; if "null" is specified then it will set it to <>,
-meaning "null return path".</p>
-<p class="tableblock">Notice: the "unaltered" value is <strong>not allowed</strong>.</p>
-<p class="tableblock">Default: the value of the <strong><sender></strong> parameter, if set, otherwise
-remains unaltered.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">subject</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">An optional string to use as the subject.</p>
-<p class="tableblock">Default: keep the original message subject.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">prefix</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">An optional subject prefix prepended to the original message subject, or to a
-new subject specified with the <strong><subject></strong> parameter.</p>
-<p class="tableblock">For example: <strong>[Undeliverable mail]</strong>.</p>
-<p class="tableblock">Default: ".</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">isReply</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false, if true the IN_REPLY_TO header will be set to the id of the
-current message.</p>
-<p class="tableblock">Default: false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">debug</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false. If this is true it tells the mailet to write some debugging
-information to the mailet log.</p>
-<p class="tableblock">Default: false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">static</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false. If this is true it tells the mailet that it can reuse all the
-initial parameters (to, from, etc) without re-calculating their values. This
-will boost performance where a redirect task doesn’t contain any dynamic
-values. If this is false, it tells the mailet to recalculate the values for
-each e-mail processed.</p>
-<p class="tableblock">Default: false.</p></td>
-</tr>
-</tbody>
-</table>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> <mailet match="RecipientIs=test@localhost" class="Redirect">
- <recipients>x@localhost, y@localhost, z@localhost</recipients>
- <to>list@localhost</to>
- <sender>owner@localhost</sender>
- <message>sent on from James</message>
- <inline>unaltered</inline>
- <passThrough>FALSE</passThrough>
- <replyTo>postmaster</replyTo>
- <prefix xml:space="preserve">[test mailing] </prefix>
- <!-- note the xml:space="preserve" to preserve whitespace -->
- <static>TRUE</static>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>and:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> <mailet match="All" class="Redirect">
- <recipients>x@localhost</recipients>
- <sender>postmaster</sender>
- <message xml:space="preserve">Message marked as spam:</message>
- <inline>heads</inline>
- <attachment>message</attachment>
- <passThrough>FALSE</passThrough>
- <attachError>TRUE</attachError>
- <replyTo>postmaster</replyTo>
- <prefix>[spam notification]</prefix>
- <static>TRUE</static>
- </mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>replyto</strong> can be used instead of <strong>replyTo</strong>; such name is kept for
-backward compatibility.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_remotedelivery"><a class="anchor" href="#_remotedelivery"></a>RemoteDelivery</h3>
-<div class="paragraph">
-<p>The RemoteDelivery mailet delivers messages to a remote SMTP server able to deliver or forward messages to their final
-destination.</p>
-</div>
-<div class="paragraph">
-<p>The remote SMTP server through which each mail is delivered is resolved using MX lookup for each message destination
-unless the <strong><gateway/></strong> parameter is set. The <strong><gateway/></strong> parameter enables the
-definition of one or more gateway servers through which all messages are sent.</p>
-</div>
-<div class="paragraph">
-<p>If an attempt to deliver a message fails, a redelivery attempt is scheduled according to the scheme defined
-by the <strong><delayTime/></strong> parameter, retrying up to the limit defined
-by the <strong><maxRetries/></strong> parameter. When the retry limit is exceeded, delivery failure is processed
-according to the setting of the <strong><bounceProcessor/></strong> parameter.</p>
-</div>
-<div class="paragraph">
-<p>These are the parameters that control the operation of the RemoteDelivery mailet:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>outgoing</strong> (required) - a String containing the name of the queue that will hold messages being processed by this mailet.</p>
-</li>
-<li>
-<p><strong>bind</strong> (optional) - a String describing the local IP address to which the mailet should be bound while delivering
-emails. This tag is useful for multihomed machines. Default is to bind to the default local address of the machine.<br>
-Note: The same IP address must be used for all of those RemoteDelivery instances where you explicitly supply a bind address.</p>
-</li>
-<li>
-<p><strong>delayTime</strong> (optional) a String containing a comma separated list of patterns defining the number of and delays between delivery
-attempts. The pattern is <strong>[attempts\</strong>]delay [unit]* where:</p>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>attempts</strong> (optional) - an Integer for the number of delivery attempts. Default is 1.</p>
-</li>
-<li>
-<p><strong>delay</strong> (required) - a Long for the delay between attempts.</p>
-</li>
-<li>
-<p><strong>unit</strong> (optional) - a String with the value of one of 'msec', 'sec', 'minute', 'hour', or 'day'. Default is msec.</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Default is one attempt after 6 hours, which if explicitly declared would be written as <strong><delayTime>1 6 hour</delayTime></strong></p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>maxRetries</strong> (optional) an Integer for the number of times an attempt is made to deliver a particular mail.
-Default is the greater of five and the sum of the attempts for each <strong><delayTime/></strong> specified.</p>
-</li>
-<li>
-<p><strong>maxDnsProblemRetries</strong> (optional) - an Integer for the number of times to retry if DNS problems for a domain occur.
-Default is 0.</p>
-</li>
-<li>
-<p><strong>timeout</strong> (optional) - an Integer for the Socket I/O timeout in milliseconds. Default is 180000</p>
-</li>
-<li>
-<p><strong>connectionTimeout</strong> (optional) - an Integer for the Socket connection timeout in milliseconds. Default is 60000</p>
-</li>
-<li>
-<p><strong>bounceProcessor</strong> (optional) - a String containing the name of the mailet processor to pass messages that cannot
-be delivered to for DSN bounce processing. Default is to send a traditional message containing the bounce details.</p>
-</li>
-<li>
-<p><strong>onSuccess</strong> (optional) - if specified, this processor is called for each email successfully sent to remote third parties.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>When using bounceProcessor or onSuccess processors, take special care of error handling (see onMailetException and onMatcherException)
- to avoid confusing situations. Also remember that on partial delivery, both processors will be used: <strong>onSuccess</strong> with successfull recipients,
- and <strong>bounceProcessor</strong> with failed recipients.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>startTLS</strong> (optional) - a Boolean (true/false) indicating whether the STARTTLS command (if supported by the server)
-to switch the connection to a TLS-protected connection before issuing any login commands. Default is false.</p>
-</li>
-<li>
-<p><strong>sslEnable</strong> (optional) - a Boolean (true/false) indicating whether to use SSL to connect and use the SSL port unless
-explicitly overridden. Default is false. Setting up to true will result in delivery attempts in SMTPS on port 465 with a fallback
-to SMTP on port 25. The trust-store if needed can be customized by <strong>-Djavax.net.ssl.trustStore=/root/conf/keystore</strong>.</p>
-</li>
-<li>
-<p><strong>verifyServerIdentity</strong> (optional) - a Boolean (true/false) indicating whether to match the remote server name against its certificate on TLS connections. Default is true. Disabling this runs the risk of someone spoofing a legitimate server and intercepting mails, but may be necessary to contact servers that have strange certificates, no DNS entries, are reachable by IP address only, and similar edge cases.</p>
-</li>
-<li>
-<p><strong>gateway</strong> (optional) - a String containing a comma separated list of patterns defining the gateway servers to be used to
-deliver mail regardless of the recipient address. If multiple gateway servers are defined, each will be tried in definition order
-until delivery is successful. If none are successful, the mail is bounced. The pattern is <strong>host[:port]</strong> where:</p>
-</li>
-<li>
-<p><strong>host</strong> (required) - the FQN of the gateway server.</p>
-</li>
-<li>
-<p><strong>port</strong> (optional) - the port of the gateway server. Default is the value defined in the <strong><gatewayPort/></strong>
-parameter if set, else the default port for the specified connection type.
-Default is to resolve the destination SMTP server for each mail using MX lookup.</p>
-</li>
-<li>
-<p><strong>gatewayPort</strong> (optional) - an Integer for the gateway port to be used for each defined gateway server for which a
-port is not explicitly defined in the <strong><gateway/></strong> parameter. Default is the default port for the specified connection type.</p>
-</li>
-<li>
-<p><strong>gatewayUsername</strong> (optional) - a String containing the user name to be used to authenticate the user using the
-AUTH command. Default is not to issue the AUTH command.</p>
-</li>
-<li>
-<p><strong>gatewayPassword</strong> (required if <strong>gatewayUsername</strong>) is set - a String representing the password to be used
-to authenticate the user using the AUTH command.</p>
-</li>
-<li>
-<p><strong>loadBalancing</strong> (optional) - a Boolean (true/false) indicating whether load should be balanced randomly over all defined gateway server. Default is true, false leads to failover only.</p>
-</li>
-<li>
-<p><strong>heloName</strong> (optional) - a String containing the name used in the SMTP HELO and EHLO commands. Default is the default domain,
-which is typically <strong>localhost</strong>.</p>
-</li>
-<li>
-<p><strong>mail.</strong>* (optional) - Any property beginning with <strong>mail.</strong> described in the Javadoc for package
-<a href="https://eclipse-ee4j.github.io/angus-mail/docs/api/org.eclipse.angus.mail/org/eclipse/angus/mail/smtp/package-summary.html">*org.eclipse.angus.mail.smtp*</a>
-can be set with a parameter of the corresponding name. For example the parameter
-<strong><mail.smtp.ssl.enable>true</mail.smtp.ssl.enable></strong> is equivalent to the Java code
-<strong>props.put("mail.smtp.ssl.enable", "true");</strong>. Properties set by this facility override settings made
-within the mailet code.<br>
-Note: This facility should be used with extreme care by expert users with a thorough knowledge of the relevant RFCs and
-the ability to perform their own problem resolutions.</p>
-</li>
-<li>
-<p><strong>debug</strong> (optional) - a Boolean (true/false) indicating whether debugging is on. Default is false.</p>
-</li>
-</ul>
-</div>
-<div class="sect3">
-<h4 id="_security"><a class="anchor" href="#_security"></a>Security</h4>
-<div class="paragraph">
-<p>You can use the <strong>sslEnable</strong> parameter described above to force SMTP outgoing delivery to default to SSL encrypted traffic (SMTPS).
-This is a shortcut for the <strong>mail.smtps.ssl.enable</strong> javax property.</p>
-</div>
-<div class="paragraph">
-<p>When enabling SSL, you might need to specify the <strong>mail.smtps.ssl.trust</strong> property as well.
-You can also control ciphersuites and protocols via <strong>mail.smtps.ssl.ciphersuites</strong> and
-<strong>mail.smtps.ssl.protocols</strong> properties.</p>
-</div>
-<div class="paragraph">
-<p>StartTLS can alternatively be enabled upon sending a mail. For this, use the <strong>startTls</strong> parameter, serving as a shortcut for the
-javax <strong>mail.smtp.starttls.enable</strong> property. Depending on how strict your security policy is, you might consider
-<strong>mail.smtp.starttls.required</strong> as well. Be aware that configuring trust will then be required.
-You can also use other javax properties for StartTLS, but their property prefix must be <strong>mail.smtp.ssl.</strong> in this case.</p>
-</div>
-<div class="paragraph">
-<p>James enables server identity verification by default. In certain rare edge cases you might disable it via the <strong>verifyServerIdentity</strong> parameter,
-or use the <strong>mail.smtps.ssl.checkserveridentity</strong> and <strong>mail.smtp.ssl.checkserveridentity</strong> javax properties for fine control.</p>
-</div>
-<div class="paragraph">
-<p>Read <a href="https://eclipse-ee4j.github.io/angus-mail/docs/api/org.eclipse.angus.mail/org/eclipse/angus/mail/smtp/package-summary.html"><strong>org.eclipse.angus.mail.smtp</strong></a>
-for full information.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_removeallmailattributes"><a class="anchor" href="#_removeallmailattributes"></a>RemoveAllMailAttributes</h3>
-<div class="paragraph">
-<p>This mailet sets removes all attributes set on the Mail instance</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="RemoveAllMailAttributes"/></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_removemailattribute"><a class="anchor" href="#_removemailattribute"></a>RemoveMailAttribute</h3>
-<div class="paragraph">
-<p>This mailet sets attributes on the Mail.</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="RemoveMailAttribute">
- <name>attribute_name1</name>
- <name>attribute_name2</name>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_removemimeheader"><a class="anchor" href="#_removemimeheader"></a>RemoveMimeHeader</h3>
-<div class="paragraph">
-<p>Remove mime headers from the message (global) and per recipient (specific).</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="RemoveMimeHeader">
- <name>header1,header2</name>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_removemimeheader_2"><a class="anchor" href="#_removemimeheader_2"></a>RemoveMimeHeader</h3>
-<div class="paragraph">
-<p>This mailet removes all of the headers starting with a given prefix in the message (global) and per recipient (specific).</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="RemoveMimeHeaderByPrefix">
- <name>X-APPLICATIVE-HEADER-</name>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_replacecontent"><a class="anchor" href="#_replacecontent"></a>ReplaceContent</h3>
-<div class="paragraph">
-<p>Replace text contents</p>
-</div>
-<div class="paragraph">
-<p>This mailet allow to specific regular expression to replace text in subject and content.</p>
-</div>
-<div class="paragraph">
-<p>Each expression is defined as: <strong>/REGEX_PATTERN/SUBSTITUTION_PATTERN/FLAGS/</strong></p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>REGEX_PATTERN</strong> is a regex used for the match</p>
-</li>
-<li>
-<p><strong>SUBSTITUTION_PATTERN</strong> is a substitution pattern</p>
-</li>
-<li>
-<p><strong>FLAGS</strong> flags supported for the pattern:</p>
-<div class="ulist">
-<ul>
-<li>
-<p>i: case insensitive</p>
-</li>
-<li>
-<p>m: multi line</p>
-</li>
-<li>
-<p>x: extended (N/A)</p>
-</li>
-<li>
-<p>r: repeat - keep matching until a substitution is possible</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>To identify subject and body pattern we use the tags <subjectPattern> and <bodyPattern></p>
-</div>
-<div class="paragraph">
-<p>Rules can be specified in external files.
-Lines must be CRLF terminated and lines starting with # are considered comments.
-Tags used to include external files are <subjectPatternFile> and
-<bodyPatternFile>
-If file path starts with # then the file is loaded as a resource.</p>
-</div>
-<div class="paragraph">
-<p>Use of both files and direct patterns at the same time is allowed.</p>
-</div>
-<div class="paragraph">
-<p>This mailet allow also to enforce the resulting charset for messages processed, when a replacement has been done.
-To do that the tag <charset> must be specified.</p>
-</div>
-<div class="paragraph">
-<p>NOTE:
-Regexp rules must be escaped by regexp escaping rules and applying this 2 additional rules:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>"/" char inside an expression must be prefixed with "\":
-e.g: "/\//-//" replaces "/" with "-"</p>
-</li>
-<li>
-<p>when the rules are specified using <subjectPattern> or <bodyPattern> and
-"/,/" has to be used in a pattern string it must be prefixed with a "\".
-E.g: "/\/\/,//" replaces "/" with "," (the rule would be "/\//,//" but the "/,/" must
-be escaped.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_resend"><a class="anchor" href="#_resend"></a>Resend</h3>
-<div class="paragraph">
-<p>A mailet providing configurable redirection services.</p>
-</div>
-<div class="paragraph">
-<p>Can produce listserver, forward and notify behaviour, with the original
-message intact, attached, appended or left out altogether. Can be used as a
-replacement to {@link Redirect}, having more consistent defaults, and new
-options available.</p>
-</div>
-<div class="paragraph">
-<p>Use <code>Resend</code> if you need full control, <code>Redirect</code> if
-the more automatic behaviour of some parameters is appropriate.</p>
-</div>
-<div class="paragraph">
-<p>This built in functionality is controlled by the configuration as laid out
-below. In the table please note that the parameters controlling message
-headers accept the <b>"unaltered"</b> value, whose meaning is to
-keep the associated header unchanged and, unless stated differently,
-corresponds to the assumed default if the parameter is missing.</p>
-</div>
-<div class="paragraph">
-<p>The configuration parameters are:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 2. Resend properties</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">recipients</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A comma delimited list of addresses for recipients of this message.</p>
-<p class="tableblock">Such addresses can contain "full names", like <strong>Mr. John D. Smith
-<<a href="mailto:john.smith@xyz.com">john.smith@xyz.com</a>></strong>.</p>
-<p class="tableblock">The list can include constants "sender", "from",
-"replyTo", "postmaster", "reversePath",
-"recipients", "to", "null" and
-"unaltered"; "replyTo" uses the ReplyTo header if
-available, otherwise the From header if available, otherwise the Sender
-header if available, otherwise the return-path; "from" is made
-equivalent to "sender", and "to" is made equivalent to
-"recipients"; "null" is ignored. Default:
-"unaltered".</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">to</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A comma delimited list of addresses to appear in the To: header.</p>
-<p class="tableblock">Such addresses can contain "full names", like <strong>Mr. John D. Smith
-<<a href="mailto:john.smith@xyz.com">john.smith@xyz.com</a>></strong>.</p>
-<p class="tableblock">The list can include constants "sender", "from",
-"replyTo", "postmaster", "reversePath",
-"recipients", "to", "null" and
-"unaltered"; "from" uses the From header if available,
-otherwise the Sender header if available, otherwise the return-path;
-"replyTo" uses the ReplyTo header if available, otherwise the From
-header if available, otherwise the Sender header if available, otherwise the
-return-path; "recipients" is made equivalent to "to"; if
-"null" is specified alone it will remove this header. Default:
-"unaltered".</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">sender</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A single email address to appear in the From: header and become the sender.</p>
-<p class="tableblock">It can include constants "sender", "postmaster" and
-"unaltered"; "sender" is equivalent to
-"unaltered".</p>
-<p class="tableblock">Default: "unaltered".</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">message</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A text message to insert into the body of the email.</p>
-<p class="tableblock">Default: no message is inserted.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">inline</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">One of the following items:
-</p>
-<ul>
-* unaltered The original message is the new
-message, for forwarding/aliasing
-* heads The
-headers of the original message are appended to the message
-* body The
-body of the original is appended to the new message
-*
-all &nbsp
-; Both headers and body are appended
-* none
-Neither body nor headers are appended</p>
-<p class="tableblock">Default: "unaltered".</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">attachment</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">One of the following items:</p>
-<p class="tableblock">* heads The headers of the original are
-attached as text
-* body The body of the original is
-attached as text
-* all Both
-headers and body are attached as a single text file
-* none Nothing is attached
-* message The original message is attached as type message/rfc822,
-this means that it can, in many cases, be opened, resent, fw’d, replied to
-etc by email client software.</p>
-<p class="tableblock">Default: "none".</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">passThrough</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false, if true the original message continues in the mailet processor
-after this mailet is finished. False causes the original to be stopped.</p>
-<p class="tableblock">Default: false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">fakeDomainCheck</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false, if true will check if the sender domain is valid.</p>
-<p class="tableblock">Default: true.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">attachError</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false, if true any error message available to the mailet is appended
-to the message body (except in the case of inline == unaltered).</p>
-<p class="tableblock">Default: false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">replyTo</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A single email address to appear in the Reply-To: header.</p>
-<p class="tableblock">It can include constants "sender", "postmaster"
-"null" and "unaltered"; if "null" is specified
-it will remove this header.</p>
-<p class="tableblock">Default: "unaltered".</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">reversePath</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A single email address to appear in the Return-Path: header.</p>
-<p class="tableblock">It can include constants "sender", "postmaster"
-"null" and "unaltered"; if "null" is specified
-then it will set it to <>, meaning "null return path".</p>
-<p class="tableblock">Default: "unaltered".</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">subject</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">An optional string to use as the subject.</p>
-<p class="tableblock">Default: keep the original message subject.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">prefix</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">An optional subject prefix prepended to the original message subject, or to a
-new subject specified with the <strong><subject></strong> parameter.</p>
-<p class="tableblock">For example: <strong>[Undeliverable mail]</strong>.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">isReply</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false, if true the IN_REPLY_TO header will be set to the id of the
-current message.</p>
-<p class="tableblock">Default: false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">debug</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false. If this is true it tells the mailet to write some debugging
-information to the mailet log.</p>
-<p class="tableblock">Default: false.</p></td>
-</tr>
-</tbody>
-</table>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> <mailet match="RecipientIs=test@localhost" class="Resend">
- <recipients>x@localhost, y@localhost, z@localhost</recipients>
- <to>list@localhost</to>
- <sender>owner@localhost</sender>
- <message>sent on from James</message>
- <inline>unaltered</inline>
- <passThrough>FALSE</passThrough>
- <replyTo>postmaster</replyTo>
- <prefix xml:space="preserve">[test mailing] </prefix>
- <!-- note the xml:space="preserve" to preserve whitespace -->
- <static>TRUE</static>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>and:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> <mailet match="All" class="Resend">
- <recipients>x@localhost</recipients>
- <sender>postmaster</sender>
- <message xml:space="preserve">Message marked as spam:</message>
- <inline>heads</inline>
- <attachment>message</attachment>
- <passThrough>FALSE</passThrough>
- <attachError>TRUE</attachError>
- <replyTo>postmaster</replyTo>
- <prefix>[spam notification]</prefix>
- </mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The following example forwards the message without any modification, based on
-the defaults:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> <mailet match="All" class="Resend&quot/;></pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>replyto</strong> can be used instead of <strong>replyTo</strong>; such name is kept for
-backward compatibility.</p>
-</div>
-<div class="admonitionblock warning">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-warning" title="Warning"></i>
-</td>
-<td class="content">
-as the message (or a copy of it) is reinjected in the spool
-without any modification, the preceding example is very likely to cause a
-"configuration loop" in your system, unless some other mailet has previously
-modified something (a header for instance) that could force the resent
-message follow a different path so that it does not return here
-unchanged.
-</td>
-</tr>
-</table>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_setmailattribute"><a class="anchor" href="#_setmailattribute"></a>SetMailAttribute</h3>
-<div class="paragraph">
-<p>This mailet sets attributes on the Mail.</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="SetMailAttribute">
- <name1>value1</name1>
- <name2>value2</name2>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_setmailattribute_2"><a class="anchor" href="#_setmailattribute_2"></a>SetMailAttribute</h3>
-<div class="paragraph">
-<p>Adds a specified header and value to the message.</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="AddHeader">
- <name>X-MailetHeader</name>
- <value>TheHeaderValue</value>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_sieve"><a class="anchor" href="#_sieve"></a>Sieve</h3>
-<div class="paragraph">
-<p>Execute Sieve scripts for incoming emails, and set the result of the execution as attributes of the mail</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_sign"><a class="anchor" href="#_sign"></a>Sign</h3>
-<div class="paragraph">
-<p>Puts a <strong>server-side</strong> SMIME signature on a message.</p>
-</div>
-<div class="paragraph">
-<p>It is a concrete subclass of Sign, with very few modifications to it,
-to specialize for SMIME.</p>
-</div>
-<div class="paragraph">
-<p>Handles the following init parameters:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><keyHolderClass>: Sets the class of the KeyHolder object that will handle the cryptography functions,
-for example org.apache.james.security.SMIMEKeyHolder for SMIME.</p>
-</li>
-<li>
-<p><debug>: if <strong>true</strong> some useful information is logged.
-The default is <strong>false</strong>.</p>
-</li>
-<li>
-<p><keyStoreFileName>: the {@link java.security.KeyStore} full file name.</p>
-</li>
-<li>
-<p><keyStorePassword>: the <strong>KeyStore</strong> password.
-If given, it is used to check the integrity of the keystore data,
-otherwise, if null, the integrity of the keystore is not checked.</p>
-</li>
-<li>
-<p><keyAlias>: the alias name to use to search the Key using {@link java.security.KeyStore#getKey}.
-The default is to look for the first and only alias in the keystore;
-if zero or more than one is found a {@link java.security.KeyStoreException} is thrown.</p>
-</li>
-<li>
-<p><keyAliasPassword>: the alias password. The default is to use the <strong>KeyStore</strong> password.
-At least one of the passwords must be provided.</p>
-</li>
-<li>
-<p><keyStoreType>: the type of the keystore. The default will use {@link java.security.KeyStore#getDefaultType}.</p>
-</li>
-<li>
-<p><postmasterSigns>: if <strong>true</strong> the message will be signed even if the sender is the Postmaster. The default is <strong>true</strong>.</p>
-</li>
-<li>
-<p><rebuildFrom>: If <strong>true</strong> will modify the "From:" header. The default is <strong>true</strong>.</p>
-</li>
-<li>
-<p><signerName>: the name of the signer to be shown in the explanation text. The default is to use the "CN="
-property of the signing certificate.</p>
-</li>
-<li>
-<p><explanationText>. There is a default explanation string template in English, displaying
-also all the headers of the original message.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_smimechecksignature"><a class="anchor" href="#_smimechecksignature"></a>SMIMECheckSignature</h3>
-<div class="paragraph">
-<p>Verifies the s/mime signature of a message. The s/mime signing ensure that
-the private key owner is the real sender of the message. To be checked by
-this mailet the s/mime signature must contain the actual signature, the
-signer’s certificate and optionally a set of certificate that can be used to
-create a chain of trust that starts from the signer’s certificate and leads
-to a known trusted certificate.</p>
-</div>
-<div class="paragraph">
-<p>This check is composed by two steps: firstly it’s ensured that the signature
-is valid, then it’s checked if a chain of trust starting from the signer
-certificate and that leads to a trusted certificate can be created. The first
-check verifies that the message has not been modified after the signature
-was put and that the signer’s certificate was valid at the time of the
-signing. The latter should ensure that the signer is who he declare to be.</p>
-</div>
-<div class="paragraph">
-<p>The results of the checks perfomed by this mailet are wrote as a mail
-attribute which default name is org.apache.james.SMIMECheckSignature (it can
-be changed using the mailet parameter <strong>mailAttribute</strong>). After
-the check this attribute will contain a list of SMIMESignerInfo object, one
-for each message’s signer. These objects contain the signer’s certificate and
-the trust path.</p>
-</div>
-<div class="paragraph">
-<p>Optionally, specifying the parameter <strong>strip</strong>, the signature of
-the message can be stripped after the check. The message will become a
-standard message without an attached s/mime signature.</p>
-</div>
-<div class="paragraph">
-<p>The configuration parameter of this mailet are summerized below. The firsts
-defines the location, the format and the password of the keystore containing
-the certificates that are considered trusted. Note: only the trusted certificate
-entries are read, the key ones are not.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>keyStoreType (default: jks): Certificate store format . "jks" is the
-standard java certificate store format, but pkcs12 is also quite common and
-compatible with standard email clients like Outlook Express and Thunderbird.</p>
-</li>
-<li>
-<p>keyStoreFileName (default: JAVA_HOME/jre/lib/security/cacert): Certificate
-store path.</p>
-</li>
-<li>
-<p>keyStorePassword (default: ""): Certificate store password.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Other parameters configure the behavior of the mailet:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>strip (default: false): Defines if the s/mime signature of the message
-have to be stripped after the check or not. Possible values are true and
-false.</p>
-</li>
-<li>
-<p>mailAttribute (default: org.apache.james.SMIMECheckSignature):
-specifies in which attribute the check results will be written.</p>
-</li>
-<li>
-<p>onlyTrusted (default: true): Usually a message signature to be
-considered by this mailet as authentic must be valid and trusted. Setting
-this mailet parameter to "false" the last condition is relaxed and also
-"untrusted" signature are considered will be considered as authentic.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_smimedecrypt"><a class="anchor" href="#_smimedecrypt"></a>SMIMEDecrypt</h3>
-<div class="paragraph">
-<p>This mailet decrypts a s/mime encrypted message. It takes as input an
-encrypted message and it tries to dechiper it using the key specified in its
-configuration. If the decryption is successful the mail will be changed and
-it will contain the decrypted message. The mail attribute
-<strong>org.apache.james.SMIMEDecrypt</strong> will contain the public
-certificate of the key used in the process.</p>
-</div>
-<div class="paragraph">
-<p>The configuration parameters of this mailet are summarized below. The firsts
-define the keystore where the key that will be used to decrypt messages is
-saved.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>keyStoreType (default: system dependent): defines the type of the store.
-Usually jks, pkcs12 or pkcs7</p>
-</li>
-<li>
-<p>keyStoreFileName (mandatory): private key store path.</p>
-</li>
-<li>
-<p>keyStorePassword (default: ""): private key store password</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The other parameters define which private key have to be used. (if the store
-contains more than one key).</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>keyAlias: private key alias.</p>
-</li>
-<li>
-<p>keyPass: private key password</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_smimesign"><a class="anchor" href="#_smimesign"></a>SMIMESign</h3>
-<div class="paragraph">
-<p>Puts a <strong>server-side</strong> signature on a message.</p>
-</div>
-<div class="paragraph">
-<p>It is a concrete subclass of AbstractSign, with very few modifications to it.</p>
-</div>
-<div class="paragraph">
-<p>A text file with an explanation text is attached to the original message,
-and the resulting message with all its attachments is signed.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>The resulting appearance of the message is almost unchanged: only an extra attachment</p>
-</li>
-<li>
-<p>and the signature are added.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The kind of signature depends on the value of the <keyHolderClass> init parameter.</p>
-</div>
-<div class="paragraph">
-<p>Handles the following init parameters:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><keyHolderClass>: Sets the class of the KeyHolder object that will handle the cryptography functions,
-for example org.apache.james.security.SMIMEKeyHolder for SMIME.</p>
-</li>
-<li>
-<p><debug>: if <strong>true</strong> some useful information is logged.
-The default is <strong>false</strong>.</p>
-</li>
-<li>
-<p><keyStoreFileName>: the {@link java.security.KeyStore} full file name.</p>
-</li>
-<li>
-<p><keyStorePassword>: the <strong>KeyStore</strong> password.
-If given, it is used to check the integrity of the keystore data,
-otherwise, if null, the integrity of the keystore is not checked.</p>
-</li>
-<li>
-<p><keyAlias>: the alias name to use to search the Key using {@link java.security.KeyStore#getKey}.
-The default is to look for the first and only alias in the keystore;
-if zero or more than one is found a {@link java.security.KeyStoreException} is thrown.</p>
-</li>
-<li>
-<p><keyAliasPassword>: the alias password. The default is to use the <strong>KeyStore</strong> password.
-At least one of the passwords must be provided.</p>
-</li>
-<li>
-<p><keyStoreType>: the type of the keystore. The default will use {@link java.security.KeyStore#getDefaultType}.</p>
-</li>
-<li>
-<p><postmasterSigns>: if <strong>true</strong> the message will be signed even if the sender is the Postmaster. The default is <strong>true</strong>.</p>
-</li>
-<li>
-<p><rebuildFrom>: If <strong>true</strong> will modify the "From:" header. The default is <strong>true</strong>.</p>
-</li>
-<li>
-<p><signerName>: the name of the signer to be shown in the explanation text. The default is to use the "CN="
-property of the signing certificate.</p>
-</li>
-<li>
-<p><explanationText>. There is a default explanation string template in English, displaying
-also all the headers of the original message.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_spamassassin"><a class="anchor" href="#_spamassassin"></a>SpamAssassin</h3>
-<div class="paragraph">
-<p>Sends the message through daemonized SpamAssassin (spamd), visit
-<a href="http://spamassassin.apache.org">spamassassin.apache.org</a> for info
-on configuration. The header X-Spam-Status is added to every message, this
-contains the score and the threshold score for spam (usually 5.0). If the
-message exceeds the threshold, the header X-Spam-Flag will be added with the
-value of YES. The default host for spamd is localhost and the default port is
-783.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> org.apache.james.spamassassin.status - Holds the status
- org.apache.james.spamassassin.flag - Holds the flag</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Sample Configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet notmatch="SenderHostIsLocal" class="SpamAssassin">
- <spamdHost>localhost</spamdHost>
- <spamdPort>783</spamdPort>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_stripattachment"><a class="anchor" href="#_stripattachment"></a>StripAttachment</h3>
-<div class="paragraph">
-<p>Remove attachments from a Message. Supports simple removal, storing to file,
-or storing to mail attributes.</p>
-</div>
-<div class="paragraph">
-<p>Configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match=&quot;All&quot; class=&quot;StripAttachment&quot; >
- <pattern >.*\.xls </pattern> <!-- The regular expression that must be matched -- >
- <!-- notpattern >.*\.xls </notpattern--> <!-- The regular expression that must be matched -- >
- <mimeType>text/calendar</mimeType> <!-- The matching mimeType -- >
- <directory >c:\temp\james_attach </directory> <!-- The directory to save to -- >
- <remove >all </remove> <!-- either &quot;no&quot;, &quot;matched&quot;, &quot;all&quot; -- >
- <!-- attribute>my.attribute.name</attribute -->
-</mailet ></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>At least one of pattern, notpattern and mimeType is required.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_textcalendarbodytoattachment"><a class="anchor" href="#_textcalendarbodytoattachment"></a>TextCalendarBodyToAttachment</h3>
-<div class="paragraph">
-<p>This mailet converts Content-Type of MimeMessage from text/calendar to mulitpart/mixed</p>
-</div>
-<div class="paragraph">
-<p>The BodyPart should be retrieved from content of text/calendar with all the same "Content-*" headers from original message
-and those "Content-" header are removed from original message</p>
-</div>
-<div class="paragraph">
-<p>It does not takes any parameter</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="TextCalendarBodyToAttachment"/></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_toprocessor"><a class="anchor" href="#_toprocessor"></a>ToProcessor</h3>
-<div class="paragraph">
-<p>This mailet redirects the mail to the named processor</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="ToProcessor">
- <processor>spam</processor>
- <notice>Notice attached to the message (optional)</notice>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_torepository"><a class="anchor" href="#_torepository"></a>ToRepository</h3>
-<div class="paragraph">
-<p>Stores incoming Mail in the specified Repository.</p>
-</div>
-<div class="paragraph">
-<p>If the "passThrough" in conf is true the mail will be returned untouched in
-the pipe and may be processed by additional mailets. If false will be destroyed.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_tosenderdomainrepository"><a class="anchor" href="#_tosenderdomainrepository"></a>ToSenderDomainRepository</h3>
-<div class="paragraph">
-<p>Stores incoming Mail in a repository defined by the sender’s domain.<br></p>
-</div>
-<div class="paragraph">
-<p>Supported configuration parameters:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>"urlPrefix" mandatory: defines the prefix for the per sender’s domain repository. For example for the value
-'cassandra://var/mail/sendersRepositories/', a mail sent by '<a href="mailto:user@james.org">user@james.org</a>' will be stored
-in 'cassandra://var/mail/sendersRepositories/james.org'.</p>
-</li>
-<li>
-<p>"passThrough" optional, defaults to false. If true, the processing of the mail continues. If false it stops.</p>
-</li>
-<li>
-<p>"allowRepositoryCreation" optional, defaults to true. If true, non existing repository will be created. In case of
-misconfiguration, this might lead to arbitrary repository creation. If false, the incoming mails will be stored only
- in already existing repository. If not existing, the email will be dropped with an appropriate log warning (leading
- to potential data loss). In case, you want to create a repository manually, make a http PUT request to
- /mailRepositories/encodedUrlOfTheRepository from web admin api.
- For example <a href="http://ip:port/mailRepositories/file%3A%2F%2FmailRepo" class="bare">http://ip:port/mailRepositories/file%3A%2F%2FmailRepo</a></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="ToSenderDomainRepository">
- <urlPrefix>cassandra://var/mail/sendersRepositories/</urlPrefix>
- <passThrough>false</passThrough>
- <allowRepositoryCreation>true</allowRepositoryCreation>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_vacationmailet"><a class="anchor" href="#_vacationmailet"></a>VacationMailet</h3>
-<div class="paragraph">
-<p>This mailet uses <a href="https://jmap.io/spec-mail.html#vacation-response">JMAP VacationResponse</a> and
-sends back a vacation notice to the sender if needed.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_withpriority"><a class="anchor" href="#_withpriority"></a>WithPriority</h3>
-<div class="paragraph">
-<p>This mailet sets the priority of the incoming mail.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="WithPriority">
- <priority>7</priority>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_withstoragedirective"><a class="anchor" href="#_withstoragedirective"></a>WithStorageDirective</h3>
-<div class="paragraph">
-<p>WithStorageDirective position storage directive for the recipients of this email.</p>
-</div>
-<div class="paragraph">
-<p>These directives are used by <strong>LocalDelivery</strong> mailet when adding the email to the recipients mailboxes.</p>
-</div>
-<div class="paragraph">
-<p>The following storage directives can be set:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>targetFolderNames: the folders to append the email in. Defaults to none (INBOX). Coma separated list of folder names. Fallback to targetFolderName.</p>
-</li>
-<li>
-<p>targetFolderName: the folder to append the email in. Defaults to none (INBOX).</p>
-</li>
-<li>
-<p>seen: boolean, whether the message should be automatically marked as seen. Defaults to false.</p>
-</li>
-<li>
-<p>important: boolean, whether the message should be automatically marked as important. Defaults to false.</p>
-</li>
-<li>
-<p>keywords: set of string, encoded as a string (value are coma separated). IMAP user flags to set for the message. Defaults to none</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="IsMarkedAsSpam" class="WithStorageDirective">
- <targetFolderName>Spam</targetFolderName>
- <seen>true</seen>
- <important>true</important>
- <keywords>keyword1,keyword2</keywords>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Alternatively, several target folders can be specified:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="IsMarkedAsSpam" class="WithStorageDirective">
- <targetFolderNames>Important, INBOX</targetFolderNames>
- <seen>true</seen>
- <important>true</important>
- <keywords>keyword1,keyword2</keywords>
-</mailet></pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_experimental_mailets"><a class="anchor" href="#_experimental_mailets"></a>Experimental mailets</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_addhabeaswarrantmark"><a class="anchor" href="#_addhabeaswarrantmark"></a>AddHabeasWarrantMark</h3>
-<div class="paragraph">
-<p>This matcher adds the Hebeas Warrant Mark to a message.</p>
-</div>
-<div class="paragraph">
-<p>For details see: <a href="http://www.hebeas.com</p>" class="bare">http://www.hebeas.com</p></a>;</p>
-</div>
-<div class="paragraph">
-<p>Usage:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="AddHabeasWarrantMark" />;</pre>
-</div>
-</div>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-note" title="Note"></i>
-</td>
-<td class="content">
-Although this mailet is covered by the Apache Software License,
-the Habeas Warrant Mark is copyright. A separate license from Habeas
-is required in order to legally attach the Habeas Warrant Mark to
-e-mail messages. Each James Administrator is responsible for
-ensuring that James is configured to attach the Habeas Warrant Mark
-only to e-mail covered by a suitable license received from Habeas.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>Because the Habeas Warrant Mark is copyright material, I have asked
-for and received the following explicit statement from Habeas:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>-----------------------------------
-From: Lindsey Pettit [mailto:support@habeas.com]
-Sent: Sunday, September 29, 2002 5:51
-To: Noel J. Bergman
-Subject: RE: Habeas and Apache James
-*
-Dear Noel,
-*
-> FURTHERMORE, if James is to be capable of sending Habeas SWE, I need
-> to write a Mailet that attaches the headers. As with any MTA, it
-> would be up to the administrator to properly configure James and make
-> sure that licenses are acquired. Since the Habeas Warrant Mark is
-> copyright, I believe that I require authorization from you for that
-> Mailet, especially since it attaches the Habeas Warrant Mark. For my
-> own protection, please show me why such authorization is unnecessary,
-> send me a digitally signed e-mail, or FAX a signed authorization
-*
-You do not yourself need the authorization to build the functionality
-into the [mailet]; what one needs authorization, in the form of a
-license, for, is to use the mark *in headers*, in outgoing email.
-However, please let me know if you would like something more
-formal, and I can try to have something faxed to you.
-*
-> The Mailet docs would reference the Habeas website, and inform
-> administrators that in order to USE the mailet, they need to ensure
-> that they have whatever licenses are required from you as appropriate
-> to your licensing terms.
-*
-That's absolutely perfect!
------------------------------------</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_clamavscan"><a class="anchor" href="#_clamavscan"></a>ClamAVScan</h3>
-<div class="paragraph">
-<p>Does an antivirus scan check using a ClamAV daemon (CLAMD)</p>
-</div>
-<div class="paragraph">
-<p>Interacts directly with the daemon using the "stream" method,
-which should have the lowest possible overhead.</p>
-</div>
-<div class="paragraph">
-<p>The CLAMD daemon will typically reside on <strong>localhost</strong>, but could reside on a
-different host.
-It may also consist on a set of multiple daemons, each residing on a different
-server and on different IP number.
-In such case a DNS host name with multiple IP addresses (round-robin load sharing)
-is supported by the mailet (but on the same port number).</p>
-</div>
-<div class="paragraph">
-<p>Handles the following init parameters:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong><debug></strong></p>
-</li>
-<li>
-<p><strong><host></strong>: the host name of the server where CLAMD runs. It can either be
-a machine name, such as
-"<strong>java.sun.com</strong>", or a textual representation of its
-IP address. If a literal IP address is supplied, only the
-validity of the address format is checked.
-If the machine name resolves to multiple IP addresses, <strong>round-robin load sharing</strong> will
-be used.
-The default is <strong>localhost</strong>.</p>
-</li>
-<li>
-<p><strong><port></strong>: the port on which CLAMD listens. The default is <strong>3310</strong>.</p>
-</li>
-<li>
-<p><strong><maxPings></strong>: the maximum number of connection retries during startup.
-If the value is <strong>0</strong> no startup test will be done.
-The default is <strong>6</strong>.</p>
-</li>
-<li>
-<p><strong><pingIntervalMilli></strong>: the interval (in milliseconds)
-between each connection retry during startup.
-The default is <strong>30000</strong> (30 seconds).</p>
-</li>
-<li>
-<p><strong><streamBufferSize></strong>: the BufferedOutputStream buffer size to use
-writing to the <strong>stream connection</strong>. The default is <strong>8192</strong>.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The actions performed are as follows:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>During initialization:</p>
-</li>
-<li>
-<p>Gets all <strong>config.xml</strong> parameters, handling the defaults;</p>
-</li>
-<li>
-<p>resolves the <strong><host></strong> parameter, creating the round-robin IP list;</p>
-</li>
-<li>
-<p>connects to CLAMD at the first IP in the round-robin list, on
-the specified <strong><port></strong>;</p>
-</li>
-<li>
-<p>if unsuccessful, retries every <strong><pingIntervalMilli></strong> milliseconds up to
-<strong><maxPings></strong> times;</p>
-</li>
-<li>
-<p>sends a <strong>PING</strong> request;</p>
-</li>
-<li>
-<p>waits for a <strong>PONG</strong> answer;</p>
-</li>
-<li>
-<p>repeats steps 3-6 for every other IP resolved.</p>
-</li>
-<li>
-<p>For every mail</p>
-</li>
-<li>
-<p>connects to CLAMD at the "next" IP in the round-robin list, on
-the specified <strong><port></strong>, and increments the "next" index;
-if the connection request is not accepted tries with the next one
-in the list unless all of them have failed;</p>
-</li>
-<li>
-<p>sends a "<strong>STREAM</strong>" request;</p>
-</li>
-<li>
-<p>parses the "<strong>PORT *streamPort</strong>*" answer obtaining the port number;</p>
-</li>
-<li>
-<p>makes a second connection (the <strong>stream connection</strong>) to CLAMD at the same host (or IP)
-on the <strong>streamPort</strong> just obtained;</p>
-</li>
-<li>
-<p>sends the mime message to CLAMD (using {@link MimeMessage#writeTo(java.io.OutputStream)})
-through the <strong>stream connection</strong>;</p>
-</li>
-<li>
-<p>closes the <strong>stream connection</strong>;</p>
-</li>
-<li>
-<p>gets the "<strong>OK</strong>" or "<strong>…​ FOUND</strong>" answer from the main connection;</p>
-</li>
-<li>
-<p>closes the main connection;</p>
-</li>
-<li>
-<p>sets the "<strong>org.apache.james.infected</strong>" <strong>mail attribute</strong> to either
-"<strong>true</strong>" or "<strong>false</strong>";</p>
-</li>
-<li>
-<p>adds the "<strong>X-MessageIsInfected</strong>" <strong>header</strong> to either
-"<strong>true</strong>" or "<strong>false</strong>";</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Some notes regarding <a href="http://www.clamav.net/">clamav.conf</a> :</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>LocalSocket</strong> must be commented out</p>
-</li>
-<li>
-<p><strong>TCPSocket</strong> must be set to a port# (typically 3310)</p>
-</li>
-<li>
-<p><strong>StreamMaxLength</strong> must be >= the James config.xml parameter
-<*maxmessagesize*> in SMTP <*handler*></p>
-</li>
-<li>
-<p><strong>MaxThreads</strong> should? be >= the James config.xml parameter
-<*threads*> in <*spoolmanager*></p>
-</li>
-<li>
-<p><strong>ScanMail</strong> must be uncommented</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Here follows an example of config.xml definitions deploying CLAMD on localhost,
-and handling the infected messages:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><!-- Do an antivirus scan -->
-<mailet match="All" class="ClamAVScan" onMailetException="ignore"/>
-
-<!-- If infected go to virus processor -->
-<mailet match="HasMailAttributeWithValue=org.apache.james.infected, true" class="ToProcessor">
- <processor> virus </processor>
-</mailet>
-
-<!-- Check attachment extensions for possible viruses -->
-<mailet match="AttachmentFileNameIs=-d -z *.exe *.com *.bat *.cmd *.pif *.scr *.vbs *.avi *.mp3 *.mpeg *.shs" class="ToProcessor">
- <processor> bad-extensions </processor>
-</mailet></pre>
-</div>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><!-- Messages containing viruses -->
-<processor name="virus">
- <!-- To avoid a loop while bouncing -->
- <mailet match="All" class="SetMailAttribute">
- <org.apache.james.infected>true, bouncing</org.apache.james.infected>
- </mailet>
-
- <mailet match="SMTPAuthSuccessful" class="Bounce">
- <sender>bounce-admin@xxx.com</sender>
- <inline>heads</inline>
- <attachment>none</attachment>
- <notice> Warning: We were unable to deliver the message below because it was found infected by virus(es). </notice>
- </mailet>
-
- <mailet match="All" class="ToRepository">
- <repositoryPath>file://var/mail/infected/</repositoryPath>
- </mailet>
-
- <mailet match="All" class="Null" />
-</processor></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_classifybounce"><a class="anchor" href="#_classifybounce"></a>ClassifyBounce</h3>
-<div class="paragraph">
-<p>Assesses the message to determine if it was a hard or soft bounce, and if it was a soft bounce, something of its nature..</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="ClassifyBounce">
- <headerName>X-MailetHeader</headerName>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_fromrepository"><a class="anchor" href="#_fromrepository"></a>FromRepository</h3>
-<div class="paragraph">
-<p>Re-spools Mail found in the specified Repository.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="RecipientIs=respool@localhost" class="FromRepository">
- <repositoryPath> *repository path* </repositoryPath>
- <processor> *target processor* </repositoryPath>
- <delete&t; [true|<b>false</b>] </delete>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_headerstohttp"><a class="anchor" href="#_headerstohttp"></a>HeadersToHTTP</h3>
-<div class="paragraph">
-<p>Serialise the email and pass it to an HTTP call</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="HeadersToHTTP">
- <url>http://192.168.0.252:3000/alarm</url>
- <parameterKey>Test</parameterKey>
- <parameterValue>ParameterValue</parameterValue>
- <passThrough>true</passThrough>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_onlytext"><a class="anchor" href="#_onlytext"></a>OnlyText</h3>
-<div class="paragraph">
-<p>Keep only the text part of a message.</p>
-</div>
-<div class="paragraph">
-<p>If the message is text only then it doesn’t touch it, if it is a multipart it
-transform it a in plain text message with the first text part found.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>text/plain</p>
-</li>
-<li>
-<p>text/html ⇒ with a conversion to text only</p>
-</li>
-<li>
-<p>text/* as is.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_manage_sieve_scripts_via_a_mailet"><a class="anchor" href="#_manage_sieve_scripts_via_a_mailet"></a>Manage Sieve scripts via a mailet</h3>
-<div class="paragraph">
-<p>Each user can manage his SIEVE scripts through the <code>ManageSieveMailet</code> mailet.</p>
-</div>
-<div class="paragraph">
-<p>To use the manage SIEVE mailet :</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>You need to create the user sievemanager@DOMAIN ( if you don’t, the SMTP server will check the domain, recognize it, and look for an absent local user, and will generate an error ).</p>
-</li>
-<li>
-<p>You can send Manage Sieve commands by mail to sievemanager@DOMAIN. Your subject must contain the command. Scripts need to be added as attachments and need the ".sieve" extension.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>To activate a script for a user, you need the following combination :</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>PUTSCRIPT scriptname</p>
-</li>
-<li>
-<p>SETACTIVE scriptname</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_recoverattachment"><a class="anchor" href="#_recoverattachment"></a>RecoverAttachment</h3>
-<div class="paragraph">
-<p>This mailet takes an attachment stored in an attribute and attach it back to
-the message</p>
-</div>
-<div class="paragraph">
-<p>This may be used to place back attachment stripped by StripAttachment and
-stored in the attribute
-<strong>org.apache.james.mailet.standard.mailets.StripAttachment.saved</strong></p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> <mailet match="All" class="RecoverAttachment" >
- <attribute>my.attribute.name</attribute>
- </mailet ></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_serialisetohttp"><a class="anchor" href="#_serialisetohttp"></a>SerialiseToHTTP</h3>
-<div class="paragraph">
-<p>Serialise the email and pass it to an HTTP call</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="SerialiseToHTTP">
- <name>URL</name> <value>url where serialised message will be posted</value>
- <name>ParameterKey</name> <value>An arbitrary parameter be added to the post</value>
- <name>ParameterValue</name> <value>A value for the arbitrary parameter</value>
- <name>MessageKeyName</name> <value>Field name for the serialised message</value>
- <name>passThrough</name> <value>true or false</value>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_servertime"><a class="anchor" href="#_servertime"></a>ServerTime</h3>
-<div class="paragraph">
-<p>Returns the current time for the mail server.</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="RecipientIs=time@cadenza.lokitech.com" class="ServerTime"/></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_spf"><a class="anchor" href="#_spf"></a>SPF</h3>
-<div class="paragraph">
-<p>Check the ip, sender, helo against SPF. Add the following attributes to the
-mail object:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> org.apache.james.transport.mailets.spf.explanation
- org.apache.james.transport.mailets.spf.result</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="SPF">
- <addHeader>true</addHeader>
- <debug>false</debug>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_toplaintext"><a class="anchor" href="#_toplaintext"></a>ToPlainText</h3>
-<div class="paragraph">
-<p>This mailet converts HTML parts of a message into Plain text.</p>
-</div>
-<div class="paragraph">
-<p>It starts looking for multipart/alternative containing a text/plain and a text/html part
-and only keep the text/plain part. Then in a second pass replaces remaining text/html by
-their textual content, infered by parsing the HTML content and handling common tags.</p>
-</div>
-<div class="paragraph">
-<p>Eg:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre><mailet matcher="All" class="ToPlainText"/></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_tosenderfolder"><a class="anchor" href="#_tosenderfolder"></a>ToSenderFolder</h3>
-<div class="literalblock">
-<div class="content">
-<pre>Receives a Mail from the Queue and takes care to deliver the message
- to a defined folder of the sender.</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You have to define the folder name of the sender.</p>
-</div>
-<div class="paragraph">
-<p>The flag 'consume' will tell is the mail will be further</p>
-</div>
-<div class="paragraph">
-<p>processed by the upcoming processor mailets, or not.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="RecipientIsLocal" class="ToSenderFolder">
- <folder> *Sent Items* </folder>
- <consume> *false* </consume>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_unwraptext"><a class="anchor" href="#_unwraptext"></a>UnwrapText</h3>
-<div class="paragraph">
-<p>Remove (best effort to) the hardcoded wrapping from a message.</p>
-</div>
-<div class="paragraph">
-<p>If the text is "format=flowed" then deflows the text. Otherwise it forces a dewrap of the text.</p>
-</div>
-<div class="paragraph">
-<p>Parameters:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>quotewidth - when we try to dewrap e quoted text it helps knowing the original
-with, so we can reconstruct "wrapped wraps" created by multiple wrappings by clients with
-different original width or simply to the add of the heading ">" that increase the line
-length.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The value should be "WIDTH+X" if the original length is known, "-X" otherwise.</p>
-</div>
-<div class="paragraph">
-<p>In the latter case the length of the longer line will be used.</p>
-</div>
-<div class="paragraph">
-<p>X is the tollerance needed for the quoting chars: if the original width is known the suggested
-value for X is 2 (because of "> " prefix), otherwise it is suggested to increase it to a value
-like 10 (-10)</p>
-</div>
-<div class="paragraph">
-<p>In summary, if the original wrap is known (for example 76, for flowed messages) <strong>quotewidth = 78</strong></p>
-</div>
-<div class="paragraph">
-<p>Otherwise <strong>quotewidth = -10</strong></p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_useheaderrecipients"><a class="anchor" href="#_useheaderrecipients"></a>UseHeaderRecipients</h3>
-<div class="paragraph">
-<p>Mailet designed to process the recipients from the mail headers rather
-than the recipients specified in the SMTP message header. This can be
-useful if your mail is redirected on-route by a mail server that
-substitutes a fixed recipient address for the original.</p>
-</div>
-<div class="paragraph">
-<p>To use this, match against the redirection address using the
-<strong>RecipientIs</strong> matcher and set the mailet 'class' to
-<strong>UseHeaderRecipients</strong>. This will cause the email to be
-re-injected into the root process with the recipient substituted
-by all the recipients in the Mail-For, To and Cc headers
-of the message.</p>
-</div>
-<div class="paragraph">
-<p>e.g.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="RecipientIs=forwarded@myhost" class="UseHeaderRecipients">
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_wraptext"><a class="anchor" href="#_wraptext"></a>WrapText</h3>
-<div class="paragraph">
-<p>Convert a message to format=flowed</p>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/configure/mailrepositorystore.html b/james-distributed-app/3.8.1/configure/mailrepositorystore.html
deleted file mode 100644
index 883b0bc..0000000
--- a/james-distributed-app/3.8.1/configure/mailrepositorystore.html
+++ /dev/null
@@ -1,449 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — mailrepositorystore.xml :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Core components</li>
- <li><a href="mailrepositorystore.html">mailrepositorystore.xml</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/mailrepositorystore.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — mailrepositorystore.xml</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>A <code>mail repository</code> allows storage of a mail as part of its
-processing. Standard configuration relies on the following mail
-repository.</p>
-</div>
-<div class="paragraph">
-<p>A mail repository is identified by its <strong>url</strong>, constituted of a <strong>protocol</strong> and a <strong>path</strong>.</p>
-</div>
-<div class="paragraph">
-<p>For instance in the url <code>cassandra://var/mail/error/</code> <code>cassandra</code> is the protocol and <code>var/mail/error</code> the path.</p>
-</div>
-<div class="paragraph">
-<p>The <strong>mailrepositorystore.xml</strong> file allows registration of available protocols, and their binding to actual MailRepository
-implementation. Note that extension developers can write their own MailRepository implementations, load them via the
-<code>extensions-jars</code> mechanism as documented in <a href="../extending/index.html" class="xref page">'writing your own extensions'</a>, and finally
-associated to a protocol in <strong>mailrepositorystore.xml</strong> for a usage in <strong>mailetcontainer.xml</strong>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_configuration"><a class="anchor" href="#_configuration"></a>Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/mailrepositorystore.xml">example</a>
-to get some examples and hints.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailrepositorystore>
- <defaultProtocol>cassandra</defaultProtocol>
- <mailrepositories>
- <mailrepository class="org.apache.james.mailrepository.cassandra.CassandraMailRepository">
- <protocols>
- <protocol>cassandra</protocol>
- </protocols>
- </mailrepository>
- </mailrepositories>
-</mailrepositorystore></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Only the <strong>CassandraMailRepository</strong> is available by default for the Distributed Server. Mails metadata are stored in
-Cassandra while the headers and bodies are stored within the <a href="../architecture/index.html#_blobstore" class="xref page">BlobStore</a>.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/configure/matchers.html b/james-distributed-app/3.8.1/configure/matchers.html
deleted file mode 100644
index 4fab617..0000000
--- a/james-distributed-app/3.8.1/configure/matchers.html
+++ /dev/null
@@ -1,1420 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Matchers :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Core components</li>
- <li><a href="matchers.html">Packaged Matchers</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/matchers.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Matchers</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This documentation page lists and documents Matchers that can be used within the
-Distributed Server MailetContainer in order to write your own mail processing logic with out-of-the-box components.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_supported_matchers"><a class="anchor" href="#_supported_matchers"></a>Supported matchers</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_all"><a class="anchor" href="#_all"></a>All</h3>
-<div class="paragraph">
-<p>Matches all mail.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_atleastpriority"><a class="anchor" href="#_atleastpriority"></a>AtLeastPriority</h3>
-<div class="paragraph">
-<p>Numeric value. The priority of this mail should be at least the specified value to be matched.</p>
-</div>
-<div class="paragraph">
-<p>Inclusive.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_atmost"><a class="anchor" href="#_atmost"></a>AtMost</h3>
-<div class="paragraph">
-<p>Checks that a mail did at most X executions on a specific operation.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> If no executions have been performed previously for Y attribute, it will be set up.
- In the mail, every time the check succeeds, its counter will be incremented by one.
-The check fails when the defined X limit is reached.</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>X - count of how many times a specific operation is performed</p>
-</li>
-<li>
-<p>Y - name of attribute represented for specific operation executions, default value is: <strong>AT_MOST_EXECUTIONS</strong></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The example below will match a mail with at most 3 executions on the mailet
-with attribute name <strong>AT_MOST_EXECUTIONS</strong></p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="AtMost=AT_MOST_EXECUTIONS:3" class="<any-class>">
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_atmostpriority"><a class="anchor" href="#_atmostpriority"></a>AtMostPriority</h3>
-<div class="paragraph">
-<p>Numeric value. The priority of this mail should be at most the specified value to be matched.</p>
-</div>
-<div class="paragraph">
-<p>Inclusive.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_dlp"><a class="anchor" href="#_dlp"></a>DLP</h3>
-<div class="paragraph">
-<p>Enable evaluation of incoming emails against DLP rules (Data Leak Prevention) attached to the sender domains.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre><mailet match="DLP" class="ToRepository">
- <repositoryPath>/var/mail/quarantine</repositoryPath>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Rules can be administered via <a href="../operate/webadmin.html#_administrating_dlp_configuration" class="xref page">webAdmin</a>.</p>
-</div>
-<div class="paragraph">
-<p>Only available on top of Memory and Cassandra storages.</p>
-</div>
-<div class="paragraph">
-<p>Additionally a cache can be added to reduce queries done to the underlying database.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre><mailet match="DLP=cache:60s" class="ToRepository">
- <repositoryPath>/var/mail/quarantine</repositoryPath>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will query the DLP rules for a given domain only every 60 seconds.</p>
-</div>
-<div class="paragraph">
-<p>Please note that querying DLP rules on top of Cassandra relies on Event sourcing, involves reading a potentially
-large event stream and involves some SERIAL reads (LightWeight transactions) for each processed emails.</p>
-</div>
-<div class="paragraph">
-<p>Efficiency of the cache can be tracked with the following metrics:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>dlp.cache.hitRate</code></p>
-</li>
-<li>
-<p><code>dlp.cache.missCount</code></p>
-</li>
-<li>
-<p><code>dlp.cache.hitCount</code></p>
-</li>
-<li>
-<p><code>dlp.cache.size</code></p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_fetchedfrom"><a class="anchor" href="#_fetchedfrom"></a>FetchedFrom</h3>
-<div class="paragraph">
-<p>Matches mail with a header set by Fetchpop X-fetched-from</p>
-</div>
-<div class="paragraph">
-<p>fetchpop sets X-fetched-by to the "name" of the fetchpop fetch task.</p>
-</div>
-<div class="paragraph">
-<p>This is used to match all mail fetched from a specific pop account.</p>
-</div>
-<div class="paragraph">
-<p>Once the condition is met the header is stripped from the message to prevent looping if
-the mail is re-inserted into the spool.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_hasattachment"><a class="anchor" href="#_hasattachment"></a>HasAttachment</h3>
-<div class="paragraph">
-<p>Checks whether this message has an attachment</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_hasexception"><a class="anchor" href="#_hasexception"></a>HasException</h3>
-<div class="paragraph">
-<p>This Matcher determines if the exception specified in the condition or
-the subclasses of it has occurred during the processing of the mail.
-If true, all recipients are returned, else null. This matcher presupposes
-that the exception has been captured as a Mail attribute
-org.apache.mailet.Mail#MAILET_ERROR_ATTRIBUTE_NAME in the process.</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="HasException=org.apache.james.managesieve.api.ManageSieveException" class="<any-class>"></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_hasheader"><a class="anchor" href="#_hasheader"></a>HasHeader</h3>
-<div class="paragraph">
-<p>use:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="HasHeader={<header>[=value]}+" class="..." /></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>This matcher checks if the header is present in the message (global) and per recipient (specific). It complements the AddHeader mailet.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_hasheaderwithprefix"><a class="anchor" href="#_hasheaderwithprefix"></a>HasHeaderWithPrefix</h3>
-<div class="paragraph">
-<p>Matches emails with headers having a given prefix.</p>
-</div>
-<div class="paragraph">
-<p>If a header with the given prefix is found in the message (global) all recipients will be matched.
-If a header with the given prefix is found per recipient (specific), only these will be matched.</p>
-</div>
-<div class="paragraph">
-<p>Otherwise, no recipient in returned.</p>
-</div>
-<div class="paragraph">
-<p>use:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="HasHeaderWithPrefix=PREFIX" class="..." /></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_hasmailattribute"><a class="anchor" href="#_hasmailattribute"></a>HasMailAttribute</h3>
-<div class="paragraph">
-<p>This Matcher determines if the mail contains the attribute specified in the
-condition, and returns all recipients if it is the case.</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="HasMailAttribute=whatever" class="<any-class>"></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_hasmailattributewithvalue"><a class="anchor" href="#_hasmailattributewithvalue"></a>HasMailAttributeWithValue</h3>
-<div class="paragraph">
-<p>This Matcher determines if the mail contains the attribute specified in
-the condition and if the value answered when the method toString() is
-invoked on the attribute is equal to the String value specified in the
-condition. If both tests are true, all recipients are returned, else null.</p>
-</div>
-<div class="paragraph">
-<p>Notes:</p>
-</div>
-<div class="paragraph">
-<p>The current matcher implementation expects a single String value to match
-on. This matcher requires two values, the attribute name and attribute
-value. This requires some implicit rules to govern how the single value
-supplied to the matcher is parsed into two values.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>In the match condition, the split between the attribute name and the
-attribute value is made at the first comma. Attribute names that include
-a comma will parse incorrectly and therefore are not supported by this
-matcher.</p>
-</li>
-<li>
-<p>Leading and trailing spaces are removed from both the attribute name and
-attribute value specified in the condition and the tested attribute value in
-the mail prior to matching. Therefore, "abc" , " abc", "abc " and " abc "
-are considered equivalent.</p>
-</li>
-<li>
-<p>To test for an empty string, do not specify an attribute value after the
-comma.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="HasMailAttributeWithValue=name, value" class="<any-class>"></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_hasmailattributewithvalueregex"><a class="anchor" href="#_hasmailattributewithvalueregex"></a>HasMailAttributeWithValueRegex</h3>
-<div class="paragraph">
-<p>This Matcher determines if the mail contains the attribute specified in the
-condition and that attribute matches the supplied regular expression,
-it returns all recipients if that is the case.</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="HasMailAttributeWithValueRegex=whatever,<regex>" class="<any-class>"></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note: as it is not possible to put arbitrary objects in the configuration,
-toString() is called on the attribute value, and that is the value matched against.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_hasmimetype"><a class="anchor" href="#_hasmimetype"></a>HasMimeType</h3>
-<div class="paragraph">
-<p>This matcher checks if the content type matches.</p>
-</div>
-<div class="paragraph">
-<p>This matcher does not walk down the mime tree and stops at the top level mime part.</p>
-</div>
-<div class="paragraph">
-<p>use:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="HasMimeType=text/plain,text/html" class="..." /></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_hasmimetypeparameter"><a class="anchor" href="#_hasmimetypeparameter"></a>HasMimeTypeParameter</h3>
-<div class="paragraph">
-<p>This matcher checks if the content type parameters matches.</p>
-</div>
-<div class="paragraph">
-<p>use:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="HasMimeTypeParameter=report-type=disposition-notification,report-type=other" class="..." /></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_haspriority"><a class="anchor" href="#_haspriority"></a>HasPriority</h3>
-<div class="paragraph">
-<p>Numeric value. The priority of this mail should be equal to the specified value to be matched.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_hostis"><a class="anchor" href="#_hostis"></a>HostIs</h3>
-<div class="paragraph">
-<p>Matches mail to given hosts.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_hostislocal"><a class="anchor" href="#_hostislocal"></a>HostIsLocal</h3>
-<div class="paragraph">
-<p>Matches mail to Domains which are local</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_ismarkedasspam"><a class="anchor" href="#_ismarkedasspam"></a>IsMarkedAsSpam</h3>
-<div class="paragraph">
-<p>Matches mails having a <strong>org.apache.james.spamassassin.status</strong> per recipient header with a <strong>Yes</strong> value.</p>
-</div>
-<div class="paragraph">
-<p>As an example, here is a part of a mailet pipeline which can be used in your LocalDelivery processor:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><!-- SpamAssassing mailets pipeline -->
- <mailet match="RecipientIsLocal" class="SpamAssassin">
- <spamdHost>spamassassin</spamdHost>
- <spamdPort>783</spamdPort>
- </mailet>
- <mailet match="IsMarkedAsSpam" class="WithStorageDirective">
- <targetFolderName>Spam</targetFolderName>
- </mailet>
-<!-- End of SpamAssassing mailets pipeline --></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>In order to use this with <code>rspamd</code>, we need to declare a condition for the matcher
-and drop the Rspamd jar (<strong>third-party/rspamd</strong>) in the James extensions-jars folder.
-Eg: With the recipient header for Rspamd being <strong>org.apache.james.rspamd.status</strong>,
-then the configuration would be:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><!-- Rspamd mailets pipeline -->
- <mailet match="IsMarkedAsSpam=org.apache.james.rspamd.status" class="WithStorageDirective">
- <targetFolderName>Spam</targetFolderName>
- </mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_isoverquota"><a class="anchor" href="#_isoverquota"></a>IsOverQuota</h3>
-<div class="paragraph">
-<p>This matcher will check if the incoming email will make recipients exceed their quotas.</p>
-</div>
-<div class="paragraph">
-<p>Here is a configuration example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="IsOverQuota" class="<any-class>"/></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_isremotedeliverypermanenterror"><a class="anchor" href="#_isremotedeliverypermanenterror"></a>IsRemoteDeliveryPermanentError</h3>
-<div class="paragraph">
-<p>Checks if the mail has a permanent remote delivery failure attribute</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="IsRemoteDeliveryPermanentError" class="<any-class>"/></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_isremotedeliverypermanenterror_2"><a class="anchor" href="#_isremotedeliverypermanenterror_2"></a>IsRemoteDeliveryPermanentError</h3>
-<div class="paragraph">
-<p>Checks if the mail has a temporary remote delivery failure attribute set to false (meaning it’s a temporary error)</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="IsRemoteDeliveryTemporaryError" class="<any-class>"/></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_issenderinrrtloop"><a class="anchor" href="#_issenderinrrtloop"></a>IsSenderInRRTLoop</h3>
-<div class="paragraph">
-<p>This matcher allow you to know if the sender of an email is part of a RRT loop.</p>
-</div>
-<div class="paragraph">
-<p>This is useful when bouncing upon RRT execution issues: we don’t want to create a bouncing loop
-(as the execution of that RRT loop will fail).</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="IsSenderInRRTLoop" class="<any-class>"/></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_issinglerecipient"><a class="anchor" href="#_issinglerecipient"></a>IsSingleRecipient</h3>
-<div class="paragraph">
-<p>Matches mail where the number of recipients is exactly one.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_issmimeencrypted"><a class="anchor" href="#_issmimeencrypted"></a>IsSMIMEEncrypted</h3>
-<div class="paragraph">
-<p>Checks if a mail is smime encrypted.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_issmimesigned"><a class="anchor" href="#_issmimesigned"></a>IsSMIMESigned</h3>
-<div class="paragraph">
-<p>Checks if a mail is smime encrypted.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_isx509certificatesubject"><a class="anchor" href="#_isx509certificatesubject"></a>IsX509CertificateSubject</h3>
-<div class="paragraph">
-<p>Checks if the subject of a X509Certificate contains the supplied string. The
-certificate is read from the specified mail attribute.</p>
-</div>
-<div class="paragraph">
-<p>If the specified attribute contains more than one certificate the matcher matches if at
-least one of the certificates contains the given string.</p>
-</div>
-<div class="paragraph">
-<p>Configuration string:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>mailAttribute;string</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_recipientdomainis"><a class="anchor" href="#_recipientdomainis"></a>RecipientDomainIs</h3>
-<div class="paragraph">
-<p>This will return recipients matching a configured domain.</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="RecipientDomainIs=<domain.com>" class="<any-class>"/></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_recipientis"><a class="anchor" href="#_recipientis"></a>RecipientIs</h3>
-<div class="paragraph">
-<p>This matcher matches a specific recipient (in the envelope of the mail), passed as a condition to
-this matcher.</p>
-</div>
-<div class="paragraph">
-<p>The example below will match only the recipient user@domain</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match=&quot;RecipientIs=user@domain&quot; class=&quot;<any-class>&quot;>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_recipientislocal"><a class="anchor" href="#_recipientislocal"></a>RecipientIsLocal</h3>
-<div class="paragraph">
-<p>Matches mail where the recipient is local.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_recipientisregex"><a class="anchor" href="#_recipientisregex"></a>RecipientIsRegex</h3>
-<div class="paragraph">
-<p>Matches recipients whose address matches a regular expression.</p>
-</div>
-<div class="paragraph">
-<p>Is equivalent to the SenderIsRegex matcher but matching on the recipient.</p>
-</div>
-<div class="paragraph">
-<p>Configuration string: a regular expression.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="RecipientIsRegex=<regular-expression>" class="<any-class>"></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The example below will match any recipient in the format user@log.anything</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="RecipientIsRegex=(.*)@log\.(.*)" class="<any-class>">
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_relaylimit"><a class="anchor" href="#_relaylimit"></a>RelayLimit</h3>
-<div class="paragraph">
-<p>Matches mail which has been relayed more than a given number of times.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_remoteaddrinnetwork"><a class="anchor" href="#_remoteaddrinnetwork"></a>RemoteAddrInNetwork</h3>
-<div class="paragraph">
-<p>Checks the IP address of the sending server against a comma-delimited list
-of IP addresses, domain names or sub-nets.</p>
-</div>
-<div class="paragraph">
-<p>See AbstractNetworkMatcher for details on how to specify entries.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_remoteaddrinnetwork_2"><a class="anchor" href="#_remoteaddrinnetwork_2"></a>RemoteAddrInNetwork</h3>
-<div class="paragraph">
-<p>Checks the IP address of the sending server against a comma-delimited list
-of IP addresses, domain names or sub-nets.</p>
-</div>
-<div class="paragraph">
-<p>See AbstractNetworkMatcher for details on how to specify entries.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_remotedeliveryfailedwithsmtpcode"><a class="anchor" href="#_remotedeliveryfailedwithsmtpcode"></a>RemoteDeliveryFailedWithSMTPCode</h3>
-<div class="paragraph">
-<p>Checks the SMTP error code attached to remote delivery failures</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_senderdomainis"><a class="anchor" href="#_senderdomainis"></a>SenderDomainIs</h3>
-<div class="paragraph">
-<p>SenderDomainIs will look at the envelope sender’s domain. If equal to
-configured value, then all recipients will be returned. Otherwise an empty
-list will be returned.</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="SenderDomainIs=<domain.com>" class="<any-class>"></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_senderhostis"><a class="anchor" href="#_senderhostis"></a>SenderHostIs</h3>
-<div class="paragraph">
-<p>Checks the sender’s displayed domain name against a supplied list.</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="SenderHostIs=domain.com" class="ToProcessor">
- <processor> spam </processor>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_senderis"><a class="anchor" href="#_senderis"></a>SenderIs</h3>
-<div class="paragraph">
-<p>This matcher matches a specific sender, passed as a condition to this matcher.</p>
-</div>
-<div class="paragraph">
-<p>The example below will match mail with a sender being user@domain</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="SenderIs=user@domain" class="<any-class>">
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_senderislocal"><a class="anchor" href="#_senderislocal"></a>SenderIsLocal</h3>
-<div class="paragraph">
-<p>Matches mail where the sender is local.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_senderisnull"><a class="anchor" href="#_senderisnull"></a>SenderIsNull</h3>
-<div class="paragraph">
-<p>Matches mails that are sent by a null sender.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="SenderIsNull" class="<any-class>"></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_senderisregex"><a class="anchor" href="#_senderisregex"></a>SenderIsRegex</h3>
-<div class="paragraph">
-<p>Matches mails that are sent by a sender whose address matches a regular expression.</p>
-</div>
-<div class="paragraph">
-<p>Is equivalent to the RecipientIsRegex matcher but matching on the sender.</p>
-</div>
-<div class="paragraph">
-<p>Configuration string: a regular expression.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="SenderIsRegex=<regular-expression>" class="<any-class>"></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The example below will match any sender in the format user@log.anything</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="SenderIsRegex=(.*)@log\.(.*)" class="<any-class>">
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Another example below will match any sender having some variations of the string
-<strong>mp3</strong> inside the username part.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="SenderIsRegex=(.*)(mp3|emmepitre)(.*)@" class="<any-class>">
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_sentbyjmap"><a class="anchor" href="#_sentbyjmap"></a>SentByJmap</h3>
-<div class="paragraph">
-<p>Matches mails sent via the JMAP protocol.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_sentbymailet"><a class="anchor" href="#_sentbymailet"></a>SentByMailet</h3>
-<div class="paragraph">
-<p>This matcher matches email sent automatically by mailets.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="SentByMailetAny" class="<any-class>"/></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>This matcher allows you, for instance, to enable/disable routing automatically generated emails out of your server.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_sizegreaterthan"><a class="anchor" href="#_sizegreaterthan"></a>SizeGreaterThan</h3>
-<div class="paragraph">
-<p>Checks whether the message (entire message, not just content) is greater
-than a certain number of bytes. You can use 'k' and 'm' as optional postfixes.</p>
-</div>
-<div class="paragraph">
-<p>In other words, "1m" is the same as writing "1024k", which is the same as
-"1048576".</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_smtpauthsuccessful"><a class="anchor" href="#_smtpauthsuccessful"></a>SMTPAuthSuccessful</h3>
-<div class="paragraph">
-<p>Matches mails that are sent by an SMTP authenticated user.</p>
-</div>
-<div class="paragraph">
-<p>If the sender was not authenticated it will not match.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="SMTPAuthSuccessful" class="<any-class>"></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_smtpauthuseris"><a class="anchor" href="#_smtpauthuseris"></a>SMTPAuthUserIs</h3>
-<div class="paragraph">
-<p>Matches mails that are sent by an SMTP authenticated user present in a supplied list.</p>
-</div>
-<div class="paragraph">
-<p>If the sender was not authenticated it will not match.</p>
-</div>
-<div class="paragraph">
-<p>Configuration string: a comma, tab or space separated list of James users.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="SMTPAuthUserIs=<list-of-user-names>" class="<any-class>"></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_smtpisauthnetwork"><a class="anchor" href="#_smtpisauthnetwork"></a>SMTPIsAuthNetwork</h3>
-<div class="paragraph">
-<p>Matches mails that are sent by a client which is allowed to relay.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="SMTPIsAuthNetwork" class="<any-class>"></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_subjectis"><a class="anchor" href="#_subjectis"></a>SubjectIs</h3>
-<div class="paragraph">
-<p>Matches mail where the subject is contained in a configurable list.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_subjectis_2"><a class="anchor" href="#_subjectis_2"></a>SubjectIs</h3>
-<div class="paragraph">
-<p>Matches mail where the subject starts with a given phrase.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_toomanyrecipients"><a class="anchor" href="#_toomanyrecipients"></a>TooManyRecipients</h3>
-<div class="paragraph">
-<p>This matcher matches emails that have too many recipients.</p>
-</div>
-<div class="paragraph">
-<p>The example below will reject any email with more than 5 recipients</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="TooManyRecipients=5" class="<any-class&gt;"></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_useris"><a class="anchor" href="#_useris"></a>UserIs</h3>
-<div class="paragraph">
-<p>Matches mail where the user is contained in a configurable list.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_xoriginatingipinnetwork"><a class="anchor" href="#_xoriginatingipinnetwork"></a>XOriginatingIpInNetwork</h3>
-<div class="paragraph">
-<p>Checks the first X_ORIGINATING_IP IP address against a comma-delimited list
-of IP addresses, domain names or sub-nets.</p>
-</div>
-<div class="paragraph">
-<p>See AbstractNetworkMatcher for details on how to specify entries.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_experimental_matchers"><a class="anchor" href="#_experimental_matchers"></a>Experimental matchers</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_attachmentfilenameis"><a class="anchor" href="#_attachmentfilenameis"></a>AttachmentFileNameIs</h3>
-<div class="paragraph">
-<p>Checks if at least one attachment has a file name which matches any
-element of a comma-separated or space-separated list of file name masks.</p>
-</div>
-<div class="paragraph">
-<p>Syntax: <strong>match="AttachmentFileNameIs=[-d] [-z] masks"</strong></p>
-</div>
-<div class="paragraph">
-<p>The match is case insensitive.</p>
-</div>
-<div class="paragraph">
-<p>File name masks may start with a wildcard '\*'.</p>
-</div>
-<div class="paragraph">
-<p>Multiple file name masks can be specified, e.g.: '*.scr,\*.bat'.</p>
-</div>
-<div class="paragraph">
-<p>If '<strong>-d</strong>' is coded, some debug info will be logged.</p>
-</div>
-<div class="paragraph">
-<p>If '<strong>-z</strong>' is coded, the check will be non-recursively applied
-to the contents of any attached '*.zip' file.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_commandforlistserv"><a class="anchor" href="#_commandforlistserv"></a>CommandForListserv</h3>
-<div class="paragraph">
-<p>Returns positive if the recipient is a command for a listserv. For example,
-if my listserv is <a href="mailto:james@list.working-dogs.com">james@list.working-dogs.com</a>, this matcher will return true
-for <a href="mailto:james-on@list.working-dogs.com">james-on@list.working-dogs.com</a> and <a href="mailto:james-off@list.working-dogs.com">james-off@list.working-dogs.com</a>.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_commandlistservmatcher"><a class="anchor" href="#_commandlistservmatcher"></a>CommandListservMatcher</h3>
-<div class="paragraph">
-<p>CommandListservMatcher is the matcher that pairs with the CommandListservManager
-It checks to see if the request is intended for the ListservManager, but doesn’t guarantee that it is a valid command.</p>
-</div>
-<div class="paragraph">
-<p>To configure, insert this into the config.xml inside of the root processor block.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="CommandListservMatcher=announce@localhost" class="CommandListservManager">
-...
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_comparenumericheadervalue"><a class="anchor" href="#_comparenumericheadervalue"></a>CompareNumericHeaderValue</h3>
-<div class="paragraph">
-<p>Matches mails containing a header with a numeric value whose comparison with the specified value is true.</p>
-</div>
-<div class="paragraph">
-<p>If the header is missing in the message, there will be <strong>no match</strong></p>
-</div>
-<div class="paragraph">
-<p>Configuration string: The headerName, a comparison operator and the numeric headerValue
-to compare with, <strong>space or tab delimited</strong>.</p>
-</div>
-<div class="paragraph">
-<p>The comparison operators are: <strong><, ⇐, ==, >=, ></strong>;
-another set of operators is: <strong>LT, LE, EQ, GE, GT</strong>.</p>
-</div>
-<div class="paragraph">
-<p>Also the following operators are accepted: <strong>=<, =, ⇒</strong>.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="CompareNumericHeaderValue=X-MessageIsSpamProbability > 0.9" class="ToProcessor">
- <processor> spam </processor>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_fileregexmatcher"><a class="anchor" href="#_fileregexmatcher"></a>FileRegexMatcher</h3>
-<div class="paragraph">
-<p>Initializes RegexMatcher with regular expressions from a file.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_hashabeaswarrantmark"><a class="anchor" href="#_hashabeaswarrantmark"></a>HasHabeasWarrantMark</h3>
-<div class="paragraph">
-<p>This matcher tests for the Hebeas Warrant Mark.
-For details see: <a href="http://www.hebeas.com" class="bare">http://www.hebeas.com</a></p>
-</div>
-<div class="paragraph">
-<p>Usage: Place this matcher</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="HasHabeasWarrantMark" class="ToProcessor">
- <processor> transport </processor>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>in the root processes before the DNSRBL block lists (the InSpammerBlacklist matcher).</p>
-</div>
-<div class="paragraph">
-<p>Because the Habeas Warrant Mark is copyright material, I have asked for and
-received the following explicit statement from Habeas:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>-----------------------------------
-From: Lindsey Pettit [mailto:support@habeas.com]
-Sent: Sunday, September 29, 2002 5:51
-To: Noel J. Bergman
-Subject: RE: Habeas and Apache James
-
-Dear Noel,
-
-> I guess that since your Warrant Mark is copyright, I should ask for
-> something from you to explicitly authorize that Hebeas will permit
-> this code to be included and distributed as part of Apache James
-> under the Apache Software License. As we have established, the use
-> of the Habeas Warrant Mark for filtering is not restricted, but I
-> would like something to confirm that, so that Apache will be happy.
-
-I can hereby confirm to you that there is no license necessary in
-order to use the Habeas mark for filtering. That said, however, we
-do insist that it not ever be used as a basis for rejecting email which
-bears the Habeas mark.
------------------------------------</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_inspammerblacklist"><a class="anchor" href="#_inspammerblacklist"></a>InSpammerBlacklist</h3>
-<div class="paragraph">
-<p>Checks the network IP address of the sending server against a blacklist of
-spammers. There are 3 lists that support this…​</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>blackholes.mail-abuse.org</strong>: Rejected - see <a href="http://www.mail-abuse.org/rbl/" class="bare">http://www.mail-abuse.org/rbl/</a></p>
-</li>
-<li>
-<p><strong>dialups.mail-abuse.org</strong>: Dialup - see <a href="http://www.mail-abuse.org/dul/" class="bare">http://www.mail-abuse.org/dul/</a></p>
-</li>
-<li>
-<p><strong>relays.mail-abuse.org</strong>: Open spam relay - see <a href="http://www.mail-abuse.org/rss/" class="bare">http://www.mail-abuse.org/rss/</a></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="InSpammerBlacklist=blackholes.mail-abuse.org." class="ToProcessor">
- <processor>spam</processor>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_nesspamcheck"><a class="anchor" href="#_nesspamcheck"></a>NESSpamCheck</h3>
-<div class="paragraph">
-<p>This is based on a sample filter.cfg for a Netscape Mail Server to stop
-spam.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_senderinfakedomain"><a class="anchor" href="#_senderinfakedomain"></a>SenderInFakeDomain</h3>
-<div class="paragraph">
-<p>Does a DNS lookup (MX and A/CNAME records) on the sender’s domain. If there
-are no entries, the domain is considered fake and the match is successful.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_composite_matchers"><a class="anchor" href="#_composite_matchers"></a>Composite matchers</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>It is possible to combine together matchers in order to create a composite matcher, thus simplifying your
-Mailet Container logic.</p>
-</div>
-<div class="paragraph">
-<p>Here are the available logical operations:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>And</strong> : This matcher performs And conjunction between the two matchers: recipients needs to match both matcher in order to
-match the composite matcher.</p>
-</li>
-<li>
-<p><strong>Or</strong> : This matcher performs Or conjunction between the two matchers: consider it to be a union of the results.
-It returns recipients from the Or composition results of the child matchers.</p>
-</li>
-<li>
-<p><strong>Not</strong> : It returns recipients from the negated composition of the child Matcher(s). Consider what wasn’t
-in the result set of each child matcher. Of course it is easier to understand if it only
-includes one matcher in the composition, the normal recommended use.</p>
-</li>
-<li>
-<p><strong>Xor</strong> : It returns Recipients from the Xor composition of the child matchers. Consider it to be the inequality
-operator for recipients. If any recipients match other matcher results
-then the result does not include that recipient.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Here is the syntax to adopt in <strong>mailetcontainer.xml</strong>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><processor state="transport" enableJmx="true">
- <matcher name="relay-allowed" match="org.apache.james.mailetcontainer.impl.matchers.Or">
- <matcher match="SMTPAuthSuccessful"/>
- <matcher match="SentByMailet"/>
- <matcher match="org.apache.james.jmap.mailet.SentByJmap"/>
- <matcher match="RemoteAddrInNetwork=127.0.0.1, 10.2.*, 193.50.151.*"/>
- </matcher>
-
- <!-- ... -->
-
- <mailet match="relay-allowed" class="ToProcessor">
- <processor>relay</processor>
- </mailet>
-</processor></pre>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/configure/opensearch.html b/james-distributed-app/3.8.1/configure/opensearch.html
deleted file mode 100644
index 688d862..0000000
--- a/james-distributed-app/3.8.1/configure/opensearch.html
+++ /dev/null
@@ -1,878 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — opensearch.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Storage dependencies</li>
- <li><a href="opensearch.html">opensearch.properties</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/opensearch.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — opensearch.properties</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/opensearch.properties">example</a>
-to get some examples and hints.</p>
-</div>
-<div class="paragraph">
-<p>If you want more explanation about OpenSearch configuration, you should visit the dedicated <a href="https://opensearch.org/">documentation</a>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_opensearch_configuration"><a class="anchor" href="#_opensearch_configuration"></a>OpenSearch Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This file section is used to configure the connection tp an OpenSearch cluster.</p>
-</div>
-<div class="paragraph">
-<p>Here are the properties allowing to do so :</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. opensearch.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.clusterName</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Is the name of the cluster used by James.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.nb.shards</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Number of shards for index provisionned by James</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.nb.replica</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Number of replica for index provisionned by James (default: 0)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.index.waitForActiveShards</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Wait for a certain number of active shard copies before proceeding with the operation. Defaults to 1.
-You may consult the <a href="https://www.elastic.co/guide/en/elasticsearch/reference/7.10/docs-index_.html#active-shards">documentation</a> for more information.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.retryConnection.maxRetries</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Number of retries when connecting the cluster</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.retryConnection.minDelay</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Minimum delay between connection attempts</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.max.connections</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Maximum count of HTTP connections allowed for the OpenSearch driver. Optional integer, if unspecified driver defaults
-applies (30 connections).</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.max.connections.per.hosts</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Maximum count of HTTP connections per host allowed for the OpenSearch driver. Optional integer, if unspecified driver defaults
-applies (10 connections).</p></td>
-</tr>
-</tbody>
-</table>
-<div class="sect2">
-<h3 id="_mailbox_search"><a class="anchor" href="#_mailbox_search"></a>Mailbox search</h3>
-<div class="paragraph">
-<p>The main use of OpenSearch within the Distributed Server is indexing the mailbox content of users in order to enable
-powerful and efficient full-text search of the mailbox content.</p>
-</div>
-<div class="paragraph">
-<p>Data indexing is performed asynchronously in a reliable fashion via a MailboxListener.</p>
-</div>
-<div class="paragraph">
-<p>Here are the properties related to the use of OpenSearch for Mailbox Search:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 2. opensearch.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.index.mailbox.name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Name of the mailbox index backed by the alias. It will be created if missing.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.index.name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Deprecated</strong> Use <strong>opensearch.index.mailbox.name</strong> instead.
-Name of the mailbox index backed by the alias. It will be created if missing.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.alias.read.mailbox.name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Name of the alias to use by Apache James for mailbox reads. It will be created if missing.
-The target of the alias is the index name configured above.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.alias.read.name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Deprecated</strong> Use <strong>opensearch.alias.read.mailbox.name</strong> instead.
-Name of the alias to use by Apache James for mailbox reads. It will be created if missing.
-The target of the alias is the index name configured above.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.alias.write.mailbox.name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Name of the alias to use by Apache James for mailbox writes. It will be created if missing.
-The target of the alias is the index name configured above.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.alias.write.name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Deprecated</strong> Use <strong>opensearch.alias.write.mailbox.name</strong> instead.
-Name of the alias to use by Apache James for mailbox writes. It will be created if missing.
-The target of the alias is the index name configured above.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.indexAttachments</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Indicates if you wish to index attachments or not (default: true).</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.indexHeaders</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Indicates if you wish to index headers or not (default: true). Note that specific headers
-(From, To, Cc, Bcc, Subject, Message-Id, Date, Content-Type) are still indexed in their dedicated type.
-Header indexing is expensive as each header currently need to be stored as a nested document but
-turning off headers indexing result in non-strict compliance with the IMAP / JMAP standards.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.message.index.optimize.move</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">When set to true, James will attempt to reindex from the indexed message when moved.
-If the message is not found, it will fall back to the old behavior (The message will be indexed from the blobStore source)
-Default to false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.indexBody</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Indicates if you wish to index body or not (default: true). This can be used to decrease the performance cost associated with indexing.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="sect2">
-<h3 id="_quota_search"><a class="anchor" href="#_quota_search"></a>Quota search</h3>
-<div class="paragraph">
-<p>Users are indexed by quota usage, allowing operators a quick audit of users quota occupation.</p>
-</div>
-<div class="paragraph">
-<p>Users quota are asynchronously indexed upon quota changes via a dedicated MailboxListener.</p>
-</div>
-<div class="paragraph">
-<p>The following properties affect quota search :</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 3. opensearch.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.index.quota.ratio.name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Specify the OpenSearch alias name used for quotas</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.alias.read.quota.ratio.name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Specify the OpenSearch alias name used for reading quotas</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.alias.write.quota.ratio.name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Specify the OpenSearch alias name used for writing quotas</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="sect2">
-<h3 id="_disabling_opensearch"><a class="anchor" href="#_disabling_opensearch"></a>Disabling OpenSearch</h3>
-<div class="paragraph">
-<p>OpenSearch component can be disabled but consider it would make search feature to not work. In particular it will break JMAP protocol and SEARCH IMAP comment in an nondeterministic way.
-This is controlled in the <code>search.properties</code> file via the <code>implementation</code> property (defaults
-to <code>OpenSearch</code>). Setting this configuration parameter to <code>scanning</code> will effectively disable OpenSearch, no
-further indexation will be done however searches will rely on the scrolling search, leading to expensive and longer
-searches. Disabling OpenSearch requires no extra action, however
-<a href="../operate/webadmin.html#_reindexing_all_mails" class="xref page">a full re-indexing</a>needs to be carried out when enabling OpenSearch.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_ssl_trusting_configuration"><a class="anchor" href="#_ssl_trusting_configuration"></a>SSL Trusting Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>By default, James will use the system TrustStore to validate https server certificates, if the certificate on
-ES side is already in the system TrustStore, you can leave the sslValidationStrategy property empty or set it to default.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 4. opensearch.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.hostScheme.https.sslValidationStrategy</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Accept only <strong>default</strong>, <strong>ignore</strong>, <strong>override</strong>. Default is <strong>default</strong>. default: Use the default SSL TrustStore of the system.
-ignore: Ignore SSL Validation check (not recommended).
-override: Override the SSL Context to use a custom TrustStore containing ES server’s certificate.</p></td>
-</tr>
-</tbody>
-</table>
-<div class="paragraph">
-<p>In some cases, you want to secure the connection from clients to ES by setting up a <strong>https</strong> protocol
-with a self signed certificate. And you prefer to left the system ca-certificates un touch.
-There are possible solutions to let the ES RestHighLevelClient to trust your self signed certificate.</p>
-</div>
-<div class="paragraph">
-<p>Second solution: importing a TrustStore containing the certificate into SSL context.
-A certificate normally contains two parts: a public part in .crt file, another private part in .key file.
-To trust the server, the client needs to be acknowledged that the server’s certificate is in the list of
-client’s TrustStore. Basically, you can create a local TrustStore file containing the public part of a remote server
-by execute this command:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>keytool -import -v -trustcacerts -file certificatePublicFile.crt -keystore trustStoreFileName.jks -keypass fillThePassword -storepass fillThePassword</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>When there is a TrustStore file and the password to read, fill two options <strong>trustStorePath</strong>
-and <strong>trustStorePassword</strong> with the TrustStore location and the password. ES client will accept
-the certificate of ES service.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 5. opensearch.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.hostScheme.https.trustStorePath</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Use it when https is configured in opensearch.hostScheme, and sslValidationStrategy is <strong>override</strong>
-Configure OpenSearch rest client to use this trustStore file to recognize nginx’s ssl certificate.
-Once you chose <strong>override</strong>, you need to specify both trustStorePath and trustStorePassword.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.hostScheme.https.trustStorePassword</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Use it when https is configured in opensearch.hostScheme, and sslValidationStrategy is <strong>override</strong>
-Configure OpenSearch rest client to use this trustStore file with the specified password.
-Once you chose <strong>override</strong>, you need to specify both trustStorePath and trustStorePassword.</p></td>
-</tr>
-</tbody>
-</table>
-<div class="paragraph">
-<p>During SSL handshaking, the client can determine whether accept or reject connecting to a remote server by its hostname.
-You can configure to use which HostNameVerifier in the client.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 6. opensearch.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">opensearch.hostScheme.https.hostNameVerifier</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Default is <strong>default</strong>. default: using the default hostname verifier provided by apache http client.
-accept_any_hostname: accept any host (not recommended).</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_search_overrides"><a class="anchor" href="#_search_overrides"></a>Search overrides</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p><strong>Search overrides</strong> allow resolution of predefined search queries against alternative sources of data
-and allow bypassing OpenSearch. This is useful to handle most resynchronisation queries that
-are simple enough to be resolved against Cassandra.</p>
-</div>
-<div class="paragraph">
-<p>Possible values are:
- - <code>org.apache.james.mailbox.cassandra.search.AllSearchOverride</code> Some IMAP clients uses SEARCH ALL to fully list messages in
- a mailbox and detect deletions. This is typically done by clients not supporting QRESYNC and from an IMAP perspective
- is considered an optimisation as less data is transmitted compared to a FETCH command. Resolving such requests against
- Cassandra is enabled by this search override and likely desirable.
- - <code>org.apache.james.mailbox.cassandra.search.UidSearchOverride</code>. Same as above but restricted by ranges.
- - <code>org.apache.james.mailbox.cassandra.search.DeletedSearchOverride</code>. Find deleted messages by looking up in the relevant Cassandra
- table.
- - <code>org.apache.james.mailbox.cassandra.search.DeletedWithRangeSearchOverride</code>. Same as above but limited by ranges.
- - <code>org.apache.james.mailbox.cassandra.search.NotDeletedWithRangeSearchOverride</code>. List non deleted messages in a given range.
- Lists all messages and filters out deleted message thus this is based on the following heuristic: most messages are not marked as deleted.
- - <code>org.apache.james.mailbox.cassandra.search.UnseenSearchOverride</code>. List unseen messages in the corresponding cassandra projection.</p>
-</div>
-<div class="paragraph">
-<p>Please note that custom overrides can be defined here. <code>opensearch.search.overrides</code> allow specifying search overrides and is a
-coma separated list of search override FQDNs. Default to none.</p>
-</div>
-<div class="paragraph">
-<p>EG:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>opensearch.search.overrides=org.apache.james.mailbox.cassandra.search.AllSearchOverride,org.apache.james.mailbox.cassandra.search.DeletedSearchOverride, org.apache.james.mailbox.cassandra.search.DeletedWithRangeSearchOverride,org.apache.james.mailbox.cassandra.search.NotDeletedWithRangeSearchOverride,org.apache.james.mailbox.cassandra.search.UidSearchOverride,org.apache.james.mailbox.cassandra.search.UnseenSearchOverride</pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_configure_dedicated_language_analyzers_for_mailbox_index"><a class="anchor" href="#_configure_dedicated_language_analyzers_for_mailbox_index"></a>Configure dedicated language analyzers for mailbox index</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>OpenSearch supports various language analyzers out of the box: <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/analysis-lang-analyzer.html" class="bare">https://www.elastic.co/guide/en/elasticsearch/reference/current/analysis-lang-analyzer.html</a>.</p>
-</div>
-<div class="paragraph">
-<p>James could utilize this to improve the user searching experience upon his language.</p>
-</div>
-<div class="paragraph">
-<p>While one could modify mailbox index mapping programmatically to customize this behavior, here we should just document a manual way to archive this without breaking our common index' mapping code.</p>
-</div>
-<div class="paragraph">
-<p>The idea is modifying mailbox index mappings with the target language analyzer as a JSON file, then submit it directly
-to OpenSearch via cURL command to create the mailbox index before James start. Let’s adapt dedicated language analyzers
-where appropriate for the following fields:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 7. Language analyzers propose change</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Field</th>
-<th class="tableblock halign-left valign-top">Analyzer change</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">from.name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>keep_mail_and_url</code> analyzer → <code>keep_mail_and_url_language_a</code> analyzer</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">subject</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>keep_mail_and_url</code> analyzer → <code>keep_mail_and_url_language_a</code> analyzer</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">to.name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>keep_mail_and_url</code> analyzer → <code>keep_mail_and_url_language_a</code> analyzer</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cc.name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>keep_mail_and_url</code> analyzer → <code>keep_mail_and_url_language_a</code> analyzer</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">bcc.name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>keep_mail_and_url</code> analyzer → <code>keep_mail_and_url_language_a</code> analyzer</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">textBody</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>standard</code> analyzer → <code>language_a</code> analyzer</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">htmlBody</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>standard</code> analyzer → <code>language_a</code> analyzer</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">attachments.fileName</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>standard</code> analyzer → <code>language_a</code> analyzer</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">attachments.textContent</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>standard</code> analyzer → <code>language_a</code> analyzer</p></td>
-</tr>
-</tbody>
-</table>
-<div class="paragraph">
-<p>In there:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>keep_mail_and_url</code> and <code>standard</code> are our current analyzers for mailbox index.</p>
-</li>
-<li>
-<p><code>language_a</code> analyzer: the built-in analyzer of OpenSearch. EG: <code>french</code></p>
-</li>
-<li>
-<p><code>keep_mail_and_url_language_a</code> analyzer: a custom of <code>keep_mail_and_url</code> analyzer with some language filters.Every language has
-their own filters so please have a look at filters which your language need to add. EG which need to be added for French:</p>
-</li>
-</ul>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>"filter": {
- "french_elision": {
- "type": "elision",
- "articles_case": true,
- "articles": [
- "l", "m", "t", "qu", "n", "s",
- "j", "d", "c", "jusqu", "quoiqu",
- "lorsqu", "puisqu"
- ]
- },
- "french_stop": {
- "type": "stop",
- "stopwords": "_french_"
- },
- "french_stemmer": {
- "type": "stemmer",
- "language": "light_french"
- }
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>After modifying above proposed change, you should have a JSON file that contains new setting and mapping of mailbox index. Here
-we provide <a href="https://github.com/apache/james-project/blob/master/mailbox/opensearch/example_french_index.json">a sample JSON for French language</a>.
-If you want to customize that JSON file for your own language need, please make these modifications:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Replace the <code>french</code> analyzer with your built-in language (have a look at <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/analysis-lang-analyzer.html">built-in language analyzers</a>)</p>
-</li>
-<li>
-<p>Modify <code>keep_mail_and_url_french</code> analyzer' filters with your language filters, and customize the analyzer' name.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Please change also <code>number_of_shards</code>, <code>number_of_replicas</code> and <code>index.write.wait_for_active_shards</code> values in the sample file according to your need.</p>
-</div>
-<div class="paragraph">
-<p>Run this cURL command with above JSON file to create <code>mailbox_v1</code> (Mailbox index' default name) index before James start:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>curl -X PUT ES_IP:ES_PORT/mailbox_v1 -H "Content-Type: application/json" -d @example_french_index.json</pre>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/configure/pop3.html b/james-distributed-app/3.8.1/configure/pop3.html
deleted file mode 100644
index 2bb1c4f..0000000
--- a/james-distributed-app/3.8.1/configure/pop3.html
+++ /dev/null
@@ -1,503 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — pop3server.xml :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Protocols</li>
- <li><a href="pop3.html">pop3server.xml</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/pop3.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — pop3server.xml</h1>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/pop3server.xml">example</a>
-to get some examples and hints.</p>
-</div>
-<div class="paragraph">
-<p>The POP3 service is controlled by a configuration block in the pop3server.xml.
-The pop3server tag defines the boundaries of the configuration block. It encloses
-all the relevant configuration for the POP3 server. The behavior of the POP service is
-controlled by the attributes and children of this tag.</p>
-</div>
-<div class="paragraph">
-<p>This tag has an optional boolean attribute - <strong>enabled</strong> - that defines whether the service is active or not.
-The value defaults to "true" if not present.</p>
-</div>
-<div class="paragraph">
-<p>The standard children of the pop3server tag are:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. jmx.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">bind</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure this to bind to a specific inetaddress. This is an optional integer value.
-This value is the port on which this POP3 server is configured
-to listen. If the tag or value is absent then the service
-will bind to all network interfaces for the machine If the tag or value is omitted,
-the value will default to the standard POP3 port, 11
-port 995 is the well-known/IANA registered port for POP3S ie over SSL/TLS
-port 110 is the well-known/IANA registered port for Standard POP3</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connectionBacklog</p></td>
-<td class="tableblock halign-left valign-top"></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tls</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set to true to support STARTTLS or SSL for the Socket.
-To create a new keystore execute:
-<code>keytool -genkey -alias james -keyalg RSA -storetype PKCS12 -keystore /path/to/james/conf/keystore</code>
-Please note that each POP3 server exposed on different port can specify its own keystore, independently from any other
-TLS based protocols. Read <a href="ssl.html" class="xref page">SSL configuration page</a> for more information.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">handler.helloName</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">This is the name used by the server to identify itself in the POP3
-protocol. If autodetect is TRUE, the server will discover its
-own host name and use that in the protocol. If discovery fails,
-the value of 'localhost' is used. If autodetect is FALSE, James
-will use the specified value.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">handler.connectiontimeout</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Connection timeout in seconds</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">handler.connectionLimit</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum simultaneous incoming connections for this service</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">handler.connectionLimitPerIP</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum simultaneous incoming connections per IP for this service</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">handler.handlerchain</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">This loads the core CommandHandlers. Only remove this if you really know what you are doing.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">bossWorkerCount</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum count of boss threads. Boss threads are responsible for accepting incoming POP3 connections
-and initializing associated resources. Optional integer, by default, boss threads are not used and this responsibility is being dealt with
-by IO threads.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ioWorkerCount</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum count of IO threads. IO threads are responsible for receiving incoming POP3 messages and framing them
-(split line by line). IO threads also take care of compression and SSL encryption. Their tasks are short-lived and non-blocking.
-Optional integer, defaults to 2 times the count of CPUs.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">maxExecutorCount</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum count of worker threads. Worker threads takes care of potentially blocking tasks like executing POP3 requests. Optional integer, defaults to 16.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">useEpoll</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false - If true uses native EPOLL implementation for Netty otherwise uses NIO. Defaults to false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">gracefulShutdown</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false - If true attempts a graceful shutdown, which is safer but can take time. Defaults to true.</p></td>
-</tr>
-</tbody>
-</table>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/configure/queue.html b/james-distributed-app/3.8.1/configure/queue.html
deleted file mode 100644
index a802a3c..0000000
--- a/james-distributed-app/3.8.1/configure/queue.html
+++ /dev/null
@@ -1,442 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — queue.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="queue.html">Distributed James Server — queue.properties</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/queue.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — queue.properties</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This configuration helps you configure mail queue you want to select.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_queue_configuration"><a class="anchor" href="#_queue_configuration"></a>Queue Configuration</h2>
-<div class="sectionbody">
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. queue.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mail.queue.choice</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Mail queue can be implemented by many type of message brokers: Pulsar, RabbitMQ,…​ This property will choose which mail queue you want, defaulting to RABBITMQ</p></td>
-</tr>
-</tbody>
-</table>
-<div class="paragraph">
-<p><code>mail.queue.choice</code> supports the following options:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>You can specify the <code>RABBITMQ</code> if you want to choose RabbitMQ mail queue</p>
-</li>
-<li>
-<p>You can specify the <code>PULSAR</code> if you want to choose Pulsar mail queue</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/configure/rabbitmq.html b/james-distributed-app/3.8.1/configure/rabbitmq.html
deleted file mode 100644
index 37f2400..0000000
--- a/james-distributed-app/3.8.1/configure/rabbitmq.html
+++ /dev/null
@@ -1,694 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — rabbitmq.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Storage dependencies</li>
- <li><a href="rabbitmq.html">rabbitmq.properties</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/rabbitmq.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — rabbitmq.properties</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This configuration helps you configure components using RabbitMQ.</p>
-</div>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/rabbitmq.properties">example</a>
-to get some examples and hints.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_rabbitmq_configuration"><a class="anchor" href="#_rabbitmq_configuration"></a>RabbitMQ Configuration</h2>
-<div class="sectionbody">
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. rabbitmq.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">uri</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">the amqp URI pointing to RabbitMQ server. If you use a vhost, specify it as well at the end of the URI.
-Details about amqp URI format is in <a href="https://www.rabbitmq.com/uri-spec.html">RabbitMQ URI Specification</a></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">management.uri</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">the URI pointing to RabbitMQ Management Service. James need to retrieve some information about listing queues
-from this service in runtime.
-Details about URI format is in <a href="https://www.rabbitmq.com/management.html#usage-ui">RabbitMQ Management URI</a></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">management.user</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">username used to access management service</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">management.password</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">password used to access management service</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connection.pool.retries</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure retries count to retrieve a connection. Exponential backoff is performed between each retries.
-Optional integer, defaults to 10</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connection.pool.min.delay.ms</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure initial duration (in ms) between two connection retries. Exponential backoff is performed between each retries.
-Optional integer, defaults to 100</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">channel.pool.retries</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure retries count to retrieve a channel. Exponential backoff is performed between each retries.
-Optional integer, defaults to 3</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">channel.pool.max.delay.ms</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure timeout duration (in ms) to obtain a rabbitmq channel. Defaults to 30 seconds.
-Optional integer, defaults to 30 seconds.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">channel.pool.size</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure the size of the channel pool.
-Optional integer, defaults to 3</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ssl.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Is using ssl enabled
-Optional boolean, defaults to false</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ssl.management.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Is using ssl on management api enabled
-Optional boolean, defaults to false</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ssl.validation.strategy</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure the validation strategy used for rabbitmq connections. Possible values are default, ignore and override.
-Optional string, defaults to using systemwide ssl configuration</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ssl.truststore</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Points to the truststore (PKCS12) used for verifying rabbitmq connection. If configured then "ssl.truststore.password" must also be configured,
-Optional string, defaults to systemwide truststore. "ssl.validation.strategy: override" must be configured if you want to use this</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ssl.truststore.password</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure the truststore password. If configured then "ssl.truststore" must also be configured,
-Optional string, defaults to empty string. "ssl.validation.strategy: override" must be configured if you want to use this</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ssl.hostname.verifier</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure host name verification. Possible options are default and accept_any_hostname
-Optional string, defaults to subject alternative name host verifier</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ssl.keystore</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Points to the keystore(PKCS12) used for client certificate authentication. If configured then "ssl.keystore.password" must also be configured,
-Optional string, defaults to empty string</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ssl.keystore.password</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure the keystore password. If configured then "ssl.keystore" must also be configured,
-Optional string, defaults to empty string</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">quorum.queues.enable</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Boolean. Whether to activate Quorum queue usage for use cases that benefits from it (work queue).
-Quorum queues enables high availability.
-False (default value) results in the usage of classic queues.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">quorum.queues.replication.factor</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Strictly positive integer. The replication factor to use when creating quorum queues.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">quorum.queues.delivery.limit</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Strictly positive integer. Value for x-delivery-limit queue parameter, default to none. Setting a delivery limit can
-prevent RabbitMQ outage if message processing fails. Read <a href="https://www.rabbitmq.com/docs/quorum-queues#poison-message-handling" class="bare">https://www.rabbitmq.com/docs/quorum-queues#poison-message-handling</a></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">hosts</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional, default to the host specified as part of the URI.
-Allow creating cluster aware connections.
-A coma separated list of hosts, example: hosts=ip1:5672,ip2:5672</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailqueue.publish.confirm.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Whether or not to enable publish confirms for the mail queue. Optional boolean, defaults to true.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">event.bus.publish.confirm.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Whether or not to enable publish confirms for the event bus. Optional boolean, defaults to true.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">event.bus.notification.durability.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Whether or not the queue backing notifications should be durable. Optional boolean, defaults to true.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">vhost</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional string. This parameter is only a workaround to support invalid URIs containing character like '_'.
-You still need to specify the vhost in the uri parameter.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_tuning_rabbitmq_for_quorum_queue_use"><a class="anchor" href="#_tuning_rabbitmq_for_quorum_queue_use"></a>Tuning RabbitMQ for quorum queue use</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>While quorum queues are great at preserving your data and enabling High Availability, they demand more resources and
-a greater care than regular RabbitMQ queues.</p>
-</div>
-<div class="paragraph">
-<p>See <a href="https://www.rabbitmq.com/docs/quorum-queues#performance-tuning">this section of RabbitMQ documentation regarding RabbitMQ quroum queue performance tunning</a>.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Provide decent amount of RAM memory to RabbitMQ. 4GB is a good start.</p>
-</li>
-<li>
-<p>Setting a delivery limit is advised as looping messages can cause extreme memory consumptions onto quorum queues.</p>
-</li>
-<li>
-<p>Set up Raft for small messages:</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>raft.segment_max_entries = 32768</pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_rabbitmq_mailqueue_configuration"><a class="anchor" href="#_rabbitmq_mailqueue_configuration"></a>RabbitMQ MailQueue Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>James mail queue is a component acting like a queue where it can enqueue and dequeue mails.
-Beside of the basic features, it also allows some extra operations like getting size, browsing all items in the mail queue…​
-One of the mailqueue implementation is using RabbitMQ.
-As RabbitMQ doesn’t offer enough features to implement efficiently all mailqueue operations,
-this implementation relies on Cassandra.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 2. rabbitmq.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandra.view.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Whether the Cassandra administrative view should be activated. Boolean value defaulting to true.
-Not necessarily needed for MDA deployments, mail queue management adds significant complexity.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailqueue.view.sliceWindow</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">James divides the view into slices, each slice contains data for a given period, sliceWindow parameter controls this period.
-This dividing of periods allows faster browsing of the mail queue. Tips for choosing sliceWindow are explained in
-<a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/rabbitmq.properties">rabbitmq.properties</a></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailqueue.view.bucketCount</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Mails in a mail queue are distributed across the underlying storage service.
-BucketCount describes how to be distributing mails to fit with your James setup
-Tips for choosing bucketCount are explained in
-<a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/rabbitmq.properties">rabbitmq.properties</a></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailqueue.view.updateBrowseStartPace</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">To browse, James needs a starting point and to continuously update that point in runtime.
-UpdateBrowseStartPace describes the probability to update the starting point.
-Tips for choosing updateBrowseStartPace are explained in
-<a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/rabbitmq.properties">rabbitmq.properties</a></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailqueue.size.metricsEnabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">By default, the metrics are disabled for the mail queue size.
-As computing the size of the mail queue is currently implemented on top of browse operation and thus has a linear complexity,
-sometimes it can get too big, making it impossible for the ES reporter to handle it correctly without crashing.
-It can be useful then to disable it.
-Tips for choosing metricsEnabled are explained in
-<a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/rabbitmq.properties">rabbitmq.properties</a></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">notification.queue.ttl</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure queue ttl (in ms). References: <a href="https://www.rabbitmq.com/ttl.html#queue-ttl" class="bare">https://www.rabbitmq.com/ttl.html#queue-ttl</a>.
-This is used only on queues used to share notification patterns, are exclusive to a node. If omitted, it will not add the TTL configure when declaring queues.
-Optional integer, defaults is 3600000.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_rabbitmq_tasks_configuration"><a class="anchor" href="#_rabbitmq_tasks_configuration"></a>RabbitMQ Tasks Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Tasks are WebAdmin triggered long running jobs. RabbitMQ is used to organise their execution in a work queue,
-with an exclusive consumer.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 3. rabbitmq.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">task.consumption.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Whether to enable task consumption on this node.
-Disable with caution (this only makes sense in a distributed setup where other nodes consume tasks).
-Defaults to true.</p>
-<p class="tableblock">Limitation: Sometimes, some tasks running on James can be very heavy and take a couple of hours to complete.
-If other tasks are being triggered meanwhile on WebAdmin, they go on the TaskManagerWorkQueue and James unack them,
-telling RabbitMQ it will consume them later. If they don’t get consumed before the consumer timeout setup in
-RabbitMQ (default being 30 minutes), RabbitMQ closes the channel on an exception. It is thus advised to declare a
-longer timeout in rabbitmq.conf. More <a href="https://www.rabbitmq.com/consumers.html#acknowledgement-timeout">here</a>.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">task.queue.consumer.timeout</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Task queue consumer timeout.</p>
-<p class="tableblock">Optional. Duration (support multiple time units cf <code>DurationParser</code>), defaults to 1 day.</p>
-<p class="tableblock">Required at least RabbitMQ version 3.12 to have effect.
-This is used to avoid the task queue consumer (which could run very long tasks) being disconnected by RabbitMQ after the default acknowledgement timeout 30 minutes.
-References: <a href="https://www.rabbitmq.com/consumers.html#acknowledgement-timeout" class="bare">https://www.rabbitmq.com/consumers.html#acknowledgement-timeout</a>.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/configure/recipientrewritetable.html b/james-distributed-app/3.8.1/configure/recipientrewritetable.html
deleted file mode 100644
index 7c51b1a..0000000
--- a/james-distributed-app/3.8.1/configure/recipientrewritetable.html
+++ /dev/null
@@ -1,431 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — recipientrewritetable.xml :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Core components</li>
- <li><a href="recipientrewritetable.html">recipientrewritetable.xml</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/recipientrewritetable.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — recipientrewritetable.xml</h1>
-<div class="paragraph">
-<p>Here are explanations on the different kinds about <a href="../architecture/index.html#_recipient_rewrite_tables" class="xref page">recipient rewriting</a>.</p>
-</div>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/recipientrewritetable.xml">example</a>
-to get some examples and hints.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. recipientrewritetable.xml</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">recursiveMapping</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">If set to false only the first mapping will get processed - Default true.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mappingLimit</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">By setting the mappingLimit you can specify how much mapping will get processed before a bounce will send. This avoids infinity loops. Default 10.</p></td>
-</tr>
-</tbody>
-</table>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/configure/redis.html b/james-distributed-app/3.8.1/configure/redis.html
deleted file mode 100644
index 38efc5f..0000000
--- a/james-distributed-app/3.8.1/configure/redis.html
+++ /dev/null
@@ -1,448 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — redis.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Storage dependencies</li>
- <li><a href="redis.html">redis.properties</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/redis.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — redis.properties</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This configuration helps you configure components using Redis. This so far only includes optional rate limiting component.</p>
-</div>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/fabfdf4874da3aebb04e6fe4a7277322a395536a/server/mailet/rate-limiter-redis/redis.properties">example</a>
-to get some examples and hints.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_redis_configuration"><a class="anchor" href="#_redis_configuration"></a>Redis Configuration</h2>
-<div class="sectionbody">
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. redis.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">redisURL</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">the Redis URI pointing to Redis server. Compulsory.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cluster.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Whether we should attempt connections to Redis as a cluster.Defaults to false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">redis.ioThreads</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">IO threads to be using for the underlying Netty networking resources. If unspecified driver defaults applies.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">redis.workerThreads</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Worker threads to be using for the underlying driver. If unspecified driver defaults applies.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/configure/remote-delivery-error-handling.html b/james-distributed-app/3.8.1/configure/remote-delivery-error-handling.html
deleted file mode 100644
index 489e4ff..0000000
--- a/james-distributed-app/3.8.1/configure/remote-delivery-error-handling.html
+++ /dev/null
@@ -1,585 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — About RemoteDelivery error handling :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Extensions</li>
- <li><a href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/remote-delivery-error-handling.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — About RemoteDelivery error handling</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>The advanced server mailQueue implemented by combining RabbitMQ for messaging and Cassandra for administrative operation
-does not support delays.</p>
-</div>
-<div class="paragraph">
-<p>Delays are an important feature for Mail Exchange servers, allowing to defer in time the retries, potentially letting the
-time for the remote server to recover. Furthermore, they enable implementation of advanced features like throttling and
-rate limiting of emails sent to a given domain.</p>
-</div>
-<div class="paragraph">
-<p>As such, the use of the distributed server as a Mail Exchange server is currently discouraged.</p>
-</div>
-<div class="paragraph">
-<p>However, for operators willing to inter-operate with a limited set of well-identified, trusted remote mail servers, such
-limitation can be reconsidered. The main concern then become error handling for remote mail server failures. The following
-document will present a well tested strategy for Remote Delivery error handling leveraging standards Mail Processing components
-and mechanisms.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_expectations"><a class="anchor" href="#_expectations"></a>Expectations</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Such a solution should:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Attempt delivery a single time</p>
-</li>
-<li>
-<p>Store transient and permanent failure in different mail repositories</p>
-</li>
-<li>
-<p>After a given number of tries, transient failures should be considered permanent</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_design"><a class="anchor" href="#_design"></a>Design</h2>
-<div class="sectionbody">
-<div class="imageblock">
-<div class="content">
-<img src="../_images/remote-delivery-error-handling.png" alt="Schema detailing the proposed solution">
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Remote Delivery is configured for performing a single retry.</p>
-</li>
-<li>
-<p>Remote Delivery attaches the error code and if the failure is permanent/temporary when transferring failed emails to the
-bounce processor.</p>
-</li>
-<li>
-<p>The specified bounce processor will categorise the failure, and store temporary and permanent failures in different
-mail repositories.</p>
-</li>
-<li>
-<p>A reprocessing of the temporary delivery errors mailRepository needs to be scheduled in a recurring basis. For
-instance via a CRON job calling the right webadmin endpoint.</p>
-</li>
-<li>
-<p>A counter ensures that a configured number of delivery tries is not exceeded.</p>
-</li>
-</ul>
-</div>
-<div class="sect2">
-<h3 id="_limitation"><a class="anchor" href="#_limitation"></a>Limitation</h3>
-<div class="paragraph">
-<p>MailRepositories are not meant for transient data storage, and thus are prone to tombstone issues.</p>
-</div>
-<div class="paragraph">
-<p>This might be acceptable if you need to send mail to well-known peers. For instance handling your mail gateway failures.
-However a Mail Exchange server doing relay on the internet would quickly hit this limitation.</p>
-</div>
-<div class="paragraph">
-<p>Also note that external triggering of the retry process is needed.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_operation"><a class="anchor" href="#_operation"></a>Operation</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Here is an example of configuration achieving the proposed solution:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> <processor state="relay" enableJmx="true">
- <!-- Perform at most 5 RemoteDelivery attemps -->
- <mailet match="AtMost=5" class="RemoteDelivery">
- <outgoingQueue>outgoing</outgoingQueue>
- <maxRetries>0</maxRetries>
- <maxDnsProblemRetries>0</maxDnsProblemRetries>
- <deliveryThreads>10</deliveryThreads>
- <sendpartial>true</sendpartial>
- <!-- Use a custom processor for error handling -->
- <bounceProcessor>remote-delivery-error</bounceProcessor>
- </mailet>
- <!-- When retries are exceeded, consider the mail as a permanent failure -->
- <mailet match="All" class="ToRepository">
- <repositoryPath>cassandra://var/mail/error/remote-delivery/permanent/</repositoryPath>
- </mailet>
- </processor>
-
- <processor state="remote-delivery-error" enableJmx="true">
- <!-- Store temporary failures separately for later retries -->
- <mailet match="IsRemoteDeliveryTemporaryError" class="ToRepository">
- <repositoryPath>cassandra://var/mail/error/remote-delivery/temporary/</repositoryPath>
- </mailet>
- <!-- Store permanent failures for audit -->
- <mailet match="IsRemoteDeliveryPermanentError" class="ToRepository">
- <repositoryPath>cassandra://var/mail/error/remote-delivery/permanent/</repositoryPath>
- </mailet>
- <!-- Mail getting that far were not processed by remote delivery.
- Likely a configuration error. -->
- <mailet match="All" class="ToRepository">
- <repositoryPath>cassandra://var/mail/error/</repositoryPath>
- </mailet>
- </processor></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>The <strong>relay</strong> processor holds a RemoteDelivery mailet configured to do a single try, at most 5 times (see the AtMost matcher).
-Mails exceeding the AtMost condition are considered as permanent delivery errors. Delivery errors are sent to the
-<strong>remote-delivery-error</strong> processor.</p>
-</li>
-<li>
-<p>The <strong>remote-delivery-error</strong> stores temporary and permanent errors.</p>
-</li>
-<li>
-<p>Permanent relay errors are stored in <code>cassandra://var/mail/error/remote-delivery/permanent/</code>.</p>
-</li>
-<li>
-<p>Temporary relay errors are stored in <code>cassandra://var/mail/error/remote-delivery/temporary/</code>.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>In order to retry the relay of temporary failed emails, operators will have to configure a cron job for reprocessing
-emails from <strong>cassandra://var/mail/error/remote-delivery/temporary/</strong> mailRepository into the <strong>relay</strong> processor.</p>
-</div>
-<div class="paragraph">
-<p>This can be achieved via the following webAdmin call :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPATCH 'http://ip:8000/mailRepositories/cassandra%3A%2F%2Fvar%2Fmail%2Ferror%2Fremote-delivery%2Ftemporary%2F/mails?action=reprocess&processor=relay'</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>See <a href="../operate/webadmin.html#_reprocessing_mails_from_a_mail_repository" class="xref page">the documentation</a>.</p>
-</div>
-<div class="paragraph">
-<p>Administrators need to keep a close eye on permanent errors (that might require audit, and potentially contacting the remote
-service supplier).</p>
-</div>
-<div class="paragraph">
-<p>To do so, one should regularly audit the content of <strong>cassandra://var/mail/error/remote-delivery/permanent/</strong>. This can be done
-via webAdmin calls:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET 'http://ip:8000/mailRepositories/cassandra%3A%2F%2Fvar%2Fmail%2Ferror%2Fremote-delivery%2Ftemporary%2F/mails'</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>See <a href="../operate/webadmin.html#_listing_mails_contained_in_a_mail_repository" class="xref page">the documentation</a>.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/configure/search.html b/james-distributed-app/3.8.1/configure/search.html
deleted file mode 100644
index 64cdb81..0000000
--- a/james-distributed-app/3.8.1/configure/search.html
+++ /dev/null
@@ -1,429 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Search configuration :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Core components</li>
- <li><a href="search.html">search.properties</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/search.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Search configuration</h1>
-<div class="paragraph">
-<p>This configuration helps you configure the components used to back search.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. search.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">implementation</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The implementation to be used for search. Should be one of:
- - <strong>opensearch</strong> : Index and search mails into OpenSearch.
- - <strong>scanning</strong> : Do not index documents and perform scanning search, scrolling mailbox for matching contents.
- This implementation can have a prohibitive cost.
- - <strong>opensearch-disabled</strong> : Saves events to index into event dead letter. Make searches fails.
- This is useful to start James without OpenSearch while still tracking messages to index for later recovery. This
- can be used in order to ease delays for disaster recovery action plans.</p></td>
-</tr>
-</tbody>
-</table>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/configure/sieve.html b/james-distributed-app/3.8.1/configure/sieve.html
deleted file mode 100644
index 8b4220c..0000000
--- a/james-distributed-app/3.8.1/configure/sieve.html
+++ /dev/null
@@ -1,549 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Sieve :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Protocols</li>
- <li><a href="sieve.html">Sieve & ManageSieve</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/sieve.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Sieve</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>James servers are able to evaluate and execute Sieve scripts.</p>
-</div>
-<div class="paragraph">
-<p>Sieve is an extensible mail filtering language. It’s limited
-expressiveness (no loops or variables, no tests with side
-effects) allows user created scripts to be run safely on email
-servers. Sieve is targeted at the final delivery phase (where
-an incoming email is transferred to a user’s mailbox).</p>
-</div>
-<div class="paragraph">
-<p>The following Sieve capabilities are supported by Apache James:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://www.ietf.org/rfc/rfc2234.txt">RFC 2234 ABNF</a></p>
-</li>
-<li>
-<p><a href="https://www.ietf.org/rfc/rfc2244.txt">RFC 2244 ACAP</a></p>
-</li>
-<li>
-<p><a href="https://www.ietf.org/rfc/rfc2298.txt">RFC 2298 MDN</a></p>
-</li>
-<li>
-<p><a href="https://tools.ietf.org/html/rfc5228">RFC 5228 Sieve</a></p>
-</li>
-<li>
-<p><a href="https://tools.ietf.org/html/rfc4790">RFC 4790 IAPCR</a></p>
-</li>
-<li>
-<p><a href="https://tools.ietf.org/html/rfc5173">RFC 5173 Body Extension</a></p>
-</li>
-<li>
-<p><a href="https://datatracker.ietf.org/doc/html/rfc5230">RFC 5230 Vacations</a></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>To be correctly executed, please note that the <strong>Sieve</strong> mailet is required to be positioned prior the
-<strong>LocalDelivery</strong> mailet.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_managing_sieve_scripts"><a class="anchor" href="#_managing_sieve_scripts"></a>Managing Sieve scripts</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>A user willing to manage his Sieve scripts on the server can do so via several means:</p>
-</div>
-<div class="paragraph">
-<p>He can ask an admin to upload his script via the <a href="../operate/cli.html" class="xref page">CLI</a></p>
-</div>
-<div class="paragraph">
-<p>As James supports ManageSieve (<a href="https://datatracker.ietf.org/doc/html/rfc5804">RFC-5804</a>) a user
-can thus use compatible software to manage his Sieve scripts.</p></p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_managesieve_protocol"><a class="anchor" href="#_managesieve_protocol"></a>ManageSieve protocol</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p><strong>WARNING</strong>: ManageSieve protocol should be considered experimental.</p>
-</div>
-<div class="paragraph">
-<p>Consult <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/managesieveserver.xml">managesieveserver.xml</a>
-in GIT to get some examples and hints.</p>
-</div>
-<div class="paragraph">
-<p>The service is controlled by a configuration block in the managesieveserver.xml.
-The managesieveserver tag defines the boundaries of the configuration block. It encloses
-all the relevant configuration for the ManageSieve server. The behavior of the ManageSieve service is
-controlled by the attributes and children of this tag.</p>
-</div>
-<div class="paragraph">
-<p>This tag has an optional boolean attribute - <strong>enabled</strong> - that defines whether the service is active or not.
-The value defaults to "false" if
-not present.</p>
-</div>
-<div class="paragraph">
-<p>The standard children of the managesieveserver tag are:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. managesieveserver.xml content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">bind</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure this to bind to a specific inetaddress. This is an optional integer value. This value is the port on which this ManageSieve server is configured to listen. If the tag or value is absent then the service
-will bind to all network interfaces for the machine If the tag or value is omitted, the value will default to the standard ManageSieve port (port 4190 is the well-known/IANA registered port for ManageSieve.)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tls</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set to true to support STARTTLS or SSL for the Socket.
-To use this you need to copy sunjce_provider.jar to /path/james/lib directory. To create a new keystore execute:
-<code>keytool -genkey -alias james -keyalg RSA -storetype PKCS12 -keystore /path/to/james/conf/keystore</code>.
-Please note that each ManageSieve server exposed on different port can specify its own keystore, independently from any other
-TLS based protocols.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connectionBacklog</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Number of connection backlog of the server (maximum number of queued connection requests)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connectiontimeout</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Connection timeout in seconds</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connectionLimit</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum simultaneous incoming connections for this service</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connectionLimitPerIP</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum simultaneous incoming connections per IP for this service</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">bossWorkerCount</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum count of boss threads. Boss threads are responsible for accepting incoming ManageSieve connections
-and initializing associated resources. Optional integer, by default, boss threads are not used and this responsibility is being dealt with
-by IO threads.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ioWorkerCount</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum count of IO threads. IO threads are responsible for receiving incoming ManageSieve messages and framing them
-(split line by line). IO threads also take care of compression and SSL encryption. Their tasks are short-lived and non-blocking.
-Optional integer, defaults to 2 times the count of CPUs.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">maxExecutorCount</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum count of worker threads. Worker threads takes care of potentially blocking tasks like executing ManageSieve commands.
-Optional integer, defaults to 16.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/configure/smtp-hooks.html b/james-distributed-app/3.8.1/configure/smtp-hooks.html
deleted file mode 100644
index 6ff3ba6..0000000
--- a/james-distributed-app/3.8.1/configure/smtp-hooks.html
+++ /dev/null
@@ -1,833 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — SMTP Hooks :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Protocols</li>
- <li><a href="smtp-hooks.html">Packaged SMTP hooks</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/smtp-hooks.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — SMTP Hooks</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This documentation page lists and documents SMTP hooks that can be used within the
-Distributed Server SMTP protocol stack in order to customize the way your SMTP server
-behaves without of the box components.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_dnsrblhandler"><a class="anchor" href="#_dnsrblhandler"></a>DNSRBLHandler</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This command handler check against <a href="https://www.wikiwand.com/en/Domain_Name_System-based_Blackhole_List">RBL-Lists</a>
-(Real-time Blackhole List).</p>
-</div>
-<div class="paragraph">
-<p>If getDetail is set to true it try to retrieve information from TXT Record
-why the ip was blocked. Default to false.</p>
-</div>
-<div class="paragraph">
-<p>before you enable out the DNS RBL handler documented as an example below,
-please take a moment to review each block in the list.
-We have included some that various JAMES committers use,
-but you must decide which, if any, are appropriate
-for your environment.</p>
-</div>
-<div class="paragraph">
-<p>The mail servers hosting
-@apache.org mailing lists, for example, use a
-slightly different list than we have included below.
-And it is likely that most JAMES committers also have
-slightly different sets of lists.</p>
-</div>
-<div class="paragraph">
-<p>The SpamAssassin user’s list would be one good place to discuss the
-measured quality of various block lists.</p>
-</div>
-<div class="paragraph">
-<p>NOTA BENE: the domain names, below, are terminated
-with '.' to ensure that they are absolute names in
-DNS lookups. Under some circumstances, names that
-are not explicitly absolute could be treated as
-relative names, leading to incorrect results. This
-has been observed on *nix and MS-Windows platforms
-by users of multiple mail servers, and is not JAMES
-specific. If you are unsure what this means for you,
-please speak with your local system/network admins.</p>
-</div>
-<div class="paragraph">
-<p>This handler should be considered experimental.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><handlerchain>
- <!-- ... -->
- <handler class="org.apache.james.smtpserver.fastfail.DNSRBLHandler">
- <getDetail>false</getDetail>
- <rblservers>
- <whitelist>query.bondedsender.org.</whitelist>
- <blacklist>sbl-xbl.spamhaus.org.</blacklist>
- <blacklist>dul.dnsbl.sorbs.net.</blacklist>
- <blacklist>list.dsbl.org.</blacklist>
- </rblservers>
- </handler>
-</handlerchain></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_dsn_hooks"><a class="anchor" href="#_dsn_hooks"></a>DSN hooks</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The Distributed server has optional support for DSN (<a href="https://tools.ietf.org/html/rfc3461">RFC-3461</a>)</p>
-</div>
-<div class="paragraph">
-<p>Please read carefully <a href="dsn.html" class="xref page">this page</a>.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><smtpserver enabled="true">
- <...> <!-- The rest of your SMTP configuration, unchanged -->
- <handlerchain>
- <handler class="org.apache.james.smtpserver.dsn.DSNEhloHook"/>
- <handler class="org.apache.james.smtpserver.dsn.DSNMailParameterHook"/>
- <handler class="org.apache.james.smtpserver.dsn.DSNRcptParameterHook"/>
- <handler class="org.apache.james.smtpserver.dsn.DSNMessageHook"/>
- <...> <!-- other handlers, like: -->
- <handler class="org.apache.james.smtpserver.CoreCmdHandlerLoader"/> <!-- for instance -->
- </handlerchain>
-</smtpserver></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note that a specific configuration of <a href="mailetcontainer.html" class="xref page">mailetcontainer.xml</a> is
-required as well to be spec compliant.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_mailpriorityhandler"><a class="anchor" href="#_mailpriorityhandler"></a>MailPriorityHandler</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This handler can add a hint to the mail which tells the MailQueue which email should get processed first.</p>
-</div>
-<div class="paragraph">
-<p>Normally the MailQueue will just handle Mails in FIFO manner.</p>
-</div>
-<div class="paragraph">
-<p>Valid priority values are 1,5,9 where 9 is the highest.</p>
-</div>
-<div class="paragraph">
-<p>This handler should be considered experimental.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><handlerchain>
- <!-- ... -->
- <handler class="org.apache.james.smtpserver.MailPriorityHandler">
- <priorityEntries>
- <priorityEntry>
- <domain>yourdomain1</domain>
- <priority>1</priority>
- </priorityEntry>
- <priorityEntry>
- <domain>yourdomain2</domain>
- <priority>9</priority>
- </priorityEntry>
- <priorityEntries>
- </handler>
-</handlerchain></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_maxrcpthandler"><a class="anchor" href="#_maxrcpthandler"></a>MaxRcptHandler</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>If activated you can limit the maximal recipients.</p>
-</div>
-<div class="paragraph">
-<p>This handler should be considered experimental.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><handlerchain>
- <!-- ... -->
- <handler class="org.apache.james.smtpserver.fastfail.MaxRcptHandler">
- <maxRcpt>10</maxRcpt>
- </handler>
-</handlerchain></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_pop3beforesmtphandler"><a class="anchor" href="#_pop3beforesmtphandler"></a>POP3BeforeSMTPHandler</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This connect handler can be used to enable POP3 before SMTP support.</p>
-</div>
-<div class="paragraph">
-<p>Please note that only the ip get stored to identify an authenticated client.</p>
-</div>
-<div class="paragraph">
-<p>The expireTime is the time after which an ipAddress is handled as expired.</p>
-</div>
-<div class="paragraph">
-<p>This handler should be considered as unsupported.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><handlerchain>
- <!-- ... -->
- <handler class="org.apache.james.smtpserver.POP3BeforeSMTPHandler">
- <expireTime>1 hour</expireTime>
- </handler>
-</handlerchain></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_resolvableehlohelohandler"><a class="anchor" href="#_resolvableehlohelohandler"></a>ResolvableEhloHeloHandler</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Checks for resolvable HELO/EHLO before accept the HELO/EHLO.</p>
-</div>
-<div class="paragraph">
-<p>If checkAuthNetworks is set to true sender domain will be checked also for clients that
-are allowed to relay. Default is false.</p>
-</div>
-<div class="paragraph">
-<p>This handler should be considered experimental.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><handlerchain>
- <!-- ... -->
- <handler class="org.apache.james.smtpserver.fastfail.ResolvableEhloHeloHandler"/>
-</handlerchain></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_reverseequalsehlohelohandler"><a class="anchor" href="#_reverseequalsehlohelohandler"></a>ReverseEqualsEhloHeloHandler</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Checks HELO/EHLO is equal the reverse of the connecting client before accept it
-If checkAuthNetworks is set to true sender domain will be checked also for clients that
-are allowed to relay. Default is false.</p>
-</div>
-<div class="paragraph">
-<p>This handler should be considered experimental.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><handlerchain>
- <!-- ... -->
- <handler class="org.apache.james.smtpserver.fastfail.ReverseEqualsEhloHeloHandler"/>
-</handlerchain></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_setmimeheaderhandler"><a class="anchor" href="#_setmimeheaderhandler"></a>SetMimeHeaderHandler</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This handler allows you to add mime headers to the processed mails.</p>
-</div>
-<div class="paragraph">
-<p>This handler should be considered experimental.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><handlerchain>
- <!-- ... -->
- <handler class="org.apache.james.smtpserver.SetMimeHeaderHandler">
- <headername>SPF-test</headername>
- <headervalue>passed</headervalue>
- </handler>
-</handlerchain></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_spamassassinhandler"><a class="anchor" href="#_spamassassinhandler"></a>SpamAssassinHandler</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This MessageHandler could be used to check message against spamd before
-accept the email. So it’s possible to reject a message on smtplevel if a
-configured hits amount is reached.</p>
-</div>
-<div class="paragraph">
-<p>This handler should be considered experimental.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><handlerchain>
- <!-- ... -->
- <handler class="org.apache.james.smtpserver.fastfail.SpamAssassinHandler">
- <spamdHost>127.0.0.1</spamdHost>
- <spamdPort>783</spamdPort>
- <spamdRejectionHits>10</spamdRejectionHits>
- </handler>
-</handlerchain></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_spfhandler"><a class="anchor" href="#_spfhandler"></a>SPFHandler</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This command handler can be used to reject emails with not match the SPF record of the sender domain.</p>
-</div>
-<div class="paragraph">
-<p>If checkAuthNetworks is set to true sender domain will be checked also for clients that
-are allowed to relay. Default is false.</p>
-</div>
-<div class="paragraph">
-<p>This handler should be considered experimental.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><handlerchain>
- <!-- ... -->
- <handler class="org.apache.james.smtpserver.fastfail.SPFHandler">
- <blockSoftFail>false</blockSoftFail>
- <blockPermError>true</blockPermError>
- </handler>
-</handlerchain></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_urirblhandler"><a class="anchor" href="#_urirblhandler"></a>URIRBLHandler</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This MessageHandler could be used to extract domain out of the message and check
-this domains against uriRbllists. See <a href="http://www.surbl.org" class="bare">http://www.surbl.org</a> for more information.
-The message get rejected if a domain matched.</p>
-</div>
-<div class="paragraph">
-<p>This handler should be considered experimental.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><handlerchain>
- <!-- ... -->
- <handler class="org.apache.james.smtpserver.fastfail.URIRBLHandler">
- <action>reject</action>
- <getDetail>true</getDetail>
- <uriRblServers>
- <server>multi.surbl.org</server>
- </uriRblServers>
- </handler>
-</handlerchain></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_validrcpthandler"><a class="anchor" href="#_validrcpthandler"></a>ValidRcptHandler</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>With ValidRcptHandler, all email will get rejected which has no valid user.</p>
-</div>
-<div class="paragraph">
-<p>You need to add the recipient to the validRecipient list if you want
-to accept email for a recipient which not exist on the server.</p>
-</div>
-<div class="paragraph">
-<p>If you want James to act as a spamtrap or honeypot, you may comment ValidRcptHandler
-and implement the needed processors in spoolmanager.xml.</p>
-</div>
-<div class="paragraph">
-<p>This handler should be considered stable.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><handlerchain>
- <!-- ... -->
- <handler class="org.apache.james.smtpserver.fastfail.ValidRcptHandler"/>
-</handlerchain></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_validsenderdomainhandler"><a class="anchor" href="#_validsenderdomainhandler"></a>ValidSenderDomainHandler</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>If activated mail is only accepted if the sender contains
-a resolvable domain having a valid MX Record or A Record associated!</p>
-</div>
-<div class="paragraph">
-<p>If checkAuthNetworks is set to true sender domain will be checked also for clients that
-are allowed to relay. Default is false.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><handlerchain>
- <!-- ... -->
- <handler class="org.apache.james.smtpserver.fastfail.ValidSenderDomainHandler"/>
-</handlerchain></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_futurerelease_hooks"><a class="anchor" href="#_futurerelease_hooks"></a>FUTURERELEASE hooks</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The Distributed server has optional support for FUTURERELEASE (<a href="https://www.rfc-editor.org/rfc/rfc4865.html">RFC-4865</a>)</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><smtpserver enabled="true">
- <...> <!-- The rest of your SMTP configuration, unchanged -->
- <handlerchain>
- <handler class="org.apache.james.smtpserver.futurerelease.FutureReleaseEHLOHook"/>
- <handler class="org.apache.james.smtpserver.futurerelease.FutureReleaseMailParameterHook"/>
- <handler class="org.apache.james.smtpserver.CoreCmdHandlerLoader"/>
- </handlerchain>
-</smtpserver></pre>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/configure/smtp.html b/james-distributed-app/3.8.1/configure/smtp.html
deleted file mode 100644
index d7bf2ed..0000000
--- a/james-distributed-app/3.8.1/configure/smtp.html
+++ /dev/null
@@ -1,785 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — smtpserver.xml :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Protocols</li>
- <li><a href="smtp.html">smtpserver.xml & lmtpserver.xml</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/smtp.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — smtpserver.xml</h1>
-<div class="sect1">
-<h2 id="_incoming_smtp"><a class="anchor" href="#_incoming_smtp"></a>Incoming SMTP</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/smtpserver.xml">example</a>
-to get some examples and hints.</p>
-</div>
-<div class="paragraph">
-<p>The SMTP service is controlled by a configuration block in the smptserver.xml.
-The smtpserver tag defines the boundaries of the configuration block. It encloses
-all the relevant configuration for the SMTP server. The behavior of the SMTP service is
-controlled by the attributes and children of this tag.</p>
-</div>
-<div class="paragraph">
-<p>This tag has an optional boolean attribute - <strong>enabled</strong> - that defines whether the service is active or not. The value defaults to "true" if
-not present.</p>
-</div>
-<div class="paragraph">
-<p>The standard children of the smtpserver tag are:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. smtpserver.xml content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">bind</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A list of address:port separed by comma - This is an optional value. If present, this value is a string describing
-the IP address to which this service should be bound. If the tag or value is absent then the service
-will bind to all network interfaces for the machine on port 25. Port 25 is the well-known/IANA registered port for SMTP.
-Port 465 is the well-known/IANA registered port for SMTP over TLS.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connectBacklog</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The IP address (host name) the MBean Server will bind/listen to.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tls</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set to true to support STARTTLS or SSL for the Socket.
-To use this you need to copy sunjce_provider.jar to /path/james/lib directory. To create a new keystore execute:
-<code>keytool -genkey -alias james -keyalg RSA -storetype PKCS12 -keystore /path/to/james/conf/keystore</code>.
-The algorithm is optional and only needs to be specified when using something other
-than the Sun JCE provider - You could use IbmX509 with IBM Java runtime.
-Please note that each SMTP/LMTP server exposed on different port can specify its own keystore, independently from any other
-TLS based protocols.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">helloName</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">This is a required tag with an optional body that defines the server name
-used in the initial service greeting. The tag may have an optional attribute - <strong>autodetect</strong>. If
-the autodetect attribute is present and true, the service will use the local hostname
-returned by the Java libraries. If autodetect is absent or false, the body of the tag will be used. In
-this case, if nobody is present, the value "localhost" will be used.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connectionTimeout</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">This is an optional tag with a non-negative integer body. Connection timeout in seconds.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connectionLimit</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum simultaneous incoming connections for this service.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connectionLimitPerIP</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum simultaneous incoming connections per IP for this service.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">proxyRequired</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Enables proxy support for this service for incoming connections. HAProxy’s protocol
-(<a href="https://www.haproxy.org/download/2.7/doc/proxy-protocol.txt" class="bare">https://www.haproxy.org/download/2.7/doc/proxy-protocol.txt</a>) is used and might be compatible
-with other proxies (e.g. traefik). If enabled, it is <strong>required</strong> to initiate the connection
-using HAProxy’s proxy protocol.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">authRequired</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">(deprecated) use auth.announce instead.</p>
-<p class="tableblock">This is an optional tag with a boolean body. If true, then the server will
-announce authentication after HELO command. If this tag is absent, or the value
-is false then the client will not be prompted for authentication. Only simple user/password authentication is
-supported at this time. Supported values:</p>
-<p class="tableblock"> * true: announced only to not authorizedAddresses</p>
-<p class="tableblock"> * false: don’t announce AUTH. If absent, <strong>authorizedAddresses</strong> are set to a wildcard to accept all remote hosts.</p>
-<p class="tableblock"> * announce: like true, but always announce AUTH capability to clients</p>
-<p class="tableblock">Please note that emails are only relayed if, and only if, the user did authenticate, or is in an authorized network,
-regardless of this option.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">auth.announce</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">This is an optional tag. Possible values are:</p>
-<p class="tableblock">* never: Don’t announce auth.</p>
-<p class="tableblock">* always: always announce AUTH capability to clients.</p>
-<p class="tableblock">* forUnauthorizedAddresses: announced only to not authorizedAddresses</p>
-<p class="tableblock">Please note that emails are only relayed if, and only if, the user did authenticate, or is in an authorized network,
-regardless of this option.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">auth.requireSSL</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">This is an optional tag, defaults to true. If true, authentication is not advertised via capabilities on unencrypted
-channels.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">auth.plainAuthEnabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">This is an optional tag, defaults to true. If false, AUTH PLAIN and AUTH LOGIN will not be exposed. This setting
-can be used to enforce strong authentication mechanisms.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">auth.oidc.oidcConfigurationURL</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Provide OIDC url address for information to user. Only configure this when you want to authenticate SMTP server using a OIDC provider.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">auth.oidc.jwksURL</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Provide url to get OIDC’s JSON Web Key Set to validate user token. Only configure this when you want to authenticate SMTP server using a OIDC provider.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">auth.oidc.claim</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Claim string uses to identify user. E.g: "email_address". Only configure this when you want to authenticate SMTP server using a OIDC provider.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">auth.oidc.scope</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">An OAuth scope that is valid to access the service (RF: RFC7628). Only configure this when you want to authenticate SMTP server using a OIDC provider.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">auth.oidc.introspection.url</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. An OAuth introspection token URL will be called to validate the token (RF: RFC7662).
-Only configure this when you want to validate the revocation token by the OIDC provider.
-Note that James always verifies the signature of the token even whether this configuration is provided or not.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">auth.oidc.introspection.auth</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Provide Authorization in header request when introspecting token.
-Eg: <code>Basic xyz</code></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">auth.oidc.userinfo.url</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. An Userinfo URL will be called to validate the token (RF: OpenId.Core <a href="https://openid.net/specs/openid-connect-core-1_0.html" class="bare">https://openid.net/specs/openid-connect-core-1_0.html</a>).
-Only configure this when you want to validate the revocation token by the OIDC provider.
-Note that James always verifies the signature of the token even whether this configuration is provided or not.
-James will ignore check token by userInfo if the <code>auth.oidc.introspection.url</code> is already configured</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">authorizedAddresses</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Authorize specific addresses/networks.</p>
-<p class="tableblock">If you use SMTP AUTH, addresses that match those specified here will
-be permitted to relay without SMTP AUTH. If you do not use SMTP
-AUTH, and you specify addresses here, then only addresses that match
-those specified will be permitted to relay.</p>
-<p class="tableblock">Addresses may be specified as a IP address or domain name, with an
-optional netmask, e.g.,</p>
-<p class="tableblock">127.*, 127.0.0.0/8, 127.0.0.0/255.0.0.0, and localhost/8 are all the same</p>
-<p class="tableblock">See also the RemoteAddrNotInNetwork matcher in the transport processor.
-You would generally use one OR the other approach.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">verifyIdentity</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">This is an optional tag with a boolean body. This option can only be used
-if SMTP authentication is required. If the parameter is set to true then the sender address for the submitted message
-will be verified against the authenticated subject. Verify sender addresses, ensuring that
-the sender address matches the user who has authenticated.
-It will verify that the sender address matches the address of the user or one of its alias (from user or domain aliases).
-This prevents a user of your mail server from acting as someone else
-If unspecified, default value is true.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">maxmessagesize</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">This is an optional tag with a non-negative integer body. It specifies the maximum
-size, in kbytes, of any message that will be transmitted by this SMTP server. It is a service-wide, as opposed to
-a per user, limit. If the value is zero then there is no limit. If the tag isn’t specified, the service will
-default to an unlimited message size. Must be a positive integer, optionally with a unit: B, K, M, G.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">heloEhloEnforcement</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">This sets whether to enforce the use of HELO/EHLO salutation before a
-MAIL command is accepted. If unspecified, the value defaults to true.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">smtpGreeting</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">This sets the SMTPGreeting which will be used when connect to the smtpserver
-If none is specified a default is generated</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">handlerchain</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The configuration handler chain. See <a href="smtp-hooks.html" class="xref page">this page</a> for configuring out-of the
-box extra SMTP handlers and hooks.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">bossWorkerCount</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum count of boss threads. Boss threads are responsible for accepting incoming SMTP connections
-and initializing associated resources. Optional integer, by default, boss threads are not used and this responsibility is being dealt with
-by IO threads.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ioWorkerCount</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum count of IO threads. IO threads are responsible for receiving incoming SMTP messages and framing them
-(split line by line). IO threads also take care of compression and SSL encryption. Their tasks are short-lived and non-blocking.
-Optional integer, defaults to 2 times the count of CPUs.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">maxExecutorCount</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum count of worker threads. Worker threads takes care of potentially blocking tasks like executing SMTP commands.
-Optional integer, defaults to 16.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">useEpoll</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false - If true uses native EPOLL implementation for Netty otherwise uses NIO. Defaults to false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">gracefulShutdown</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false - If true attempts a graceful shutdown, which is safer but can take time. Defaults to true.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">disabledFeatures</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Extended SMTP features to hide in EHLO responses.</p></td>
-</tr>
-</tbody>
-</table>
-<div class="sect2">
-<h3 id="_oidc_setup"><a class="anchor" href="#_oidc_setup"></a>OIDC setup</h3>
-<div class="paragraph">
-<p>James SMTP support XOAUTH2 authentication mechanism which allow authenticating against a OIDC providers.
-Please configure <code>auth.oidc</code> part to use this.</p>
-</div>
-<div class="paragraph">
-<p>We do supply an <a href="https://github.com/apache/james-project/tree/master/examples/oidc">example</a> of such a setup.
-It uses the Keycloak OIDC provider, but usage of similar technologies is definitely doable.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_about_open_relays"><a class="anchor" href="#_about_open_relays"></a>About open relays</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Authenticated SMTP is a method of securing your SMTP server. With SMTP AUTH enabled senders who wish to
-relay mail through the SMTP server (that is, send mail that is eventually to be delivered to another SMTP
-server) must authenticate themselves to Apache James Server before sending their message. Mail that is to be delivered
-locally does not require authentication. This method ensures that spammers cannot use your SMTP server
-to send unauthorized mail, while still enabling users who may not have fixed IP addresses to send their
-messages.</p>
-</div>
-<div class="paragraph">
-<p>Mail servers that allow spammers to send unauthorized email are known as open relays. So SMTP AUTH
-is a mechanism for ensuring that your server is not an open relay.</p>
-</div>
-<div class="paragraph">
-<p>It is extremely important that your server not be configured as an open relay. Aside from potential
-costs associated with usage by spammers, connections from servers that are determined to be open relays
-are routinely rejected by SMTP servers. This can severely impede the ability of your mail server to
-send mail.</p>
-</div>
-<div class="paragraph">
-<p>At this time Apache James Server only supports simple user name / password authentication.</p>
-</div>
-<div class="paragraph">
-<p>As mentioned above, SMTP AUTH requires that Apache James Server be able to distinguish between mail intended
-for local delivery and mail intended for remote delivery. Apache James Server makes this determination by matching the
-domain to which the mail was sent against the <strong>DomainList</strong> component, configured by
-<a href="domainlist.html" class="xref page"><strong>domainlist.xml</strong></a>.</p>
-</div>
-<div class="paragraph">
-<p>The Distributed Server is configured out of the box so as to not serve as an open relay for spammers. This is done
-by relayed emails originate from a trusted source. This includes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Authenticated SMTP/JMAP users</p>
-</li>
-<li>
-<p>Mails generated by the server (eg: bounces)</p>
-</li>
-<li>
-<p>Mails originating from a trusted network as configured in <strong>smtpserver.xml</strong></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>If you wish to ensure that authenticated users can only send email from their own account, you may
-optionally set the verifyIdentity element of the smtpserver configuration block to "true".</p>
-</div>
-<div class="sect2">
-<h3 id="_verification"><a class="anchor" href="#_verification"></a>Verification</h3>
-<div class="paragraph">
-<p>Verify that you have not inadvertently configured your server as an open relay. This is most easily
-accomplished by using the service provided at <a href="https://mxtoolbox.com/diagnostic.aspx">mxtoolbox.com</a>. mxtoolbox.com will
-check your mail server and inform you if it is an open relay. This tool further more verifies additional properties like:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Your DNS configuration, especially that you mail server IP has a valid reverse DNS entry</p>
-</li>
-<li>
-<p>That your SMTP connection is secured</p>
-</li>
-<li>
-<p>That you are not an OpenRelay</p>
-</li>
-<li>
-<p>This website also allow a quick lookup to ensure your mail server is not in public blacklists.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Of course it is also necessary to confirm that users and log in and send
-mail through your server. This can be accomplished using any standard mail client (i.e. Thunderbird, Outlook,
-Eudora, Evolution).</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_lmtp_configuration"><a class="anchor" href="#_lmtp_configuration"></a>LMTP Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/lmtpserver.xml">example</a>
-to get some examples and hints.</p>
-</div>
-<div class="paragraph">
-<p>The configuration is the same of for SMTP.</p>
-</div>
-<div class="paragraph">
-<p>By default, it is deactivated. You can activate it alongside SMTP and bind for example on port 24.</p>
-</div>
-<div class="paragraph">
-<p>The default LMTP server stores directly emails in user mailboxes, without further treatment.</p>
-</div>
-<div class="paragraph">
-<p>However we do ship an alternative handler chain allowing to execute the mailet container, thus achieving a behaviour similar
-to the default SMTP protocol. Here is how to achieve this:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><lmtpservers>
- <lmtpserver enabled="true">
- <jmxName>lmtpserver</jmxName>
- <bind>0.0.0.0:24</bind>
- <connectionBacklog>200</connectionBacklog>
- <connectiontimeout>1200</connectiontimeout>
- <connectionLimit>0</connectionLimit>
- <connectionLimitPerIP>0</connectionLimitPerIP>
- <maxmessagesize>0</maxmessagesize>
- <handlerchain coreHandlersPackage="org.apache.james.lmtpserver.MailetContainerCmdHandlerLoader">
- <handler class="org.apache.james.lmtpserver.MailetContainerCmdHandlerLoader"/>
- </handlerchain>
- </lmtpserver>
-</lmtpservers></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note that by default the mailet container is executed with all recipients at once and do not allow per recipient
-error reporting. An option <code>splitExecution</code> allow to execute the mailet container for each recipient separately and mitigate this
-limitation at the cost of performance.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><lmtpservers>
- <lmtpserver enabled="true">
- <jmxName>lmtpserver</jmxName>
- <bind>0.0.0.0:24</bind>
- <connectionBacklog>200</connectionBacklog>
- <connectiontimeout>1200</connectiontimeout>
- <connectionLimit>0</connectionLimit>
- <connectionLimitPerIP>0</connectionLimitPerIP>
- <maxmessagesize>0</maxmessagesize>
- <handlerchain coreHandlersPackage="org.apache.james.lmtpserver.MailetContainerCmdHandlerLoader">
- <handler class="org.apache.james.lmtpserver.MailetContainerCmdHandlerLoader"/>
- <handler class="org.apache.james.lmtpserver.MailetContainerHandler">
- <splitExecution>true</splitExecution>
- </handler>
- </handlerchain>
- </lmtpserver>
-</lmtpservers></pre>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/configure/spam.html b/james-distributed-app/3.8.1/configure/spam.html
deleted file mode 100644
index e9d5d23..0000000
--- a/james-distributed-app/3.8.1/configure/spam.html
+++ /dev/null
@@ -1,677 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Anti-Spam configuration :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Extensions</li>
- <li><a href="spam.html">Anti-Spam setup</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/spam.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Anti-Spam configuration</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>Anti-Spam system can be configured via two main different mechanisms:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>SMTP Hooks;</p>
-</li>
-<li>
-<p>Mailets;</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_antispam_smtp_hooks"><a class="anchor" href="#_antispam_smtp_hooks"></a>AntiSpam SMTP Hooks</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>"FastFail" SMTP Hooks acts to reject before spooling
-on the SMTP level. The Spam detector hook can be used as a fastfail hook, therefore
-Spam filtering system must run as a server on the same machine as the Apache James Server.</p>
-</div>
-<div class="paragraph">
-<p>SMTP Hooks for non-existent users, DSN filter, domains with invalid MX record,
-can also be configured.</p>
-</div>
-<div class="paragraph">
-<p><strong>SpamAssassinHandler</strong> (experimental) also enables to classify the messages as spam or not
-with a configurable score threshold (<code>0.0</code>, non-configurable). Only a global database is supported. Per user spam
-detection is not supported by this hook.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_antispam_mailets"><a class="anchor" href="#_antispam_mailets"></a>AntiSpam Mailets</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>James' repository provide two AntiSpam mailets: SpamAssassin and RspamdScanner.
-We can select one in them for filtering spam mail.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>SpamAssassin and RspamdScanner</strong> Mailet is designed to classify the messages as spam or not
-with a configurable score threshold. Usually a message will only be
-considered as spam if it matches multiple criteria; matching just a single test
-will not usually be enough to reach the threshold. Note that this mailet is executed on a per-user basis.</p>
-</li>
-</ul>
-</div>
-<div class="sect2">
-<h3 id="_rspamd"><a class="anchor" href="#_rspamd"></a>Rspamd</h3>
-<div class="paragraph">
-<p>The Rspamd extension (optional) requires an extra configuration file <code>rspamd.properties</code> to configure RSpamd connection</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. rspamd.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">rSpamdUrl</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">URL defining the Rspamd’s server. Eg: <a href="http://rspamd:11334" class="bare">http://rspamd:11334</a></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">rSpamdPassword</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Password for pass authentication when request to Rspamd’s server. Eg: admin</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">rspamdTimeout</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Integer. Timeout for http requests to Rspamd. Default to 15 seconds.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">perUserBayes</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Boolean. Whether to scan/learn mails using per-user Bayes. Default to false.</p></td>
-</tr>
-</tbody>
-</table>
-<div class="paragraph">
-<p><code>RspamdScanner</code> supports the following options:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>You can specify the <code>virusProcessor</code> if you want to enable virus scanning for mail. Upon configurable <code>virusProcessor</code>
-you can specify how James process mail virus. We provide a sample Rspamd mailet and <code>virusProcessor</code> configuration:</p>
-</li>
-<li>
-<p>You can specify the <code>rejectSpamProcessor</code>. Emails marked as <code>rejected</code> by Rspamd will be redirected to this
-processor. This corresponds to emails with the highest spam score, thus delivering them to users as marked as spam
-might not even be desirable.</p>
-</li>
-<li>
-<p>The <code>rewriteSubject</code> option allows to rewritte subjects when asked by Rspamd.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This mailet can scan mails against per-user Bayes by configure <code>perUserBayes</code> in <code>rspamd.properties</code>. This is achieved
-through the use of Rspamd <code>Deliver-To</code> HTTP header. If true, Rspamd will be called for each recipient of the mail, which comes at a performance cost. If true, subjects are not rewritten.
-If true <code>virusProcessor</code> and <code>rejectSpamProcessor</code> are honnered per user, at the cost of email copies. Default to false.</p>
-</div>
-<div class="paragraph">
-<p>Here is an example of mailet pipeline conducting out RspamdScanner execution:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><processor state="local-delivery" enableJmx="true">
- <mailet match="All" class="org.apache.james.rspamd.RspamdScanner">
- <rewriteSubject>true</rewriteSubject>
- <virusProcessor>virus</virusProcessor>
- <rejectSpamProcessor>spam</rejectSpamProcessor>
- </mailet>
- <mailet match="IsMarkedAsSpam=org.apache.james.rspamd.status" class="WithStorageDirective">
- <targetFolderName>Spam</targetFolderName>
- </mailet>
- <mailet match="All" class="LocalDelivery"/>
-</processor>
-<!--Choose one between these two following virus processor, or configure a custom one if you want-->
-<!--Hard reject virus mail-->
-<processor state="virus" enableJmx="false">
- <mailet match="All" class="ToRepository">
- <repositoryPath>file://var/mail/virus/</repositoryPath>
- </mailet>
-</processor>
-<!--Soft reject virus mail-->
-<processor state="virus" enableJmx="false">
- <mailet match="All" class="StripAttachment">
- <remove>all</remove>
- <pattern>.*</pattern>
- </mailet>
- <mailet match="All" class="AddSubjectPrefix">
- <subjectPrefix>[VIRUS]</subjectPrefix>
- </mailet>
- <mailet match="All" class="LocalDelivery"/>
-</processor>
-<!--Store rejected spam emails (with a very high score) -->
-<processor state="virus" enableJmx="false">
- <mailet match="All" class="ToRepository">
- <repositoryPath>cassandra://var/mail/spam</repositoryPath>
- </mailet>
-</processor></pre>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_feedback_for_rspamd"><a class="anchor" href="#_feedback_for_rspamd"></a>Feedback for Rspamd</h4>
-<div class="paragraph">
-<p>If enabled, the <code>RspamdListener</code> will base on the Mailbox event to detect the message is a spam or not, then James will send report <code>spam</code> or <code>ham</code> to Rspamd.
-This listener can report mails to per-user Bayes by configure <code>perUserBayes</code> in <code>rspamd.properties</code>.
-The Rspamd listener needs to explicitly be registered with <a href="listeners.html" class="xref page">listeners.xml</a>.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><listeners>
- <listener>
- <class>org.apache.james.rspamd.RspamdListener</class>
- </listener>
-</listeners></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>For more detail about how to use Rspamd’s extension: <code>third-party/rspamd/index.md</code></p>
-</div>
-<div class="paragraph">
-<p>Alternatively, batch reports can be triggered on user mailbox content via webAdmin. <a href="https://github.com/apache/james-project/tree/master/third-party/rspamd#additional-webadmin-endpoints">Read more</a>.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_spamassassin"><a class="anchor" href="#_spamassassin"></a>SpamAssassin</h3>
-<div class="paragraph">
-<p>Here is an example of mailet pipeline conducting out SpamAssassin execution:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="SpamAssassin">
- <onMailetException>ignore</onMailetException>
- <spamdHost>spamassassin</spamdHost>
- <spamdPort>783</spamdPort>
-</mailet>
-<mailet match="All" class="MailAttributesToMimeHeaders">
- <!-- This mailet is not required, but useful to have SpamAssassin score in headers-->
- <simplemapping>org.apache.james.spamassassin.status; X-JAMES-SPAMASSASSIN-STATUS</simplemapping>
- <simplemapping>org.apache.james.spamassassin.flag; X-JAMES-SPAMASSASSIN-FLAG</simplemapping>
-</mailet>
-<mailet match="IsMarkedAsSpam" class="WithStorageDirective">
- <targetFolderName>Spam</targetFolderName>
-</mailet></pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>BayesianAnalysis</strong> (unsupported) in the Mailet uses Bayesian probability to classify mail as
-spam or not spam. It relies on the training data coming from the users’ judgment.
-Users need to manually judge as spam and send to <a href="mailto:spam@thisdomain.com">spam@thisdomain.com</a>, oppositely,
-if not spam they then send to <a href="mailto:not.spam@thisdomain.com">not.spam@thisdomain.com</a>. BayesianAnalysisfeeder learns
-from this training dataset, and build predictive models based on Bayesian probability.
-There will be a certain table for maintaining the frequency of Corpus for keywords
-in the database. Every 10 mins a thread in the BayesianAnalysis will check and update
-the table. Also, the correct approach is to send the original spam or non-spam
-as an attachment to another message sent to the feeder in order to avoid bias from the
-current sender’s email header.</p>
-</li>
-</ul>
-</div>
-<div class="sect3">
-<h4 id="_feedback_for_spamassassin"><a class="anchor" href="#_feedback_for_spamassassin"></a>Feedback for SpamAssassin</h4>
-<div class="paragraph">
-<p>If enabled, the <code>SpamAssassinListener</code> will asynchronously report users mails moved to the <code>Spam</code> mailbox as Spam,
-and other mails as <code>Ham</code>, effectively populating the user database for per user spam detection. This enables a per-user
-Spam categorization to be conducted out by the SpamAssassin mailet, the SpamAssassin hook being unaffected.</p>
-</div>
-<div class="paragraph">
-<p>The SpamAssassin listener requires an extra configuration file <code>spamassassin.properties</code> to configure SpamAssassin connection (optional):</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 2. spamassassin.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">spamassassin.host</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Hostname of the SpamAssassin server. Defaults to 127.0.0.1.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">spamassassin.port</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Port of the SpamAssassin server. Defaults to 783.</p></td>
-</tr>
-</tbody>
-</table>
-<div class="paragraph">
-<p>Note that this configuration file only affects the listener, and not the hook or mailet.</p>
-</div>
-<div class="paragraph">
-<p>The SpamAssassin listener needs to explicitly be registered with <a href="listeners.html" class="xref page">listeners.xml</a>.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><listeners>
- <listener>
- <class>org.apache.james.mailbox.spamassassin.SpamAssassinListener</class>
- <async>true</async>
- </listener>
-</listeners></pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/configure/ssl.html b/james-distributed-app/3.8.1/configure/ssl.html
deleted file mode 100644
index d898d11..0000000
--- a/james-distributed-app/3.8.1/configure/ssl.html
+++ /dev/null
@@ -1,742 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — SSL & TLS configuration :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Protocols</li>
- <li><a href="ssl.html">SSL & TLS</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/ssl.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — SSL & TLS configuration</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This document explains how to enable James 3.0 servers to use Transport Layer Security (TLS)
-for encrypted client-server communication.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_configure_a_server_to_use_ssltls"><a class="anchor" href="#_configure_a_server_to_use_ssltls"></a>Configure a Server to Use SSL/TLS</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Each of the servers <a href="smtp.html" class="xref page">SMTP - LMTP</a>,
-<a href="pop3.html" class="xref page">POP3</a> and <a href="imap.html" class="xref page">IMAP</a>
-supports use of SSL/TLS.</p>
-</div>
-<div class="paragraph">
-<p>TLS (Transport Layer Security) and SSL (Secure Sockets Layer) are protocols that provide
-data encryption and authentication between applications in scenarios where that data is
-being sent across an insecure network, such as checking your email
-(How does the Secure Socket Layer work?). The terms SSL and TLS are often used
-interchangeably or in conjunction with each other (TLS/SSL),
-but one is in fact the predecessor of the other — SSL 3.0 served as the basis
-for TLS 1.0 which, as a result, is sometimes referred to as SSL 3.1.</p>
-</div>
-<div class="paragraph">
-<p>You need to add a block in the corresponding configuration file (smtpserver.xml, pop3server.xml, imapserver.xml,..)</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><tls socketTLS="false" startTLS="true">
- <keystore>file://conf/keystore</keystore>
- <keystoreType>PKCS12</keystoreType>
- <secret>yoursecret</secret>
- <provider>org.bouncycastle.jce.provider.BouncyCastleProvider</provider>
-</tls></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Alternatively TLS keys can be supplied via PEM files:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><tls socketTLS="true" startTLS="false">
- <privateKey>file://conf/private.key</privateKey>
- <certificates>file://conf/certs.self-signed.csr</certificates>
-</tls></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>An optional secret might be specified for the private key:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><tls socketTLS="true" startTLS="false">
- <privateKey>file://conf/private.key</privateKey>
- <certificates>file://conf/certs.self-signed.csr</certificates>
- <secret>yoursecret</secret>
-</tls></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Optionally, TLS protocols and/or cipher suites can be specified explicitly (smtpserver.xml, pop3server.xml, imapserver.xml,..).
-Otherwise, the default protocols and cipher suites of the used JDK will be used:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><tls socketTLS="true" startTLS="false">
- <supportedProtocols>
- <protocol>TLSv1.2</protocol>
- <protocol>TLSv1.1</protocol>
- <protocol>TLSv1</protocol>
- <protocol>SSLv3</protocol>
- </supportedProtocols>
- <supportedCipherSuites>
- <cipherSuite>TLS_AES_256_GCM_SHA384</cipherSuite>
- <cipherSuite>TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256</cipherSuite>
- </supportedCipherSuites>
-</tls></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Each of these block has an optional boolean configuration element <b>socketTLS</b> and <b>startTLS</b> which is used to toggle
-use of SSL or TLS for the service.</p>
-</div>
-<div class="paragraph">
-<p>With socketTLS (SSL/TLS in Thunderbird), all the communication is encrypted.</p>
-</div>
-<div class="paragraph">
-<p>With startTLS (STARTTLS in Thunderbird), the preamble is readable, but the rest is encrypted.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>* OK JAMES IMAP4rev1 Server Server 192.168.1.4 is ready.
-* CAPABILITY IMAP4rev1 LITERAL+ CHILDREN WITHIN STARTTLS IDLE NAMESPACE UIDPLUS UNSELECT AUTH=PLAIN
-1 OK CAPABILITY completed.
-2 OK STARTTLS Begin TLS negotiation now.
-... rest is encrypted...</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can only enable one of the both at the same time for a service.</p>
-</div>
-<div class="paragraph">
-<p>It is also recommended to change the port number on which the service will listen:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>POP3 - port 110, Secure POP3 - port 995</p>
-</li>
-<li>
-<p>IMAP - port 143, Secure IMAP4 - port 993</p>
-</li>
-<li>
-<p>SMTP - port 25, Secure SMTP - port 465</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>You will now need to create your certificate store and place it in the james/conf/ folder with the name you defined in the keystore tag.</p>
-</div>
-<div class="paragraph">
-<p>Please note <code>JKS</code> keystore format is also supported (default value if no keystore type is specified):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><tls socketTLS="false" startTLS="true">
- <keystore>file://conf/keystore</keystore>
- <keystoreType>JKS</keystoreType>
- <secret>yoursecret</secret>
- <provider>org.bouncycastle.jce.provider.BouncyCastleProvider</provider>
-</tls></pre>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_client_authentication_via_certificates"><a class="anchor" href="#_client_authentication_via_certificates"></a>Client authentication via certificates</h3>
-<div class="paragraph">
-<p>When you enable TLS, you may also configure the server to require a client certificate for authentication:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><tls socketTLS="false" startTLS="true">
- <keystore>file://conf/keystore</keystore>
- <keystoreType>JKS</keystoreType>
- <secret>yoursecret</secret>
-
- <clientAuth>
- <truststore>file://conf/truststore</truststore>
- <truststoreType>JKS</truststoreType>
- <truststoreSecret>yoursecret</truststoreSecret>
- <enableOCSPCRLChecks>false</enableOCSPCRLChecks>
- </clientAuth>
-</tls></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>James verifies client certificates against the provided truststore. You can fill it with trusted peer certificates directly, or an issuer certificate (CA) if you trust all certificates created by it. If you omit the truststore configuration, James will use the Java default truststore instead, effectively trusting any known CA.</p>
-</div>
-<div class="paragraph">
-<p>James can optionally enable OCSP verifications for client certificates against Certificate Revocation List referenced
-in the certificate itself.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_creating_your_own_pem_keys"><a class="anchor" href="#_creating_your_own_pem_keys"></a>Creating your own PEM keys</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The following commands can be used to create self signed PEM keys:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre># Generating your private key
-openssl genrsa -des3 -out private.key 2048
-
-# Creating your certificates
-openssl req -new -key private.key -out certs.csr
-
-# Signing the certificate yourself
-openssl x509 -req -days 365 -in certs.csr -signkey private.key -out certs.self-signed.csr
-
-# Removing the password from the private key
-# Not necessary if you supply the secret in the configuration
-openssl rsa -in private.key -out private.nopass.key</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You may then supply this TLS configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><tls socketTLS="true" startTLS="false">
- <privateKey>file://conf/private.nopass.key</privateKey>
- <certificates>file://conf/certs.self-signed.csr</certificates>
-</tls></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_certificate_keystores"><a class="anchor" href="#_certificate_keystores"></a>Certificate Keystores</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This section gives more indication for users relying on keystores.</p>
-</div>
-<div class="sect2">
-<h3 id="_creating_your_own_certificate_keystore"><a class="anchor" href="#_creating_your_own_certificate_keystore"></a>Creating your own Certificate Keystore</h3>
-<div class="paragraph">
-<p>(Adapted from the Tomcat 4.1 documentation)</p>
-</div>
-<div class="paragraph">
-<p>James currently operates only on JKS or PKCS12 format keystores. This is Java’s standard "Java KeyStore" format, and is
-the format created by the keytool command-line utility. This tool is included in the JDK.</p>
-</div>
-<div class="paragraph">
-<p>To import an existing certificate into a JKS keystore, please read the documentation (in your JDK documentation package)
-about keytool.</p>
-</div>
-<div class="paragraph">
-<p>To create a new keystore from scratch, containing a single self-signed Certificate, execute the following from a terminal
-command line:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>keytool -genkey -alias james -keyalg RSA -storetype PKCS12 -keystore your_keystore_filename</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>(The RSA algorithm should be preferred as a secure algorithm, and this also ensures general compatibility with other
-servers and components.)</p>
-</div>
-<div class="paragraph">
-<p>As a suggested standard, create the keystore in the james/conf directory, with a name like james.keystore.</p>
-</div>
-<div class="paragraph">
-<p>After executing this command, you will first be prompted for the keystore password.</p>
-</div>
-<div class="paragraph">
-<p>Next, you will be prompted for general information about this Certificate, such as company, contact name, and so on.
-This information may be displayed to users when importing into the certificate store of the client, so make sure that
-the information provided here matches what they will expect.</p>
-</div>
-<div class="paragraph">
-<p>Important: in the "distinguished name", set the "common name" (CN) to the DNS name of your James server, the one
-you will use to access it from your mail client (like "mail.xyz.com").</p>
-</div>
-<div class="paragraph">
-<p>Finally, you will be prompted for the key password, which is the password specifically for this Certificate
-(as opposed to any other Certificates stored in the same keystore file).</p>
-</div>
-<div class="paragraph">
-<p>If everything was successful, you now have a keystore file with a Certificate that can be used by your server.</p>
-</div>
-<div class="paragraph">
-<p>You MUST have only one certificate in the keystore file used by James.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_installing_a_certificate_provided_by_a_certificate_authority"><a class="anchor" href="#_installing_a_certificate_provided_by_a_certificate_authority"></a>Installing a Certificate provided by a Certificate Authority</h3>
-<div class="paragraph">
-<p>(Adapted from the Tomcat 4.1 documentation</p>
-</div>
-<div class="paragraph">
-<p>To obtain and install a Certificate from a Certificate Authority (like verisign.com, thawte.com or trustcenter.de)
-you should have read the previous section and then follow these instructions:</p>
-</div>
-<div class="sect3">
-<h4 id="_create_a_local_certificate_signing_request_csr"><a class="anchor" href="#_create_a_local_certificate_signing_request_csr"></a>Create a local Certificate Signing Request (CSR)</h4>
-<div class="paragraph">
-<p>In order to obtain a Certificate from the Certificate Authority of your choice you have to create a so called
-Certificate Signing Request (CSR). That CSR will be used by the Certificate Authority to create a Certificate
-that will identify your James server as "secure". To create a CSR follow these steps:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Create a local Certificate as described in the previous section.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The CSR is then created with:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> keytool -certreq -keyalg RSA -alias james -file certreq.csr -keystore your_keystore_filename</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Now you have a file called certreq.csr. The file is encoded in PEM format. You can submit it to the Certificate Authority
-(look at the documentation of the Certificate Authority website on how to do this). In return you get a Certificate.</p>
-</div>
-<div class="paragraph">
-<p>Now that you have your Certificate you can import it into you local keystore. First of all you may have to import a so
-called Chain Certificate or Root Certificate into your keystore (the major Certificate Authorities are already in place,
-so it’s unlikely that you will need to perform this step). After that you can procede with importing your Certificate.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_optionally_importing_a_so_called_chain_certificate_or_root_certificate"><a class="anchor" href="#_optionally_importing_a_so_called_chain_certificate_or_root_certificate"></a>Optionally Importing a so called Chain Certificate or Root Certificate</h4>
-<div class="paragraph">
-<p>Download a Chain Certificate from the Certificate Authority you obtained the Certificate from.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>For Verisign.com go to: <a href="http://www.verisign.com/support/install/intermediate.html" class="bare">http://www.verisign.com/support/install/intermediate.html</a></p>
-</li>
-<li>
-<p>For Trustcenter.de go to: <a href="http://www.trustcenter.de/certservices/cacerts/en/en.htm#server" class="bare">http://www.trustcenter.de/certservices/cacerts/en/en.htm#server</a></p>
-</li>
-<li>
-<p>For Thawte.com go to: <a href="http://www.thawte.com/certs/trustmap.html" class="bare">http://www.thawte.com/certs/trustmap.html</a> (seems no longer valid)</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_import_the_chain_certificate_into_you_keystore"><a class="anchor" href="#_import_the_chain_certificate_into_you_keystore"></a>Import the Chain Certificate into you keystore</h4>
-<div class="literalblock">
-<div class="content">
-<pre>keytool -import -alias root -keystore your_keystore_filename -trustcacerts -file filename_of_the_chain_certificate</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>And finally import your new Certificate (It must be in X509 format):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>keytool -import -alias james -keystore your_keystore_filename -trustcacerts -file your_certificate_filename</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>See also <a href="http://www.agentbob.info/agentbob/79.html">this page</a></p>
-</div>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/configure/tika.html b/james-distributed-app/3.8.1/configure/tika.html
deleted file mode 100644
index e78dda5..0000000
--- a/james-distributed-app/3.8.1/configure/tika.html
+++ /dev/null
@@ -1,472 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — tika.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Storage dependencies</li>
- <li><a href="tika.html">tika.properties</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/tika.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — tika.properties</h1>
-<div class="paragraph">
-<p>When using OpenSearch, you can configure an external Tika server for extracting and indexing text from attachments.
-Thus you can significantly improve user experience upon text searches.</p>
-</div>
-<div class="paragraph">
-<p>Note: You can launch a tika server using this command line:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>docker run --name tika linagora/docker-tikaserver:1.24</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Here are the different properties:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. tika.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tika.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Should Tika text extractor be used?
-If true, the TikaTextExtractor will be used behind a cache.
-If false, the DefaultTextExtractor will be used (naive implementation only supporting text).
-Defaults to false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tika.host</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">IP or domain name of your Tika server. The default value is 127.0.0.1</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tika.port</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Port of your tika server. The default value is 9998</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tika.timeoutInMillis</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Timeout when issuing request to the tika server. The default value is 3 seconds.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tika.cache.eviction.period</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A cache is used to avoid, when possible, query Tika multiple time for the same attachments.
-This entry determines how long after the last read an entry vanishes.
-Please note that units are supported (ms - millisecond, s - second, m - minute, h - hour, d - day). Default unit is seconds.
-Default value is <strong>1 day</strong></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tika.cache.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Should the cache be used? False by default</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tika.cache.weight.max</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Maximum weight of the cache.
-A value of <strong>0</strong> disables the cache
-Please note that units are supported (K for KB, M for MB, G for GB). Defaults is no units, so in bytes.
-Default value is <strong>100 MB</strong>.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tika.contentType.blacklist</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Blacklist of content type is known-to-be-failing with Tika. Specify the list with comma separator.</p></td>
-</tr>
-</tbody>
-</table>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/configure/usersrepository.html b/james-distributed-app/3.8.1/configure/usersrepository.html
deleted file mode 100644
index d4fd81a..0000000
--- a/james-distributed-app/3.8.1/configure/usersrepository.html
+++ /dev/null
@@ -1,588 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — usersrepository.xml :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Core components</li>
- <li><a href="usersrepository.html">usersrepository.xml</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/usersrepository.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — usersrepository.xml</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>User repositories are required to store James user information and authentication data.</p>
-</div>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/usersrepository.xml">example</a>
-to get some examples and hints.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_the_user_data_model"><a class="anchor" href="#_the_user_data_model"></a>The user data model</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>A user has two attributes: username and password.</p>
-</div>
-<div class="paragraph">
-<p>A valid user should satisfy these criteria:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>username and password cannot be null or empty</p>
-</li>
-<li>
-<p>username should not be longer than 255 characters</p>
-</li>
-<li>
-<p>username can not contain '/'</p>
-</li>
-<li>
-<p>username can not contain multiple domain delimiter('@')</p>
-</li>
-<li>
-<p>A username can have only a local part when virtualHosting is disabled. E.g.'myUser'</p>
-</li>
-<li>
-<p>When virtualHosting is enabled, a username should have a domain part, and the domain part should be concatenated
-after a domain delimiter('@'). E.g. '<a href="mailto:myuser@james.org">myuser@james.org</a>'</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>A user is always considered as lower cased, so 'myUser' and 'myuser' are the same user, and can be used as well as
-recipient local part than as login for different protocols.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_configuration"><a class="anchor" href="#_configuration"></a>Configuration</h2>
-<div class="sectionbody">
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. usersrepository.xml content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">enableVirtualHosting</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false. Add domain support for users (default: false, except for Cassandra Users Repository)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">administratorId</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">user’s name. Allow a user to access to the <a href="https://tools.ietf.org/html/rfc4616#section-2">impersonation command</a>,
-acting on the behalf of any user.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">verifyFailureDelay</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Delay after a failed authentication attempt with an invalid user name or password. Duration string defaulting to seconds, e.g. <code>2</code>, <code>2s</code>, <code>2000ms</code>. Default <code>0s</code> (disabled).</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">algorithm</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">use a specific hash algorithm to compute passwords, with optional mode <code>plain</code> (default) or <code>salted</code>; e.g. <code>SHA-512</code>, <code>SHA-512/plain</code>, <code>SHA-512/salted</code>, <code>PBKDF2</code>, <code>PBKDF2-SHA512</code> (default).
-Note: When using <code>PBKDF2</code> or <code>PBKDF2-SHA512</code> one can specify the iteration count and the key size in bytes. You can specify it as part of the algorithm. EG: <code>PBKDF2-SHA512-2000-512</code> will use
-2000 iterations with a key size of 512 bytes.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">hashingMode</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">specify the hashing mode to use if there is none recorded in the database: <code>plain</code> (default) for newer installations or <code>legacy</code> for older ones</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_configuring_a_ldap"><a class="anchor" href="#_configuring_a_ldap"></a>Configuring a LDAP</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Alternatively you can authenticate your users against a LDAP server. You need to configure
-the properties for accessing your LDAP server in this file.</p>
-</div>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/usersrepository.xml">example</a>
-to get some examples and hints.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><usersrepository name="LocalUsers" class="org.apache.james.user.ldap.ReadOnlyUsersLDAPRepository" ldapHost="ldap://myldapserver:389"
- principal="uid=ldapUser,ou=system" credentials="password" userBase="ou=People,o=myorg.com,ou=system" userIdAttribute="uid">
- <enableVirtualHosting>true</enableVirtualHosting>
-</usersrepository></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>SSL can be enabled by using <code>ldaps</code> scheme. <code>trustAllCerts</code> option can be used to trust all LDAP client certificates
-(optional, defaults to false).</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><usersrepository name="LocalUsers" class="org.apache.james.user.ldap.ReadOnlyUsersLDAPRepository" ldapHost="ldaps://myldapserver:636"
- principal="uid=ldapUser,ou=system" credentials="password" userBase="ou=People,o=myorg.com,ou=system" userIdAttribute="uid"
- trustAllCerts="true">
- <enableVirtualHosting>true</enableVirtualHosting>
-</usersrepository></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Moreover, per domain base DN can be configured:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><usersrepository name="LocalUsers" class="org.apache.james.user.ldap.ReadOnlyUsersLDAPRepository" ldapHost="ldap://myldapserver:389"
- principal="uid=ldapUser,ou=system" credentials="password" userBase="ou=People,o=myorg.com,ou=system" userIdAttribute="uid"
- <enableVirtualHosting>true</enableVirtualHosting>
- <domains>
- <domain.tld>ou=People,o=other.com,ou=system</domain.tld>
- </domains>
-</usersrepository></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can connect to multiple LDAP servers for better availability by using <code>ldapHosts</code> option (fallback to <code>ldapHost</code> is supported) to specify the list of LDAP Server URL with the comma <code>,</code> delimiter. We do support different schemas for LDAP servers.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><usersrepository name="LocalUsers" class="org.apache.james.user.ldap.ReadOnlyUsersLDAPRepository" ldapHosts="ldap://ldapServer1:389,ldaps://ldapServer2:636"
- principal="uid=ldapUser,ou=system" credentials="password" userBase="ou=People,o=myorg.com,ou=system" userIdAttribute="uid" trustAllCerts="true">
- <enableVirtualHosting>true</enableVirtualHosting>
-</usersrepository></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>When VirtualHosting is on, you can enable local part as login username by configure the <code>resolveLocalPartAttribute</code>.
-This is the LDAP attribute that allows to retrieve the local part of users. Optional, default to empty, which disables login with local part as username.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><usersrepository name="LocalUsers" class="org.apache.james.user.ldap.ReadOnlyUsersLDAPRepository" ldapHosts="ldap://ldapServer1:389,ldaps://ldapServer2:636"
- principal="uid=ldapUser,ou=system" credentials="password" userBase="ou=People,o=myorg.com,ou=system" resolveLocalPartAttribute="uid" userIdAttribute="mail" trustAllCerts="true">
- <enableVirtualHosting>true</enableVirtualHosting>
-</usersrepository></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The "userListBase" configuration option is used to differentiate users that can login from those that are listed
- as regular users. This is useful for dis-activating users, for instance.</p>
-</div>
-<div class="paragraph">
-<p>A different values from "userBase" can be used for setting up virtual logins,
-for instance in conjunction with "resolveLocalPartAttribute". This can also be used to manage
-disactivated users (in "userListBase" but not in "userBase").</p>
-</div>
-<div class="paragraph">
-<p>Note that "userListBase" can not be specified on a per-domain-basis.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/configure/vault.html b/james-distributed-app/3.8.1/configure/vault.html
deleted file mode 100644
index 580c782..0000000
--- a/james-distributed-app/3.8.1/configure/vault.html
+++ /dev/null
@@ -1,457 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — deletedMessageVault.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Extensions</li>
- <li><a href="vault.html">deletedMessageVault.properties</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/vault.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — deletedMessageVault.properties</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>Deleted Messages Vault is the component in charge of retaining messages before they are going to be deleted.
-Messages stored in the Deleted Messages Vault could be deleted after exceeding their retentionPeriod (explained below).
-It also supports to restore or export messages matching with defined criteria in
-<a href="../operate/webadmin.html#_deleted_messages_vault" class="xref page">WebAdmin deleted messages vault document</a> by using
-<a href="../operate/webadmin.html#_deleted_messages_vault" class="xref page">WebAdmin endpoints</a>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_deleted_messages_vault_configuration"><a class="anchor" href="#_deleted_messages_vault_configuration"></a>Deleted Messages Vault Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Once the vault is active, James will start moving deleted messages to it asynchronously.</p>
-</div>
-<div class="paragraph">
-<p>The Deleted Messages Vault also stores and manages deleted messages into a BlobStore. The BlobStore can be either
-based on an object storage or on Cassandra. For configuring the BlobStore the vault will use, you can look at
-<a href="blobstore.html" class="xref page"><strong>blobstore.properties</strong></a> BlobStore Configuration section.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_deletedmessagevault_properties"><a class="anchor" href="#_deletedmessagevault_properties"></a>deletedMessageVault.properties</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/deletedMessageVault.properties">example</a>
-to get some examples and hints.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. deletedMessageVault.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">retentionPeriod</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Deleted messages stored in the Deleted Messages Vault are expired after this period (default: 1 year). It can be expressed in <strong>y</strong> years, <strong>d</strong> days, <strong>h</strong> hours, …​</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">restoreLocation</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Messages restored from the Deleted Messages Vault are placed in a mailbox with this name (default: <code>Restored-Messages</code>). The mailbox will be created if it does not exist yet.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/configure/webadmin.html b/james-distributed-app/3.8.1/configure/webadmin.html
deleted file mode 100644
index 89997c0..0000000
--- a/james-distributed-app/3.8.1/configure/webadmin.html
+++ /dev/null
@@ -1,556 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — webadmin.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Protocols</li>
- <li><a href="webadmin.html">webadmin.properties</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/webadmin.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — webadmin.properties</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>The web administration supports for now the CRUD operations on the domains, the users, their mailboxes and their quotas,
-managing mail repositories, performing cassandra migrations, and much more, as described in the following sections.</p>
-</div>
-<div class="paragraph">
-<p><strong>WARNING</strong>: This API allows authentication only via the use of JWT. If not
-configured with JWT, an administrator should ensure an attacker can not
-use this API.</p>
-</div>
-<div class="paragraph">
-<p>By the way, some endpoints are not filtered by authentication. Those endpoints are not related to data stored in James,
-for example: Swagger documentation & James health checks.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_configuration"><a class="anchor" href="#_configuration"></a>Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/webadmin.properties">example</a>
-to get some examples and hints.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. webadmin.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Define if WebAdmin is launched (default: false)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">port</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Define WebAdmin’s port (default: 8080)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">host</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Define WebAdmin’s host (default: localhost, use 0.0.0.0 to listen on all addresses)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cors.enable</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Allow the Cross-origin resource sharing (default: false)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cors.origin</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Specify ths CORS origin (default: null)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jwt.enable</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Allow JSON Web Token as an authentication mechanism (default: false)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">https.enable</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Use https (default: false)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">https.keystore</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Specify a keystore file for https (default: null)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">https.password</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Specify the keystore password (default: null)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">https.trust.keystore</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Specify a truststore file for https (default: null)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">https.trust.password</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Specify the truststore password (default: null)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jwt.publickeypem.url</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. JWT tokens allow request to bypass authentication. Path to the JWT public key.
-Defaults to the <code>jwt.publickeypem.url</code> value of <code>jmap.properties</code> file if unspecified
-(legacy behaviour)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">extensions.routes</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">List of Routes specified as fully qualified class name that should be loaded in addition to your product routes list. Routes
-needs to be on the classpath or in the ./extensions-jars folder. Read mode about
-<a href="../extending/webadmin-routes.html" class="xref page">creating you own webadmin routes</a>.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">maxThreadCount</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Maximum threads used by the underlying Jetty server. Optional.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">minThreadCount</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Minimum threads used by the underlying Jetty server. Optional.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_generating_a_jwt_key_pair"><a class="anchor" href="#_generating_a_jwt_key_pair"></a>Generating a JWT key pair</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The Distributed server enforces the use of RSA-SHA-256.</p>
-</div>
-<div class="paragraph">
-<p>One can use OpenSSL to generate a JWT key pair :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre># private key
-openssl genrsa -out rs256-4096-private.rsa 4096
-# public key
-openssl rsa -in rs256-4096-private.rsa -pubout > rs256-4096-public.pem</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The private key can be used to generate JWT tokens, for instance
-using <a href="https://github.com/vandium-io/jwtgen">jwtgen</a>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>jwtgen -a RS256 -p rs256-4096-private.rsa 4096 -c "sub=bob@domain.tld" -c "admin=true" -e 3600 -V</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>This token can then be passed as <code>Bearer</code> of the <code>Authorization</code> header :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -H "Authorization: Bearer $token" -XGET http://127.0.0.1:8000/domains</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The public key can be referenced as <code>jwt.publickeypem.url</code> of the <code>jmap.properties</code> configuration file.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_reverse_proxy_set_up"><a class="anchor" href="#_reverse_proxy_set_up"></a>Reverse-proxy set up</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>WebAdmin adds the value of <code>X-Real-IP</code> header as part of the logging MDC.</p>
-</div>
-<div class="paragraph">
-<p>This allows for reverse proxies to cary other the IP address of the client down to the JMAP server for diagnostic purpose.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/extending/imap.html b/james-distributed-app/3.8.1/extending/imap.html
deleted file mode 100644
index 89335d3..0000000
--- a/james-distributed-app/3.8.1/extending/imap.html
+++ /dev/null
@@ -1,471 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Custom IMAP processing :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Extending server behavior</a></li>
- <li><a href="imap.html">Custom IMAP processing</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/extending/imap.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Custom IMAP processing</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>James allows defining your own handler packages.</p>
-</div>
-<div class="paragraph">
-<p>An Imap package is a simple class that bundles IMAP processing components:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>public interface ImapPackage {
- Collection<ClassName> processors();
-
- Collection<ClassName> decoders();
-
- Collection<ClassName> encoders();
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Processors needs to be of class <code>AbstractProcessor</code>, decoders of class <code>AbstractImapCommandParser</code>
-and encoders of class <code>ImapResponseEncoder</code>. Extensions-jar mechanism can be used to load custom classes.</p>
-</div>
-<div class="paragraph">
-<p>Custom configuration can be obtained through <code>ImapConfiguration</code> class via the <code>getCustomProperties</code> method.</p>
-</div>
-<div class="paragraph">
-<p>A full working example is available <a href="https://github.com/apache/james-project/tree/master/examples/custom-imap">here</a>.</p>
-</div>
-<div class="paragraph">
-<p>See this page for <a href="../configure/imap.html#_extending_imap" class="xref page">more details on configuring IMAP extensions</a>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_imap_additional_connection_checks"><a class="anchor" href="#_imap_additional_connection_checks"></a>IMAP additional Connection Checks</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>James allows defining your own additional connection checks to guarantee that the connecting IP is secured.</p>
-</div>
-<div class="paragraph">
-<p>A custom connection check should implement the following functional interface:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">@FunctionalInterface
-public interface ConnectionCheck {
- Publisher<Void> validate(InetSocketAddress remoteAddress);
-}</code></pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>validate</code> method is used to check the connecting IP is secured.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Then the custom defined ConnectionCheck can be added in <code>imapserver.xml</code> file:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs"><additionalConnectionChecks>org.apache.james.CrowdsecImapConnectionCheck</additionalConnectionChecks></code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>An example for configuration is available <a href="https://github.com/apache/james-project/blob/master/third-party/crowdsec/sample-configuration/imapserver.xml">here</a>.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/extending/index.html b/james-distributed-app/3.8.1/extending/index.html
deleted file mode 100644
index d010f91..0000000
--- a/james-distributed-app/3.8.1/extending/index.html
+++ /dev/null
@@ -1,673 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Extending server behavior :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item is-current-page" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Extending server behavior</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/extending/index.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Extending server behavior</h1>
-<div class="sect1">
-<h2 id="_available_extension_mechanisms"><a class="anchor" href="#_available_extension_mechanisms"></a>Available extension mechanisms</h2>
-<div class="sectionbody">
-<div class="imageblock">
-<div class="content">
-<img src="../_images/james-hexagons-extensions.png" alt="Extension mechanisms for the Distributed Server">
-</div>
-</div>
-<div class="paragraph">
-<p>The Distributed Server exposes several interfaces allowing the user to write custom extensions in
-order to extend the Distributed Server behavior.</p>
-</div>
-<div class="paragraph">
-<p>Writing <strong>Mailets</strong> and <strong>Matchers</strong> allows one to supply custom components for the
-<a href="mail-processing.html" class="xref page">Mail Processing</a> and
-enables to take decisions, and implement your business logic at the transport level.</p>
-</div>
-<div class="paragraph">
-<p>Writing <a href="mailbox-listeners.html" class="xref page">Mailbox listeners</a> enables to
-react to your user interaction with their mailbox. This powerful tool allows build advanced features
-for mail delivery servers.</p>
-</div>
-<div class="paragraph">
-<p>Writing <a href="smtp-hooks.html" class="xref page">SMTP hookd</a> enables to
-add features to your SMTP server.</p>
-</div>
-<div class="paragraph">
-<p>Writing <a href="webadmin-routes.html" class="xref page">WebAdmin routes</a> enables to
-add features to the WebAdmin REST API.</p>
-</div>
-<div class="paragraph">
-<p>Writing <a href="imap.html" class="xref page">IMAP extensions</a>.</p>
-</div>
-<div class="paragraph">
-<p>The <a href="https://github.com/apache/james-project/tree/master/examples">examples</a> are also a good reference.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_handling_injections_for_your_extensions"><a class="anchor" href="#_handling_injections_for_your_extensions"></a>Handling injections for your extensions</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_injecting_core_components"><a class="anchor" href="#_injecting_core_components"></a>Injecting core components</h3>
-<div class="paragraph">
-<p>You can very easily inject core components into your custom extensions.</p>
-</div>
-<div class="paragraph">
-<p>All you need is to pass them via a constructor annotated via <strong>@Inject</strong>.</p>
-</div>
-<div class="paragraph">
-<p>For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>public class MyMailet extends GenericMailet {
- private final UsersRepository usersRepository;
-
- @Inject
- public MyMailet(UsersRepository usersRepository) {
- this.usersRepository = usersRepository;
- }
-
- @Override
- public void service(Mail mail) throws MessagingException {
- // Do something
- }
-}</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_injecting_simple_extension_components"><a class="anchor" href="#_injecting_simple_extension_components"></a>Injecting simple extension components</h3>
-<div class="paragraph">
-<p>Furthermore, concrete implementation, that are part of your extension, can be injected as well.</p>
-</div>
-<div class="paragraph">
-<p>Consider the following example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>public class MyService {
-
-}
-
-public class MyMailet extends GenericMailet {
- private final MyService myService;
-
- @Inject
- public MyMailet(MyService myService) {
- this.usersRepository = myService;
- }
-
- @Override
- public void service(Mail mail) throws MessagingException {
- // Do something
- }
-}</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_defining_custom_injections_for_your_extensions"><a class="anchor" href="#_defining_custom_injections_for_your_extensions"></a>Defining custom injections for your extensions</h3>
-<div class="paragraph">
-<p>However, to inject an interface into your extension, you will need additional injection definitions.</p>
-</div>
-<div class="paragraph">
-<p>To so:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>1. Given an interface defined in an additional JAR:</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>public interface MyService {}</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>2. And an implementation of that interface, in another additional JAR:</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>public class MyServiceImpl extends MyService {}</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>3. We need to define a binding for MyService to be bound to MyServiceImpl</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>public class MyServiceModule extends AbstractModule {
- @Override
- protected void configure() {
- bind(MyServiceImpl.class).in(Scopes.SINGLETON);
- bind(MyService.class).to(MyServiceImpl.class);
- }
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Both <strong>MyService</strong>, <strong>MyServiceImpl</strong> and <strong>MyServiceModule</strong> needs to be in the <strong>extensions-jars</strong>
-folder (potentially different jars).</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>4. <strong>MyServiceModule</strong> needs to be registered in <a href="../configure/extensions.html" class="xref page"><strong>extensions.properties</strong></a></p>
-</li>
-<li>
-<p>5. <strong>MyService</strong> can then be used as part of your extensions</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>public class MyMailet extends GenericMailet {
- private final MyService myService;
-
- @Inject
- public MyMailet(MyService myService) {
- this.usersRepository = myService;
- }
-
- @Override
- public void service(Mail mail) throws MessagingException {
- // Do something
- }
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note that overriding injection definitions of the Distributed Server for your injections is not supported.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_starting_your_components"><a class="anchor" href="#_starting_your_components"></a>Starting your components</h3>
-<div class="paragraph">
-<p>Sometimes you wish to 'start' your extensions. This can be achieved through defining your own <code>UserDefinedStartable</code>:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">public class MyStartable implements UserDefinedStartable {
- @Override
- public void start() {
- // Will be called
- }
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Your startable then needs to be registered within <code>extensions.properties</code>:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">guice.extension.startable=com.company.MyStartable</code></pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_pre_packaged_extensions"><a class="anchor" href="#_pre_packaged_extensions"></a>Pre-packaged extensions</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_rate_limiting_for_mailet_processing"><a class="anchor" href="#_rate_limiting_for_mailet_processing"></a>Rate Limiting for mailet processing</h3>
-<div class="paragraph">
-<p><strong>Vendor</strong>: Apache Foundation (James project), Apache License V2</p>
-</div>
-<div class="paragraph">
-<p><a href="https://github.com/apache/james-project/tree/master/server/mailet/rate-limiter">Project link</a> contains detailed set
-up instructions and configuration examples as well as a pre-configured docker-compose.</p>
-</div>
-<div class="paragraph">
-<p>This extension ships mailets for applying advanced rate limit criteria to the email transiting through your James server.
-It is shipped with two backends implemented:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>in memory</strong>: For single server mode.</p>
-</li>
-<li>
-<p><strong>Redis</strong>: Uses <a href="https://redis.io/">Redis</a> as a shared, fast and scalable in-memory datastore, allowing to apply rate
-limiting in a distributed fashion. Here is the <a href="https://github.com/apache/james-project/tree/master/server/mailet/rate-limiter">link</a> to the Redis extension for rate limiting.</p>
-</li>
-<li>
-<p>Alternative extensions can be written and loaded into James using the <a href="#_handling_injections_for_your_extensions">Guice extension mechanism</a>
-and providing custom injections for the <code>RateLimiterFactoryProvider</code> class.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This extension ships the following mailets:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>PerSenderRateLimit</code> allows defining limits applied to the senders of emails (count of email, count of recipients,
-size, size * recipients)</p>
-</li>
-<li>
-<p><code>PerRecipientRateLimit</code> allows defining limits applied to the recipients of emails (count of email, size)</p>
-</li>
-<li>
-<p><code>GlobalRateLimit</code> allows defining limits applied to all the emails (count of email, count of recipients,
-size, size * recipients)</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Depending on their positions and the matcher they are being combined with, those rate limiting rules could be applied to
-submitted emails, received emails or emitted email being relayed to third parties.</p>
-</div>
-<div class="sect3">
-<h4 id="_throttling"><a class="anchor" href="#_throttling"></a>Throttling</h4>
-<div class="paragraph">
-<p>Can use combine with <code>Requeue</code> mailet for a throttler by re-enqueue mail.
-<a href="https://github.com/apache/james-project/tree/master/server/mailet/rate-limiter#throttling">link</a></p>
-</div>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/extending/mail-processing.html b/james-distributed-app/3.8.1/extending/mail-processing.html
deleted file mode 100644
index 46111fb..0000000
--- a/james-distributed-app/3.8.1/extending/mail-processing.html
+++ /dev/null
@@ -1,591 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Custom mail processing components :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Extending server behavior</a></li>
- <li><a href="mail-processing.html">Custom mail processing components</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/extending/mail-processing.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Custom mail processing components</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>When none of the matchers and mailets available in James allows us to implement what we want, extension
-developers will have to write our own mailet and matcher in a separated maven project depending on James
-Mailet API.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_writing_custom_mailetsmatchers"><a class="anchor" href="#_writing_custom_mailetsmatchers"></a>Writing custom mailets/matchers</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>We will write a <strong>IsDelayedForMoreThan</strong> matcher with a configurable delay. If the Sent Date of incoming
-emails is older than specified delay, then the emails should be matched (return all mail recipients). Otherwise,
-we just return an empty list of recipients.</p>
-</div>
-<div class="paragraph">
-<p>To ease our Job, we can rely on the <strong>org.apache.james.apache-mailet-base</strong> maven project, which provides us
-a <strong>GenericMatcher</strong> that we can extend.</p>
-</div>
-<div class="paragraph">
-<p>Here is the dependency:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><dependency>
- <groupId>org.apache.james</groupId>
- <artifactId>apache-mailet-base</artifactId>
-</dependency></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The main method of a matcher is the <strong>match</strong> method:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>Collection<MailAddress> match(Mail mail) throws MessagingException;</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>For us, it becomes, with <strong>maxDelay</strong> being previously configured:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>private final Clock clock;
-private Duration maxDelay;
-
-@Override
-public Collection<MailAddress> match(Mail mail) throws MessagingException {
-Date sentDate = mail.getMessage().getSentDate();
-
- if (clock.instant().isAfter(sentDate.toInstant().plusMillis(maxDelay.toMillis()))) {
- return ImmutableList.copyOf(mail.getRecipients());
- }
- return ImmutableList.of();
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>GenericMatcher</strong> exposes us the condition that had been configured. We will use it to compute <strong>maxDelay</strong>.
-We can do it in the <strong>init()</strong> method exposed by the generic matcher:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>public static final TimeConverter.Unit DEFAULT_UNIT = TimeConverter.Unit.HOURS;
-
-@Override
-public void init() {
- String condition = getCondition();
- maxDelay = Duration.ofMillis(TimeConverter.getMilliSeconds(condition, DEFAULT_UNIT));
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Now, let’s take a look at the <strong>SendPromotionCode</strong> mailet. Of course, we want to write a generic mailet
-with a configurable reason (why are we sending the promotion code). To keep things simple, only one promotion
-code will be used, and will be written in the configuration. We can here also simply extend the
-<strong>GenericMailet</strong> helper class.</p>
-</div>
-<div class="paragraph">
-<p>The main method of a mailet is the <strong>service</strong> method:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>void service(Mail mail) throws MessagingException;</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>For us, it becomes, with <strong>reason</strong> and <strong>promotionCode</strong> being previously configured:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>public static final boolean REPLY_TO_SENDER_ONLY = false;
-
-private String reason;
-private String promotionCode;
-
-@Override
-public void service(Mail mail) throws MessagingException {
-MimeMessage response = (MimeMessage) mail.getMessage()
-.reply(REPLY_TO_SENDER_ONLY);
-
- response.setText(reason + "\n\n" +
- "Here is the following promotion code that you can use on your next order: " + promotionCode);
-
- MailAddress sender = getMailetContext().getPostmaster();
- ImmutableList<MailAddress> recipients = ImmutableList.of(mail.getSender());
-
- getMailetContext()
- .sendMail(sender, recipients, response);
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note that we can interact with the mail server through the mailet context for sending mails, knowing postmaster, etc…​</p>
-</div>
-<div class="paragraph">
-<p><strong>GenericMailet</strong> exposes us the 'init parameters' that had been configured for this mailet. We will
-use it to retrieve <strong>reason</strong> and <strong>promotionCode</strong>.
-We can do it in the <strong>init()</strong> method exposed by the generic mailet:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>@Override
-public void init() throws MessagingException {
- reason = getInitParameter("reason");
- promotionCode = getInitParameter("promotionCode");
-
- if (Strings.isNullOrEmpty(reason)) {
- throw new MessagingException("'reason' is compulsory");
- }
- if (Strings.isNullOrEmpty(promotionCode)) {
- throw new MessagingException("'promotionCode' is compulsory");
- }
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can retrieve the sources of this mini-project on <a href="https://github.com/apache/james-project/tree/master/examples/custom-mailets">GitHub</a></p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_loading_custom_mailets_with_james"><a class="anchor" href="#_loading_custom_mailets_with_james"></a>Loading custom mailets with James</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Now is the time we will run James with our awesome matcher and mailet configured.</p>
-</div>
-<div class="paragraph">
-<p>First, we will need to compile our project with <strong>mvn clean install</strong>. A jar will be outputted in the target directory.</p>
-</div>
-<div class="paragraph">
-<p>Then, we will write the <strong>mailetcontainer.xml</strong> file expressing the logic we want:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailetcontainer enableJmx="true">
-
-<context>
- <postmaster>postmaster@localhost</postmaster>
-</context>
-
-<spooler>
- <threads>20</threads>
-</spooler>
-
-<processors>
- <processor state="root" enableJmx="true">
- <mailet match="All" class="PostmasterAlias"/>
- <mailet match="org.apache.james.examples.custom.mailets.IsDelayedForMoreThan=1 day"
- class="org.apache.james.examples.custom.mailets.SendPromotionCode">
- <reason>Your email had been delayed for a long time. Because we are sorry about it, please find the
- following promotion code.</reason>
- <promotionCode>1542-2563-5469</promotionCode>
- </mailet>
- <!-- Rest of the configuration -->
-</processor>
-
-<!-- Other processors -->
-</processors>
-</mailetcontainer></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Finally, we will start a James server using that. We will rely on docker default image for simplicity.
-We need to be using the <strong>mailetcontainer.xml</strong> configuration that we had been writing and position
-the jar in the <strong>extensions-jars</strong> folder (specific to guice).</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/extending/mailbox-listeners.html b/james-distributed-app/3.8.1/extending/mailbox-listeners.html
deleted file mode 100644
index acec792..0000000
--- a/james-distributed-app/3.8.1/extending/mailbox-listeners.html
+++ /dev/null
@@ -1,501 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Custom Mailbox Listeners :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Extending server behavior</a></li>
- <li><a href="mailbox-listeners.html">Custom Mailbox Listeners</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/extending/mailbox-listeners.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Custom Mailbox Listeners</h1>
-<div class="sect1">
-<h2 id="_writing_additional_listener"><a class="anchor" href="#_writing_additional_listener"></a>Writing additional listener</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>An extension writer can write new additional mailbox listeners.</p>
-</div>
-<div class="paragraph">
-<p>To do so, extend the <strong>GroupMailboxListener</strong> defined in the <strong>mailbox-api</strong>.</p>
-</div>
-<div class="paragraph">
-<p>Here is the dependency:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><dependency>
- <groupId>org.apache.james</groupId>
- <artifactId>apache-james-mailbox-api</artifactId>
-</dependency></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Here are the methods you can implement:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> void event(Event event) throws Exception;</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>allows you to specify the business logic you want to execute upon new events generation.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> boolean isHandling(Event event);</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Allows to know if this event is worth execution, and should be sent on the EventBus. This avoids execution of non
-handled events and can save some IOs.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_registration_of_custom_additional_listeners"><a class="anchor" href="#_registration_of_custom_additional_listeners"></a>Registration of custom additional listeners</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Your custom additional listener needs to be in the <strong>extensions-jars</strong> folder.</p>
-</div>
-<div class="paragraph">
-<p>You need to register its fully qualified class name in <a href="../configure/listeners.html" class="xref page">listeners.xml</a></p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_events"><a class="anchor" href="#_events"></a>Events</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Your listener will be called for the following events:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>MailboxAdded</strong>: A new mailbox had been created</p>
-</li>
-<li>
-<p><strong>MailboxDeletion</strong>: A new mailbox had been deleted</p>
-</li>
-<li>
-<p><strong>MailboxRenamed</strong>: A mailbox was renamed</p>
-</li>
-<li>
-<p><strong>MailboxACLUpdated</strong>: The rights of a mailbox had been changed</p>
-</li>
-<li>
-<p><strong>Expunged</strong>: Some messages had been deleted</p>
-</li>
-<li>
-<p><strong>FlagsUpdated</strong>: Some message flags had been updated</p>
-</li>
-<li>
-<p><strong>Added</strong>: New messages had been added to a mailbox</p>
-</li>
-<li>
-<p><strong>QuotaUsageUpdatedEvent</strong>: The quota of a given account had changed</p>
-</li>
-<li>
-<p><strong>MessageMoveEvent</strong>: A message was moved between mailboxes. This carries an account wide information. Spoecific
-mailboxes event (Added & Expunged) will be emitted as well.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_example"><a class="anchor" href="#_example"></a>Example</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p><a href="http://james.apache.org/howTo/custom-listeners.html">This page</a> provides a working example for writing additional custom mailbox listeners.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/extending/smtp-hooks.html b/james-distributed-app/3.8.1/extending/smtp-hooks.html
deleted file mode 100644
index f69361b..0000000
--- a/james-distributed-app/3.8.1/extending/smtp-hooks.html
+++ /dev/null
@@ -1,524 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Custom SMTP hooks :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Extending server behavior</a></li>
- <li><a href="smtp-hooks.html">Custom SMTP hooks</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/extending/smtp-hooks.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Custom SMTP hooks</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>SMTP hooks enable extending capabilities of the SMTP server and are run synchronously upon email reception, before the email is
-enqueued in the MailQueue, and before any mail processing takes place.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_available_generic_hooks"><a class="anchor" href="#_available_generic_hooks"></a>Available generic hooks</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The following interfaces allows interacting with the following commands:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>AuthHook</strong>: Implement this interfaces to hook in the AUTH Command.</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> HookResult doAuth(SMTPSession session, Username username, String password);</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>HeloHook</strong>: Implement this interfaces to hook in the HELO Command</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> HookResult doHelo(SMTPSession session, String helo);</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>MailHook</strong>: Implement this interfaces to hook in the MAIL Command</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> HookResult doMail(SMTPSession session, MaybeSender sender);</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>MailParametersHook</strong>: Implement this interfaces to hook in the MAIL Command, this is called for specific mail arguments</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> HookResult doMailParameter(SMTPSession session, String paramName, String paramValue);</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>QuitHook</strong>: Implement this interfaces to hook in the QUIT Command</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> HookResult doQuit(SMTPSession session);</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>RcptHook</strong>: Implement this interfaces to hook in the RCPT Command</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> HookResult doRcpt(SMTPSession session, MaybeSender sender, MailAddress rcpt);</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>UnknownHook</strong>: Hook for unknown commands</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> HookResult doUnknown(SMTPSession session, String command);</pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_custom_hook_registration"><a class="anchor" href="#_custom_hook_registration"></a>Custom hook registration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Register you hooks using <a href="../configure/smtp.html" class="xref page"><strong>smtpserver.xml</strong></a> handlerchain property.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_writing_additional_smtp_commands"><a class="anchor" href="#_writing_additional_smtp_commands"></a>Writing additional SMTP commands</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>What to do if the Hook API is not enough for you ?</p>
-</div>
-<div class="paragraph">
-<p>You want for example to write a code which handles a new command like "YOURCOOLCOMMAND: whatever@example".</p>
-</div>
-<div class="paragraph">
-<p>For this kind of needs you should implement the CommandHandler interface. This gives you a lower-level API
-to handle this kind of tasks. If you want to support a custom Hook in your CommandHandler its the best to
-just extend AbstractHookableCmdHandler.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/extending/webadmin-routes.html b/james-distributed-app/3.8.1/extending/webadmin-routes.html
deleted file mode 100644
index 0fa7674..0000000
--- a/james-distributed-app/3.8.1/extending/webadmin-routes.html
+++ /dev/null
@@ -1,457 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Custom WebAdmin routes :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Extending server behavior</a></li>
- <li><a href="webadmin-routes.html">Custom WebAdmin routes</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/extending/webadmin-routes.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Custom WebAdmin routes</h1>
-<div class="sect1">
-<h2 id="_writing_custom_webadmin_routes"><a class="anchor" href="#_writing_custom_webadmin_routes"></a>Writing custom WebAdmin routes</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>An extension writer can write additional WebAdmin routes, effectively exposed over the WebAdmin API.</p>
-</div>
-<div class="paragraph">
-<p>To do so, extend the <strong>Routes</strong> defined in the <strong>james-server-webadmin-core</strong>.</p>
-</div>
-<div class="paragraph">
-<p>Here is the dependency:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><dependency>
- <groupId>org.apache.james</groupId>
- <artifactId>james-server-webadmin-core</artifactId>
-</dependency></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Here is the interface:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>public interface Routes {
- String getBasePath();
-
- void define(Service service);
-}</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>getBasePath</strong> enables to know the prefix of your route</p>
-</li>
-<li>
-<p><strong>define</strong> enables you to register endpoint is the <a href="http://sparkjava.com/">sparkjava</a> Service instance. HTTP <strong>GET</strong>, <strong>POST</strong>,
-<strong>PUT</strong>, <strong>PATCH</strong>, etc.. verbs are supported.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_registration"><a class="anchor" href="#_registration"></a>Registration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Your custom WebAdmin routes needs to be in the <strong>extensions-jars</strong> folder.</p>
-</div>
-<div class="paragraph">
-<p>You need to register its fully qualified class name in <a href="../configure/webadmin.html" class="xref page">webadmin.properties</a>
-using the <strong>extensions.routes</strong> property.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/index.html b/james-distributed-app/3.8.1/index.html
deleted file mode 100644
index 1061090..0000000
--- a/james-distributed-app/3.8.1/index.html
+++ /dev/null
@@ -1,451 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>James Distributed Mail Server :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="index.html">Apache James Distributed Server</a></li>
- <li><a href="index.html">Distributed James Application</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/index.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">James Distributed Mail Server</h1>
-<div class="paragraph">
-<p>The Distributed server offers an easy way to scale email server. Based on
-noSQL solutions, it is intended to be easy to operate for large
-deployments, without needing sharding and protocol aware load balancing.</p>
-</div>
-<div class="paragraph">
-<p>The Distributed Server does assume that you have advanced
-technical knowledge and is the most complex and feature-rich option.</p>
-</div>
-<div class="paragraph">
-<p>This server is:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Intended for use by experts only</p>
-</li>
-<li>
-<p>Used for large-scale distributed deployments</p>
-</li>
-<li>
-<p>Is designed for Mail Delivery use cases but can also carry out mail processing</p>
-</li>
-<li>
-<p>The most feature-rich server, but also by far the most complex</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>In this section of the documentation, we will introduce you to:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="objectives.html" class="xref page">Objectives and motivation of the Distributed Server</a></p>
-</li>
-<li>
-<p><a href="architecture/index.html" class="xref page">Overview of architecture</a></p>
-</li>
-<li>
-<p><a href="run/index.html" class="xref page">Run the Distributed Server</a></p>
-</li>
-<li>
-<p><a href="configure/index.html" class="xref page">Configure the Distributed Server</a></p>
-</li>
-<li>
-<p><a href="operate/index.html" class="xref page">Operation of the Distributed Server</a></p>
-</li>
-<li>
-<p><a href="extending/index.html" class="xref page">How to extend the server</a></p>
-</li>
-</ul>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../_/js/site.js" data-ui-root-path="../../_"></script>
-<script async src="../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/objectives.html b/james-distributed-app/3.8.1/objectives.html
deleted file mode 100644
index f5b5ce4..0000000
--- a/james-distributed-app/3.8.1/objectives.html
+++ /dev/null
@@ -1,461 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Objectives and motivation :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="2">
- <a class="nav-link" href="objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="index.html">Apache James Distributed Server</a></li>
- <li><a href="index.html">Distributed James Application</a></li>
- <li><a href="objectives.html">Objectives and motivation</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/objectives.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Objectives and motivation</h1>
-<div class="paragraph">
-<p>The objective of the Distributed Server is to provided facilities to execute
-an advanced, extendable, and distributed email system. It is intended for
-organization with serious requirements, such as high-throughput or very large
-data sets.</p>
-</div>
-<div class="paragraph">
-<p>Scaling emails infrastructure is a notoriously hard problem. The intent of the Distributed server is
-to implement a mail server using modern NoSQL technologies. It relies on:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Object Storage enables scalable yet cheap storage of large amount of data</p>
-</li>
-<li>
-<p>The use of NoSQL for metadata storage enables vertical scalability</p>
-</li>
-<li>
-<p>Finally a Distributed search engine enables quick and efficient search</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Replication, data availability are thus handled by battle tested technologies.</p>
-</div>
-<div class="paragraph">
-<p>Such a data storage strategy enables:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>A centralized management of all server components, as each Distributed James server hold the same view on data.</p>
-</li>
-<li>
-<p>A better load and data repartition between email servers, as each James servers can cary out any tasks.</p>
-</li>
-<li>
-<p>Easy scaling. Handling more users or more data is as easy as adding James instances and scaling the underlying
-databases.</p>
-</li>
-<li>
-<p>Easier load-balancing, as any email server can handle requests from any user. No sharding is involved.</p>
-</li>
-<li>
-<p>Rich feature, especially regarding <strong>sharing</strong>. Every user can delegate access to any over users.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Furthermore, this server is intended to be easily customisable so that it can easily be adapted to ones needs.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Several packaged extensions can be <a href="configure/index.html#_for_extensions" class="xref page">configured</a></p>
-</li>
-<li>
-<p>It is easy to write and load <a href="extending/index.html" class="xref page">your own extensions</a></p>
-</li>
-</ul>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../_/js/site.js" data-ui-root-path="../../_"></script>
-<script async src="../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/operate/cassandra-migration.html b/james-distributed-app/3.8.1/operate/cassandra-migration.html
deleted file mode 100644
index 39eeb33..0000000
--- a/james-distributed-app/3.8.1/operate/cassandra-migration.html
+++ /dev/null
@@ -1,436 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Cassandra migration :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Operate</a></li>
- <li><a href="cassandra-migration.html">Cassandra migration</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/operate/cassandra-migration.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Cassandra migration</h1>
-<div class="paragraph">
-<p>Cassandra upgrades implies the creation of a new table. Thus restarting James is needed, as new tables are created on restart.</p>
-</div>
-<div class="paragraph">
-<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>
-</div>
-<div class="paragraph">
-<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>
-</div>
-<div class="paragraph">
-<p>These schema updates can be triggered by <a href="webadmin.html#_cassandra_schema_upgrades" class="xref page">webadmin</a>.</p>
-</div>
-<div class="paragraph">
-<p>Note that currently the progress can be tracked by logs.</p>
-</div>
-<div class="paragraph">
-<p>Here are the implemented migrations:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>From V8 to V9</strong> : Adopt a more compact representation for message properties.</p>
-</li>
-<li>
-<p><strong>From V9 to V10</strong> : Handles Mailbox ACL transactionality with event-sourcing. We got read of SERIAL consistency upon
-reads thus unlocking a major performance enhancement.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The <a href="guide.html#_updating_cassandra_schema_version" class="xref page">Operator guide</a> further details the migration process.</p>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/operate/cli.html b/james-distributed-app/3.8.1/operate/cli.html
deleted file mode 100644
index 4538ad4..0000000
--- a/james-distributed-app/3.8.1/operate/cli.html
+++ /dev/null
@@ -1,887 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Command Line Interface :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Operate</a></li>
- <li><a href="cli.html">Command Line Interface</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/operate/cli.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Command Line Interface</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>The distributed server is packed with a command line client.</p>
-</div>
-<div class="paragraph">
-<p>To run this command line client simply execute:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>java -jar /root/james-cli.jar -h 127.0.0.1 -p 9999 COMMAND</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The following document will explain you which are the available options
-for <strong>COMMAND</strong>.</p>
-</div>
-<div class="paragraph">
-<p>Note: the above command line before <strong>COMMAND</strong> will be documented as <em>{cli}</em>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_manage_domains"><a class="anchor" href="#_manage_domains"></a>Manage Domains</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Domains represent the domain names handled by your server.</p>
-</div>
-<div class="paragraph">
-<p>You can add a domain:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} AddDomain domain.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can remove a domain:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} RemoveDomain domain.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>(Note: associated users are not removed automatically)</p>
-</div>
-<div class="paragraph">
-<p>Check if a domain is handled:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} ContainsDomain domain.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>And list your domains:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} ListDomains</pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_managing_users"><a class="anchor" href="#_managing_users"></a>Managing users</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Note: the following commands are explained with virtual hosting turned
-on.</p>
-</div>
-<div class="paragraph">
-<p>Users are accounts on the mail server. James can maintain mailboxes for
-them.</p>
-</div>
-<div class="paragraph">
-<p>You can add a user:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} AddUser user@domain.tld password</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note: the domain used should have been previously created.</p>
-</div>
-<div class="paragraph">
-<p>You can delete a user:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} RemoveUser user@domain.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>(Note: associated mailboxes are not removed automatically)</p>
-</div>
-<div class="paragraph">
-<p>And change a user password:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} SetPassword user@domain.tld password</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note: All these write operations can not be performed on LDAP backend,
-as the implementation is read-only.</p>
-</div>
-<div class="paragraph">
-<p>Finally, you can list users:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} ListUsers</pre>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_virtual_hosting"><a class="anchor" href="#_virtual_hosting"></a>Virtual hosting</h3>
-<div class="paragraph">
-<p>James supports virtualhosting.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>If set to true in the configuration, then the username is the full
-mail address.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The domains then become a part of the user.</p>
-</div>
-<div class="paragraph">
-<p><em>usera@domaina.com and</em> <em>usera@domainb.com</em> on a mail server with
-<em>domaina.com</em> and <em>domainb.com</em> configured are mail addresses that
-belongs to different users.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>If set to false in the configurations, then the username is the mail
-address local part.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>It means that a user is automatically created for all the domains
-configured on your server.</p>
-</div>
-<div class="paragraph">
-<p><em>usera@domaina.com and</em> <em>usera@domainb.com</em> on a mail server with
-<em>domaina.com</em> and <em>domainb.com</em> configured are mail addresses that
-belongs to the same users.</p>
-</div>
-<div class="paragraph">
-<p>Here are some sample commands for managing users when virtual hosting is
-turned off:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} AddUser user password
-{cli} RemoveUser user
-{cli} SetPassword user password</pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_managing_mailboxes"><a class="anchor" href="#_managing_mailboxes"></a>Managing mailboxes</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>An administrator can perform some basic operation on user mailboxes.</p>
-</div>
-<div class="paragraph">
-<p>Note on mailbox formatting: mailboxes are composed of three parts.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>The namespace, indicating what kind of mailbox it is. (Shared or
-not?). The value for users mailboxes is #private . Note that for now no
-other values are supported as James do not support shared mailboxes.</p>
-</li>
-<li>
-<p>The username as stated above, depending on the virtual hosting value.</p>
-</li>
-<li>
-<p>And finally mailbox name. Be aware that `.' serves as mailbox
-hierarchy delimiter.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<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>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} DeleteUserMailboxes user@domain.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>He can delete a specific mailbox:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} DeleteMailbox #private user@domain.tld INBOX.toBeDeleted</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>He can list the mailboxes of a specific user:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} ListUserMailboxes user@domain.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>And finally can create a specific mailbox:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} CreateMailbox #private user@domain.tld INBOX.newFolder</pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_adding_a_message_in_a_mailbox"><a class="anchor" href="#_adding_a_message_in_a_mailbox"></a>Adding a message in a mailbox</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The administrator can use the CLI to add a message in a mailbox. this
-can be done using:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} ImportEml #private user@domain.tld INBOX.newFolder /full/path/to/file.eml</pre>
-</div>
-</div>
-<div class="paragraph">
-<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 href="mailto:user@domain.tld">user@domain.tld</a>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_managing_mappings"><a class="anchor" href="#_managing_mappings"></a>Managing mappings</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>A mapping is a recipient rewriting rule. There is several kind of
-rewriting rules:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>address mapping: rewrite a given mail address into an other one.</p>
-</li>
-<li>
-<p>regex mapping.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>You can manage address mapping like (redirects email from
-<a href="mailto:fromUser@fromDomain.tld">fromUser@fromDomain.tld</a> to <a href="mailto:redirected@domain.new">redirected@domain.new</a>, then deletes the
-mapping):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} AddAddressMapping fromUser fromDomain.tld redirected@domain.new
-{cli} RemoveAddressMapping fromUser fromDomain.tld redirected@domain.new</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can manage regex mapping like this:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} AddRegexMapping redirected domain.new .*@domain.tld
-{cli} RemoveRegexMapping redirected domain.new .*@domain.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can view mapping for a mail address:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} ListUserDomainMappings user domain.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>And all mappings defined on the server:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} ListMappings</pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_manage_quotas"><a class="anchor" href="#_manage_quotas"></a>Manage quotas</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Quotas are limitations on a group of mailboxes. They can limit the
-<strong>size</strong> or the <strong>messages count</strong> in a group of mailboxes.</p>
-</div>
-<div class="paragraph">
-<p>James groups by defaults mailboxes by user (but it can be overridden),
-and labels each group with a quotaroot.</p>
-</div>
-<div class="paragraph">
-<p>To get the quotaroot a given mailbox belongs to:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} GetQuotaroot #private user@domain.tld INBOX</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Then you can get the specific quotaroot limitations.</p>
-</div>
-<div class="paragraph">
-<p>For the number of messages:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} GetMessageCountQuota quotaroot</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>And for the storage space available:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} GetStorageQuota quotaroot</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You see the maximum allowed for these values:</p>
-</div>
-<div class="paragraph">
-<p>For the number of messages:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} GetMaxMessageCountQuota quotaroot</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>And for the storage space available:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} GetMaxStorageQuota quotaroot</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can also specify maximum for these values.</p>
-</div>
-<div class="paragraph">
-<p>For the number of messages:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} SetMaxMessageCountQuota quotaroot value</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>And for the storage space available:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} SetMaxStorageQuota quotaroot value</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>With value being an integer. Please note the use of units for storage
-(K, M, G). For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} SetMaxStorageQuota someone@apache.org 4G</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Moreover, James allows to specify global maximum values, at the server
-level. Note: syntax is similar to what was exposed previously.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} SetGlobalMaxMessageCountQuota value
-{cli} GetGlobalMaxMessageCountQuota
-{cli} SetGlobalMaxStorageQuota value
-{cli} GetGlobalMaxStorageQuota</pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_re_indexing"><a class="anchor" href="#_re_indexing"></a>Re-indexing</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>James allow you to index your emails in a search engine, for making
-search faster.</p>
-</div>
-<div class="paragraph">
-<p>For some reasons, you might want to re-index your mails (inconsistencies
-across datastore, migrations).</p>
-</div>
-<div class="paragraph">
-<p>To re-index all mails of all mailboxes of all users, type:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} ReindexAll</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>And for a specific mailbox:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} Reindex #private user@domain.tld INBOX</pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_sieve_scripts_quota"><a class="anchor" href="#_sieve_scripts_quota"></a>Sieve scripts quota</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>James implements Sieve (RFC-5228). Your users can then write 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>
-</div>
-<div class="paragraph">
-<p>You can define quota for the total size of Sieve scripts, per user.</p>
-</div>
-<div class="paragraph">
-<p>Syntax is similar to what was exposed for quotas. For defaults values:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} GetSieveQuota
-{cli} SetSieveQuota value
-{cli} RemoveSieveQuota</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>And for specific user quotas:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} GetSieveUserQuota user@domain.tld
-{cli} SetSieveQuota user@domain.tld value
-{cli} RemoveSieveUserQuota user@domain.tld</pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_switching_of_mailbox_implementation"><a class="anchor" href="#_switching_of_mailbox_implementation"></a>Switching of mailbox implementation</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Migration is experimental for now. You would need to customize <strong>Spring</strong>
-configuration to add a new mailbox manager with a different bean name.</p>
-</div>
-<div class="paragraph">
-<p>You can then copy data across mailbox managers using:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} CopyMailbox srcBean dstBean</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You will then need to reconfigure James to use the new mailbox manager.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/operate/guide.html b/james-distributed-app/3.8.1/operate/guide.html
deleted file mode 100644
index 10cb644..0000000
--- a/james-distributed-app/3.8.1/operate/guide.html
+++ /dev/null
@@ -1,1267 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Operator guide :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Operate</a></li>
- <li><a href="guide.html">Operator guide</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/operate/guide.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Operator guide</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This guide aims to be an entry-point to the James documentation for user
-managing a distributed Guice James server.</p>
-</div>
-<div class="paragraph">
-<p>It includes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Simple architecture explanations</p>
-</li>
-<li>
-<p>Propose some diagnostics for some common issues</p>
-</li>
-<li>
-<p>Present procedures that can be set up to address these issues</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>In order to not duplicate information, existing documentation will be
-linked.</p>
-</div>
-<div class="paragraph">
-<p>Please note that this product is under active development, should be
-considered experimental and thus targets advanced users.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_basic_monitoring"><a class="anchor" href="#_basic_monitoring"></a>Basic Monitoring</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>A toolbox is available to help an administrator diagnose issues:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="logging.html" class="xref page">Structured logging into Kibana</a></p>
-</li>
-<li>
-<p><a href="metrics.html" class="xref page">Metrics graphs into Grafana</a></p>
-</li>
-<li>
-<p><a href="webadmin.html#_healthcheck" class="xref page">WebAdmin HealthChecks</a></p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_mail_processing"><a class="anchor" href="#_mail_processing"></a>Mail processing</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Currently, an administrator can monitor mail processing failure through <code>ERROR</code> log
-review. We also recommend watching in Kibana INFO logs using the
-<code>org.apache.james.transport.mailets.ToProcessor</code> value as their <code>logger</code>. Metrics about
-mail repository size, and the corresponding Grafana boards are yet to be contributed.</p>
-</div>
-<div class="paragraph">
-<p>Furthermore, given the default mailet container configuration, we recommend monitoring
-<code>cassandra://var/mail/error/</code> to be empty.</p>
-</div>
-<div class="paragraph">
-<p>WebAdmin exposes all utilities for
-<a href="webadmin.html#_reprocessing_mails_from_a_mail_repository" class="xref page">reprocessing
-all mails in a mail repository</a> or
-<a href="webadmin.html#_reprocessing_a_specific_mail_from_a_mail_repository" class="xref page">reprocessing
-a single mail in a mail repository</a>.</p>
-</div>
-<div class="paragraph">
-<p>In order to prevent unbounded processing that could consume unbounded resources. We can provide a CRON with <code>limit</code> parameter.
-Ex: 10 reprocessed per minute
-Note that it only support the reprocessing all mails.</p>
-</div>
-<div class="paragraph">
-<p>Also, one can decide to
-<a href="webadmin.html#_removing_all_mails_from_a_mail_repository" class="xref page">delete
-all the mails of a mail repository</a> or
-<a href="webadmin.html#_removing_a_mail_from_a_mail_repository" class="xref page">delete
-a single mail of a mail repository</a>.</p>
-</div>
-<div class="paragraph">
-<p>Performance of mail processing can be monitored via the
-<a href="https://github.com/apache/james-project/blob/d2cf7c8e229d9ed30125871b3de5af3cb1553649/server/grafana-reporting/es-datasource/MAILET-1490071694187-dashboard.json">mailet
-grafana board</a> and
-<a href="https://github.com/apache/james-project/blob/d2cf7c8e229d9ed30125871b3de5af3cb1553649/server/grafana-reporting/es-datasource/MATCHER-1490071813409-dashboard.json">matcher
-grafana board</a>.</p>
-</div>
-<div class="sect2">
-<h3 id="_recipient_rewriting"><a class="anchor" href="#_recipient_rewriting"></a>Recipient rewriting</h3>
-<div class="paragraph">
-<p>Given the default configuration, errors (like loops) uopn recipient rewritting will lead
-to emails being stored in <code>cassandra://var/mail/rrt-error/</code>.</p>
-</div>
-<div class="paragraph">
-<p>We recommend monitoring the content of this mail repository to be empty.</p>
-</div>
-<div class="paragraph">
-<p>If it is not empty, we recommend
-verifying user mappings via <a href="webadmin.html#<em>listing_user_mappings</em>" class="xref page">User Mappings webadmin API</a> then once identified break the loop by removing
-some Recipient Rewrite Table entry via the
-<a href="webadmin.html#_removing_an_alias_of_an_user" class="xref page">Delete Alias</a>,
-<a href="webadmin.html#_removing_a_group_member" class="xref page">Delete Group member</a>,
-<a href="webadmin.html#_removing_a_destination_of_a_forward" class="xref page">Delete forward</a>,
-<a href="webadmin.html#_remove_an_address_mapping" class="xref page">Delete Address mapping</a>,
-<a href="webadmin.html#_removing_a_domain_mapping" class="xref page">Delete Domain mapping</a>
-or <a href="webadmin.html#_removing_a_regex_mapping" class="xref page">Delete Regex mapping</a>
-APIs (as needed).</p>
-</div>
-<div class="paragraph">
-<p>The <code>Mail.error</code> field can help diagnose the issue as well. Then once
-the root cause has been addressed, the mail can be reprocessed.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_mailbox_event_bus"><a class="anchor" href="#_mailbox_event_bus"></a>Mailbox Event Bus</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>It is possible for the administrator of James to define the mailbox
-listeners he wants to use, by adding them in the
-<a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/listeners.xml">listeners.xml</a>
-configuration file. It’s possible also to add your own custom mailbox
-listeners. This enables to enhance capabilities of James as a Mail
-Delivery Agent. You can get more information about those
-<a href="config-listeners.html">here</a>.</p>
-</div>
-<div class="paragraph">
-<p>Currently, an administrator can monitor listeners failures through
-<code>ERROR</code> log review. Metrics regarding mailbox listeners can be monitored
-via
-<a href="https://github.com/apache/james-project/blob/d2cf7c8e229d9ed30125871b3de5af3cb1553649/server/grafana-reporting/es-datasource/MailboxListeners-1528958667486-dashboard.json">mailbox_listeners
-grafana board</a> and
-<a href="https://github.com/apache/james-project/blob/d2cf7c8e229d9ed30125871b3de5af3cb1553649/server/grafana-reporting/es-datasource/MailboxListeners%20rate-1552903378376.json">mailbox_listeners_rate
-grafana board</a>.</p>
-</div>
-<div class="paragraph">
-<p>Upon exceptions, a bounded number of retries are performed (with
-exponential backoff delays). If after those retries the listener is
-still failing to perform its operation, then the event will be stored in
-the <a href="webadmin.html#_event_dead_letter" class="xref page">Event Dead Letter</a>. This
-API allows diagnosing issues, as well as redelivering the events.</p>
-</div>
-<div class="paragraph">
-<p>To check that you have undelivered events in your system, you can first
-run the associated with
-<a href="webadmin.html#_healthcheck" class="xref page">event dead letter health check</a> .
-You can explore Event DeadLetter content through WebAdmin. For
-this, <a href="webadmin.html#_listing_mailbox_listener_groups" class="xref page">list mailbox listener groups</a>
-you will get a list of groups back, allowing
-you to check if those contain registered events in each by
-<a href="webadmin.html#_listing_failed_events" class="xref page">listing their failed events</a>.</p>
-</div>
-<div class="paragraph">
-<p>If you get failed events IDs back, you can as well
-<a href="webadmin.html#_getting_event_details" class="xref page">check their details</a>.</p>
-</div>
-<div class="paragraph">
-<p>An easy way to solve this is just to trigger then the
-<a href="webadmin.html#_redeliver_all_events" class="xref page">redeliver all events</a>
-task. It will start reprocessing all the failed events registered in
-event dead letters.</p>
-</div>
-<div class="paragraph">
-<p>In order to prevent unbounded processing that could consume unbounded resources. We can provide a CRON with <code>limit</code> parameter.
-Ex: 10 redelivery per minute</p>
-</div>
-<div class="paragraph">
-<p>If for some other reason you don’t need to redeliver all events, you
-have more fine-grained operations allowing you to
-<a href="webadmin.html#_redeliver_group_events" class="xref page">redeliver group events</a>
-or even just
-<a href="webadmin.html#_redeliver_a_single_event" class="xref page">redeliver a single event</a>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_opensearch_indexing"><a class="anchor" href="#_opensearch_indexing"></a>OpenSearch Indexing</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>A projection of messages is maintained in OpenSearch via a listener
-plugged into the mailbox event bus in order to enable search features.</p>
-</div>
-<div class="paragraph">
-<p>You can find more information about OpenSearch configuration
-<a href="config-opensearch.html">here</a>.</p>
-</div>
-<div class="sect2">
-<h3 id="_usual_troubleshooting_procedures"><a class="anchor" href="#_usual_troubleshooting_procedures"></a>Usual troubleshooting procedures</h3>
-<div class="paragraph">
-<p>As explained in the <a href="#_mailbox_event_bus">Mailbox Event Bus</a> section,
-processing those events can fail sometimes.</p>
-</div>
-<div class="paragraph">
-<p>Currently, an administrator can monitor indexation failures through
-<code>ERROR</code> log review. You can as well
-<a href="webadmin.html#_listing_failed_events" class="xref page">list failed events</a> by
-looking with the group called
-<code>org.apache.james.mailbox.opensearch.events.OpenSearchListeningMessageSearchIndex$OpenSearchListeningMessageSearchIndexGroup</code>.
-A first on-the-fly solution could be to just
-<a href="#_mailbox_event_bus">redeliver those group events with event dead letter</a>.</p>
-</div>
-<div class="paragraph">
-<p>If the event storage in dead-letters fails (for instance in the face of
-Cassandra storage exceptions), then you might need to use our WebAdmin
-reIndexing tasks.</p>
-</div>
-<div class="paragraph">
-<p>From there, you have multiple choices. You can
-<a href="webadmin.html#_reindexing_all_mails" class="xref page">reIndex all mails</a>,
-<a href="webadmin.html#_reindexing_a_mailbox_mails" class="xref page">reIndex mails from a mailbox</a> or even just
-<a href="webadmin.html#_reindexing_a_single_mail_by_messageid" class="xref page">reIndex a single mail</a>.</p>
-</div>
-<div class="paragraph">
-<p>When checking the result of a reIndexing task, you might have failed
-reprocessed mails. You can still use the task ID to
-<a href="webadmin.html#_fixing_previously_failed_reindexing" class="xref page">reprocess previously failed reIndexing mails</a>.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_on_the_fly_opensearch_index_setting_update"><a class="anchor" href="#_on_the_fly_opensearch_index_setting_update"></a>On the fly OpenSearch Index setting update</h3>
-<div class="paragraph">
-<p>Sometimes you might need to update index settings. Cases when an
-administrator might want to update index settings include:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Scaling out: increasing the shard count might be needed.</p>
-</li>
-<li>
-<p>Changing string analysers, for instance to target another language</p>
-</li>
-<li>
-<p>etc.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>In order to achieve such a procedure, you need to:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://www.elastic.co/guide/en/elasticsearch/reference/7.10/indices-create-index.html">Create
-the new index</a> with the right settings and mapping</p>
-</li>
-<li>
-<p>James uses two aliases on the mailbox index: one for reading
-(<code>mailboxReadAlias</code>) and one for writing (<code>mailboxWriteAlias</code>). First
-<a href="https://www.elastic.co/guide/en/elasticsearch/reference/7.10/indices-aliases.html">add
-an alias</a> <code>mailboxWriteAlias</code> to that new index, so that now James
-writes on the old and new indexes, while only keeping reading on the
-first one</p>
-</li>
-<li>
-<p>Now trigger a
-<a href="https://www.elastic.co/guide/en/elasticsearch/reference/7.10/docs-reindex.html">reindex</a>
-from the old index to the new one (this actively relies on <code>_source</code>
-field being present)</p>
-</li>
-<li>
-<p>When this is done, add the <code>mailboxReadAlias</code> alias to the new index</p>
-</li>
-<li>
-<p>Now that the migration to the new index is done, you can
-<a href="https://www.elastic.co/guide/en/elasticsearch/reference/7.10/indices-delete-index.html">drop
-the old index</a></p>
-</li>
-<li>
-<p>You might want as well modify the James configuration file
-<a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/opensearch.properties">elasticsearch.properties</a>
-by setting the parameter <code>opensearch.index.mailbox.name</code> to the name
-of your new index. This is to avoid that James re-creates index upon
-restart</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p><em>Note</em>: keep in mind that reindexing can be a very long operation
-depending on the volume of mails you have stored.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_solving_cassandra_inconsistencies"><a class="anchor" href="#_solving_cassandra_inconsistencies"></a>Solving cassandra inconsistencies</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Cassandra backend uses data duplication to workaround Cassandra query
-limitations. However, Cassandra is not doing transaction when writing in
-several tables, this can lead to consistency issues for a given piece of
-data. The consequence could be that the data is in a transient state
-(that should never appear outside of the system).</p>
-</div>
-<div class="paragraph">
-<p>Because of the lack of transactions, it’s hard to prevent these kind of
-issues. We had developed some features to fix some existing cassandra
-inconsistency issues that had been reported to James.</p>
-</div>
-<div class="sect2">
-<h3 id="_jmap_message_fast_view_projections"><a class="anchor" href="#_jmap_message_fast_view_projections"></a>Jmap message fast view projections</h3>
-<div class="paragraph">
-<p>When you read a Jmap message, some calculated properties are expected to
-be fast to retrieve, like <code>preview</code>, <code>hasAttachment</code>. James achieves it
-by pre-calculating and storing them into a caching table
-(<code>message_fast_view_projection</code>). Missing caches are populated on
-message reads and will temporarily decrease the performance.</p>
-</div>
-<div class="sect3">
-<h4 id="_how_to_detect_the_outdated_projections"><a class="anchor" href="#_how_to_detect_the_outdated_projections"></a>How to detect the outdated projections</h4>
-<div class="paragraph">
-<p>You can watch the <code>MessageFastViewProjection</code> health check at
-<a href="webadmin.html#_check_all_components" class="xref page">webadmin documentation</a>.
-It provides a check based on the ratio of missed projection reads.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_how_to_solve"><a class="anchor" href="#_how_to_solve"></a>How to solve</h4>
-<div class="paragraph">
-<p>Since the MessageFastViewProjection is self healing, you should be
-concerned only if the health check still returns <code>degraded</code> for a while,
-there’s a possible thing you can do is looking at James logs for more
-clues.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_mailboxes"><a class="anchor" href="#_mailboxes"></a>Mailboxes</h3>
-<div class="paragraph">
-<p><code>mailboxPath</code> and <code>mailbox</code> tables share common fields like <code>mailboxId</code>
-and mailbox <code>name</code>. A successful operation of creating/renaming/delete
-mailboxes has to succeed at updating <code>mailboxPath</code> and <code>mailbox</code> table.
-Any failure on creating/updating/delete records in <code>mailboxPath</code> or
-<code>mailbox</code> can produce inconsistencies.</p>
-</div>
-<div class="sect3">
-<h4 id="_how_to_detect_the_inconsistencies"><a class="anchor" href="#_how_to_detect_the_inconsistencies"></a>How to detect the inconsistencies</h4>
-<div class="paragraph">
-<p>If you found the suspicious <code>MailboxNotFoundException</code> in your logs.
-Currently, there’s no dedicated tool for that, we recommend scheduling
-the SolveInconsistencies task below for the mailbox object on a regular
-basis, avoiding peak traffic in order to address both inconsistencies
-diagnostic and fixes.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_how_to_solve_2"><a class="anchor" href="#_how_to_solve_2"></a>How to solve</h4>
-<div class="paragraph">
-<p>An admin can run offline webadmin
-<a href="webadmin.html#_fixing_mailboxes_inconsistencies" class="xref page">solve Cassandra mailbox object inconsistencies task</a>
-in order to sanitize his
-mailbox denormalization.</p>
-</div>
-<div class="paragraph">
-<p>In order to ensure being offline, stop the traffic on SMTP, JMAP and
-IMAP ports, for example via re-configuration or firewall rules.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_mailboxes_counters"><a class="anchor" href="#_mailboxes_counters"></a>Mailboxes Counters</h3>
-<div class="paragraph">
-<p>James maintains a per mailbox projection for message count and unseen
-message count. Failures during the denormalization process will lead to
-incorrect results being returned.</p>
-</div>
-<div class="sect3">
-<h4 id="_how_to_detect_the_inconsistencies_2"><a class="anchor" href="#_how_to_detect_the_inconsistencies_2"></a>How to detect the inconsistencies</h4>
-<div class="paragraph">
-<p>Incorrect message count/message unseen count could be seen in the
-<code>Mail User Agent</code> (IMAP or JMAP). Invalid values are reported in the
-logs as warning with the following class
-<code>org.apache.james.mailbox.model.MailboxCounters</code> and the following
-message prefix: <code>Invalid mailbox counters</code>.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_how_to_solve_3"><a class="anchor" href="#_how_to_solve_3"></a>How to solve</h4>
-<div class="paragraph">
-<p>Execute the
-<a href="webadmin.html#_recomputing_mailbox_counters" class="xref page">recompute Mailbox counters task</a>.
-This task is not concurrent-safe. Concurrent
-increments & decrements will be ignored during a single mailbox
-processing. Re-running this task may eventually return the correct
-result.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_messages"><a class="anchor" href="#_messages"></a>Messages</h3>
-<div class="paragraph">
-<p>Messages are denormalized and stored in both <code>imapUidTable</code> (source of
-truth) and <code>messageIdTable</code>. Failure in the denormalization process will
-cause inconsistencies between the two tables.</p>
-</div>
-<div class="sect3">
-<h4 id="_how_to_detect_the_inconsistencies_3"><a class="anchor" href="#_how_to_detect_the_inconsistencies_3"></a>How to detect the inconsistencies</h4>
-<div class="paragraph">
-<p>User can see a message in JMAP but not in IMAP, or mark a message as
-`SEEN' in JMAP but the message flag is still unchanged in IMAP.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_how_to_solve_4"><a class="anchor" href="#_how_to_solve_4"></a>How to solve</h4>
-<div class="paragraph">
-<p>Execute the
-<a href="webadmin.html#_fixing_message_inconsistencies" class="xref page">solve Cassandra message inconsistencies task</a>. This task is not
-concurrent-safe. User actions concurrent to the inconsistency fixing
-task could result in new inconsistencies being created. However the
-source of truth <code>imapUidTable</code> will not be affected and thus re-running
-this task may eventually fix all issues.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_quotas"><a class="anchor" href="#_quotas"></a>Quotas</h3>
-<div class="paragraph">
-<p>User can monitor the amount of space and message count he is allowed to
-use, and that he is effectively using. James relies on an event bus and
-Cassandra to track the quota of an user. Upon Cassandra failure, this
-value can be incorrect.</p>
-</div>
-<div class="sect3">
-<h4 id="_how_to_detect_the_inconsistencies_4"><a class="anchor" href="#_how_to_detect_the_inconsistencies_4"></a>How to detect the inconsistencies</h4>
-<div class="paragraph">
-<p>Incorrect quotas could be seen in the <code>Mail User Agent</code> (IMAP or JMAP).</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_how_to_solve_5"><a class="anchor" href="#_how_to_solve_5"></a>How to solve</h4>
-<div class="paragraph">
-<p>Execute the
-<a href="webadmin.html#_recomputing_current_quotas_for_users" class="xref page">recompute Quotas counters task</a>. This task is not concurrent-safe. Concurrent
-operations will result in an invalid quota to be persisted. Re-running
-this task may eventually return the correct result.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_rrt_recipientrewritetable_mapping_sources"><a class="anchor" href="#_rrt_recipientrewritetable_mapping_sources"></a>RRT (RecipientRewriteTable) mapping sources</h3>
-<div class="paragraph">
-<p><code>rrt</code> and <code>mappings_sources</code> tables store information about address
-mappings. The source of truth is <code>rrt</code> and <code>mappings_sources</code> is the
-projection table containing all mapping sources.</p>
-</div>
-<div class="sect3">
-<h4 id="_how_to_detect_the_inconsistencies_5"><a class="anchor" href="#_how_to_detect_the_inconsistencies_5"></a>How to detect the inconsistencies</h4>
-<div class="paragraph">
-<p>Right now there’s no tool for detecting that, we’re proposing a
-<a href="https://issues.apache.org/jira/browse/JAMES-3069">development plan</a>. By
-the mean time, the recommendation is to execute the
-<code>SolveInconsistencies</code> task below in a regular basis.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_how_to_solve_6"><a class="anchor" href="#_how_to_solve_6"></a>How to solve</h4>
-<div class="paragraph">
-<p>Execute the Cassandra mapping <code>SolveInconsistencies</code> task described in
-<a href="webadmin.html#_operations_on_mappings_sources" class="xref page">webadmin documentation</a></p>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_setting_cassandra_user_permissions"><a class="anchor" href="#_setting_cassandra_user_permissions"></a>Setting Cassandra user permissions</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>When a Cassandra cluster is serving more than a James cluster, the
-keyspaces need isolation. It can be achieved by configuring James server
-with credentials preventing access or modification of other keyspaces.</p>
-</div>
-<div class="paragraph">
-<p>We recommend you to not use the initial admin user of Cassandra and
-provide a different one with a subset of permissions for each
-application.</p>
-</div>
-<div class="sect2">
-<h3 id="_prerequisites"><a class="anchor" href="#_prerequisites"></a>Prerequisites</h3>
-<div class="paragraph">
-<p>We’re gonna use the Cassandra super users to create roles and grant
-permissions for them. To do that, Cassandra requires you to login via
-username/password authentication and enable granting in cassandra
-configuration file.</p>
-</div>
-<div class="paragraph">
-<p>For example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>echo -e "\nauthenticator: PasswordAuthenticator" >> /etc/cassandra/cassandra.yaml
-echo -e "\nauthorizer: org.apache.cassandra.auth.CassandraAuthorizer" >> /etc/cassandra/cassandra.yaml</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_prepare_cassandra_roles_keyspaces_for_james"><a class="anchor" href="#_prepare_cassandra_roles_keyspaces_for_james"></a>Prepare Cassandra roles & keyspaces for James</h3>
-<div class="sect3">
-<h4 id="_create_a_role"><a class="anchor" href="#_create_a_role"></a>Create a role</h4>
-<div class="paragraph">
-<p>Have a look at
-<a href="http://cassandra.apache.org/doc/3.11.11/cql/security.html">cassandra documentation</a> section <code>CREATE ROLE</code> for more information</p>
-</div>
-<div class="paragraph">
-<p>E.g.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>CREATE ROLE james_one WITH PASSWORD = 'james_one' AND LOGIN = true;</pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_create_a_keyspace"><a class="anchor" href="#_create_a_keyspace"></a>Create a keyspace</h4>
-<div class="paragraph">
-<p>Have a look at
-<a href="http://cassandra.apache.org/doc/3.11.11/cql/ddl.html">cassandra documentation</a> section <code>CREATE KEYSPACE</code> for more information</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_grant_permissions_on_created_keyspace_to_the_role"><a class="anchor" href="#_grant_permissions_on_created_keyspace_to_the_role"></a>Grant permissions on created keyspace to the role</h4>
-<div class="paragraph">
-<p>The role to be used by James needs to have full rights on the keyspace
-that James is using. Assuming the keyspace name is <code>james_one_keyspace</code>
-and the role be <code>james_one</code>.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>GRANT CREATE ON KEYSPACE james_one_keyspace TO james_one; // Permission to create tables on the appointed keyspace
-GRANT SELECT ON KEYSPACE james_one_keyspace TO james_one; // Permission to select from tables on the appointed keyspace
-GRANT MODIFY ON KEYSPACE james_one_keyspace TO james_one; // Permission to update data in tables on the appointed keyspace</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>Warning</strong>: The granted role doesn’t have the right to create keyspaces,
-thus, if you haven’t created the keyspace, James server will fail to
-start is expected.</p>
-</div>
-<div class="paragraph">
-<p><strong>Tips</strong></p>
-</div>
-<div class="paragraph">
-<p>Since all of Cassandra roles used by different James are supposed to
-have a same set of permissions, you can reduce the works by creating a
-base role set like <code>typical_james_role</code> with all of necessary
-permissions. After that, with each James, create a new role and grant
-the <code>typical_james_role</code> to the newly created one. Note that, once a
-base role set is updated ( granting or revoking rights) all granted
-roles are automatically updated.</p>
-</div>
-<div class="paragraph">
-<p>E.g.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>CREATE ROLE james1 WITH PASSWORD = 'james1' AND LOGIN = true;
-GRANT typical_james_role TO james1;
-
-CREATE ROLE james2 WITH PASSWORD = 'james2' AND LOGIN = true;
-GRANT typical_james_role TO james2;</pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_revoke_harmful_permissions_from_the_created_role"><a class="anchor" href="#_revoke_harmful_permissions_from_the_created_role"></a>Revoke harmful permissions from the created role</h4>
-<div class="paragraph">
-<p>We want a specific role that cannot describe or query the information of
-other keyspaces or tables used by another application. By default,
-Cassandra allows every role created to have the right to describe any
-keyspace and table. There’s no configuration that can make effect on
-that topic. Consequently, you have to accept that your data models are
-still being exposed to anyone having credentials to Cassandra.</p>
-</div>
-<div class="paragraph">
-<p>For more information, have a look at
-<a href="http://cassandra.apache.org/doc/3.11.11/cql/security.html">cassandra documentation</a> section <code>REVOKE PERMISSION</code>.</p>
-</div>
-<div class="paragraph">
-<p>Except for the case above, the permissions are not auto available for a
-specific role unless they are granted by <code>GRANT</code> command. Therefore, if
-you didn’t provide more permissions than
-<a href="#_grant_permissions_on_created_keyspace_to_the_role">granting
-section</a>, there’s no need to revoke.</p>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_cassandra_table_level_configuration"><a class="anchor" href="#_cassandra_table_level_configuration"></a>Cassandra table level configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>While <em>Distributed James</em> is shipped with default table configuration
-options, these settings should be refined depending of your usage.</p>
-</div>
-<div class="paragraph">
-<p>These options are:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>The <a href="https://cassandra.apache.org/doc/latest/operating/compaction.html">compaction algorithms</a></p>
-</li>
-<li>
-<p>The <a href="https://cassandra.apache.org/doc/latest/operating/bloom_filters.html">bloom filter sizing</a></p>
-</li>
-<li>
-<p>The <a href="https://cassandra.apache.org/doc/latest/operating/compression.html?highlight=chunk%20size">chunk size</a></p>
-</li>
-<li>
-<p>The <a href="https://www.datastax.com/blog/2011/04/maximizing-cache-benefit-cassandra">cachingoptions</a></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The compaction algorithms allow a tradeoff between background IO upon
-writes and reads. We recommend:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Using <strong>Leveled Compaction Strategy</strong> on
-read intensive tables subject to updates. This limits the count of
-SStables being read at the cost of more background IO. High garbage
-collections can be caused by an inappropriate use of Leveled Compaction
-Strategy.</p>
-</li>
-<li>
-<p>Otherwise use the default <strong>Size Tiered Compaction Strategy</strong>.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Bloom filters help avoiding unnecessary reads on SSTables. This
-probabilistic data structure can tell an entry absence from a SSTable,
-as well as the presence of an entry with an associated probability. If a
-lot of false positives are noticed, the size of the bloom filters can be
-increased.</p>
-</div>
-<div class="paragraph">
-<p>As explained in
-<a href="https://thelastpickle.com/blog/2018/08/08/compression_performance.html">this post</a>,
-chunk size used upon compression allows a tradeoff between reads
-and writes. A smaller size will mean decreasing compression, thus it
-increases data being stored on disk, but allow lower chunks to be read
-to access data, and will favor reads. A bigger size will mean better
-compression, thus writing less, but it might imply reading bigger
-chunks.</p>
-</div>
-<div class="paragraph">
-<p>Cassandra enables a key cache and a row cache. Key cache enables to skip
-reading the partition index upon reads, thus performing 1 read to the
-disk instead of 2. Enabling this cache is globally advised. Row cache
-stores the entire row in memory. It can be seen as an optimization, but
-it might actually use memory no longer available for instance for file
-system cache. We recommend turning it off on modern SSD hardware.</p>
-</div>
-<div class="paragraph">
-<p>A review of your usage can be conducted using
-<a href="https://cassandra.apache.org/doc/latest/tools/nodetool/nodetool.html">nodetool</a>
-utility. For example <code>nodetool tablestats {keyspace}</code> allows reviewing
-the number of SSTables, the read/write ratios, bloom filter efficiency.
-<code>nodetool tablehistograms {keyspace}.{table}</code> might give insight about
-read/write performance.</p>
-</div>
-<div class="paragraph">
-<p>Table level options can be changed using <strong>ALTER TABLE</strong> for example with
-the <a href="https://cassandra.apache.org/doc/latest/tools/cqlsh.html">cqlsh</a>
-utility. A full compaction might be needed in order for the changes to
-be taken into account.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_mail_queue"><a class="anchor" href="#_mail_queue"></a>Mail Queue</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_fine_tune_configuration_for_rabbitmq"><a class="anchor" href="#_fine_tune_configuration_for_rabbitmq"></a>Fine tune configuration for RabbitMQ</h3>
-<div class="paragraph">
-<p>In order to adapt mail queue settings to the actual traffic load, an
-administrator needs to perform fine configuration tunning as explained
-in
-<a href="https://github.com/apache/james-project/blob/master/src/site/xdoc/server/config-rabbitmq.xml">rabbitmq.properties</a>.</p>
-</div>
-<div class="paragraph">
-<p>Be aware that <code>MailQueue::getSize</code> is currently performing a browse and
-thus is expensive. Size recurring metric reporting thus introduces
-performance issues. As such, we advise setting
-<code>mailqueue.size.metricsEnabled=false</code>.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_managing_email_queues"><a class="anchor" href="#_managing_email_queues"></a>Managing email queues</h3>
-<div class="paragraph">
-<p>Managing an email queue is an easy task if you follow this procedure:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>First, <a href="webadmin.html#_listing_mail_queues" class="xref page">List mail queues</a>
-and <a href="webadmin.html#_getting_a_mail_queue_details" class="xref page">get a mail queue details</a>.</p>
-</li>
-<li>
-<p>And then
-<a href="webadmin.html#_listing_the_mails_of_a_mail_queue" class="xref page">List the mails of a mail queue</a>.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>In case, you need to clear an email queue because there are only spam or
-trash emails in the email queue you have this procedure to follow:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>All mails from the given mail queue will be deleted with
-<a href="webadmin.html#_clearing_a_mail_queue" class="xref page">Clearing a mail queue</a>.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_updating_cassandra_schema_version"><a class="anchor" href="#_updating_cassandra_schema_version"></a>Updating Cassandra schema version</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>A schema version indicates you which schema your James server is relying
-on. The schema version number tracks if a migration is required. For
-instance, when the latest schema version is 2, and the current schema
-version is 1, you might think that you still have data in the deprecated
-Message table in the database. Hence, you need to migrate these messages
-into the MessageV2 table. Once done, you can safely bump the current
-schema version to 2.</p>
-</div>
-<div class="paragraph">
-<p>Relying on outdated schema version prevents you to benefit from the
-newest performance and safety improvements. Otherwise, there’s something
-very unexpected in the way we manage cassandra schema: we create new
-tables without asking the admin about it. That means your James version
-is always using the last tables but may also take into account the old
-ones if the migration is not done yet.</p>
-</div>
-<div class="sect2">
-<h3 id="_how_to_detect_when_we_should_update_cassandra_schema_version"><a class="anchor" href="#_how_to_detect_when_we_should_update_cassandra_schema_version"></a>How to detect when we should update Cassandra schema version</h3>
-<div class="paragraph">
-<p>When you see in James logs
-<code>org.apache.james.modules.mailbox.CassandraSchemaVersionStartUpCheck</code>
-showing a warning like <code>Recommended version is versionX</code>, you should
-perform an update of the Cassandra schema version.</p>
-</div>
-<div class="paragraph">
-<p>Also, we keep track of changes needed when upgrading to a newer version.
-You can read this
-<a href="https://github.com/apache/james-project/blob/master/upgrade-instructions.md">upgrade
-instructions</a>.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_how_to_update_cassandra_schema_version"><a class="anchor" href="#_how_to_update_cassandra_schema_version"></a>How to update Cassandra schema version</h3>
-<div class="paragraph">
-<p>These schema updates can be triggered by webadmin using the Cassandra
-backend. Following steps are for updating Cassandra schema version:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>At the very first step, you need to
-<a href="webadmin.html#_retrieving_current_cassandra_schema_version" class="xref page">retrieve
-current Cassandra schema version</a></p>
-</li>
-<li>
-<p>And then, you
-<a href="webadmin.html#_retrieving_latest_available_cassandra_schema_version" class="xref page">retrieve
-latest available Cassandra schema version</a> to make sure there is a
-latest available version</p>
-</li>
-<li>
-<p>Eventually, you can update the current schema version to the one you
-got with
-<a href="webadmin.html#_upgrading_to_the_latest_version" class="xref page">upgrading to
-the latest version</a></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Otherwise, if you need to run the migrations to a specific version, you
-can use
-<a href="webadmin.html#_upgrading_to_a_specific_version" class="xref page">Upgrading to a
-specific version</a></p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_deleted_message_vault"><a class="anchor" href="#_deleted_message_vault"></a>Deleted Message Vault</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>We recommend the administrator to
-<a href="#_cleaning_expired_deleted_messages">run it</a> in cron job to save
-storage volume.</p>
-</div>
-<div class="sect2">
-<h3 id="_how_to_configure_deleted_messages_vault"><a class="anchor" href="#_how_to_configure_deleted_messages_vault"></a>How to configure deleted messages vault</h3>
-<div class="paragraph">
-<p>To setup James with Deleted Messages Vault, you need to follow those
-steps:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Enable Deleted Messages Vault by configuring Pre Deletion Hooks.</p>
-</li>
-<li>
-<p>Configuring the retention time for the Deleted Messages Vault.</p>
-</li>
-</ul>
-</div>
-<div class="sect3">
-<h4 id="_enable_deleted_messages_vault_by_configuring_pre_deletion_hooks"><a class="anchor" href="#_enable_deleted_messages_vault_by_configuring_pre_deletion_hooks"></a>Enable Deleted Messages Vault by configuring Pre Deletion Hooks</h4>
-<div class="paragraph">
-<p>You need to configure this hook in
-<a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/listeners.xml">listeners.xml</a>
-configuration file. More details about configuration & example can be
-found at <a href="http://james.apache.org/server/config-listeners.html">Pre
-Deletion Hook Configuration</a></p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_configuring_the_retention_time_for_the_deleted_messages_vault"><a class="anchor" href="#_configuring_the_retention_time_for_the_deleted_messages_vault"></a>Configuring the retention time for the Deleted Messages Vault</h4>
-<div class="paragraph">
-<p>In order to configure the retention time for the Deleted Messages Vault,
-an administrator needs to perform fine configuration tunning as
-explained in
-<a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/deletedMessageVault.properties">deletedMessageVault.properties</a>.
-Mails are not retained forever as you have to configure a retention
-period (by <code>retentionPeriod</code>) before using it (with one-year retention
-by default if not defined).</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_restore_deleted_messages_after_deletion"><a class="anchor" href="#_restore_deleted_messages_after_deletion"></a>Restore deleted messages after deletion</h3>
-<div class="paragraph">
-<p>After users deleted their mails and emptied the trash, the admin can use
-<a href="webadmin.html#_restore_deleted_messages" class="xref page">Restore Deleted Messages</a>
-to restore all the deleted mails.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_cleaning_expired_deleted_messages"><a class="anchor" href="#_cleaning_expired_deleted_messages"></a>Cleaning expired deleted messages</h3>
-<div class="paragraph">
-<p>You can delete all deleted messages older than the configured
-<code>retentionPeriod</code> by using
-<a href="webadmin.html#_deleted_messages_vault" class="xref page">Purge Deleted Messages</a>.
-We recommend calling this API in CRON job on 1st day each
-month.</p>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/operate/index.html b/james-distributed-app/3.8.1/operate/index.html
deleted file mode 100644
index 6531f0f..0000000
--- a/james-distributed-app/3.8.1/operate/index.html
+++ /dev/null
@@ -1,494 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Operate the Distributed server :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item is-current-page" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Operate</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/operate/index.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Operate the Distributed server</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>The following pages detail how to operate the Distributed server.</p>
-</div>
-<div class="paragraph">
-<p>Once you have a Distributed James server up and running you then need to ensure it operates correctly and has a decent performance.
-You may also need to perform some operation maintenance or recover from incidents. This section covers
-these topics.</p>
-</div>
-<div class="paragraph">
-<p>Read more about <a href="logging.html" class="xref page">Logging</a>.</p>
-</div>
-<div class="paragraph">
-<p>The <a href="webadmin.html" class="xref page">WebAdmin Restfull administration API</a> is the
-recommended way to operate the Distributed James server. It allows managing and interacting with most
-server components.</p>
-</div>
-<div class="paragraph">
-<p>The <a href="cli.html" class="xref page">Command line interface</a> allows to interact with some
-server components. However it relies on JMX technologies and its use is discouraged.</p>
-</div>
-<div class="paragraph">
-<p>The <a href="metrics.html" class="xref page">metrics</a> allows to build latency and throughput
-graphs, that can be visualized, for instance in <strong>Grafana</strong>.</p>
-</div>
-<div class="paragraph">
-<p>We did put together a <a href="guide.html" class="xref page">detailed guide</a> for
-distributed James operators. We also propose a <a href="performanceChecklist.html" class="xref page">performance checklist</a>.</p>
-</div>
-<div class="paragraph">
-<p>We also included a guide for <a href="migrating.html" class="xref page">migrating existing data</a> into the distributed server.</p>
-</div>
-<div class="paragraph">
-<p>Read more about <a href="cassandra-migration.html" class="xref page">Cassandra data migration</a>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_upgrading"><a class="anchor" href="#_upgrading"></a>Upgrading</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This section sums up and links upgrade instructions for people willing to upgrade their Distributed server to newer versions.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. Upgrade path</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Upgrade from</th>
-<th class="tableblock halign-left valign-top">Recommended upgrade path to 3.7.4</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">3.7.0 - 3.7.4</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Upgrade, and apply <a href="https://github.com/apache/james-project/blob/master/upgrade-instructions.md#380-version">3.8.0 upgrade instructions</a></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">3.6.0 - 3.6.2</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">1. Upgrade, and apply <a href="https://github.com/apache/james-project/blob/master/upgrade-instructions.md#370-version">3.7.0 upgrade instructions</a></p>
-<p class="tableblock">2. Upgrade, and apply <a href="https://github.com/apache/james-project/blob/master/upgrade-instructions.md#380-version">3.8.0 upgrade instructions</a></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">3.5.0</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">1. Upgrade, and apply <a href="https://github.com/apache/james-project/blob/master/upgrade-instructions.md#360-version">3.6.0 upgrade instructions</a></p>
-<p class="tableblock">Note: Because of ElasticSearch upgrade (6.3 → 7.10) this migration cannot be done in a rolling fashion manner.</p>
-<p class="tableblock">2. Upgrade, and apply <a href="https://github.com/apache/james-project/blob/master/upgrade-instructions.md#370-version">3.7.0 upgrade instructions</a></p>
-<p class="tableblock">3. Upgrade, and apply <a href="https://github.com/apache/james-project/blob/master/upgrade-instructions.md#380-version">3.8.0 upgrade instructions</a></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">3.4.0</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">1. Rolling upgrade to 3.5.0, and apply <a href="https://github.com/apache/james-project/blob/master/upgrade-instructions.md#350-version">3.5.0 upgrade instructions</a></p>
-<p class="tableblock">2. Upgrade to 3.6.0, and apply <a href="https://github.com/apache/james-project/blob/master/upgrade-instructions.md#360-version">3.6.0 upgrade instructions</a></p>
-<p class="tableblock">Note: Because of ElasticSearch upgrade (6.3 → 7.10) this migration cannot be done in a rolling fashion manner.</p>
-<p class="tableblock">3. Upgrade, and apply <a href="https://github.com/apache/james-project/blob/master/upgrade-instructions.md#370-version">3.7.0 upgrade instructions</a></p>
-<p class="tableblock">4. Upgrade, and apply <a href="https://github.com/apache/james-project/blob/master/upgrade-instructions.md#380-version">3.8.0 upgrade instructions</a></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">3.3.0</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">1. upgrade to 3.4.0, and apply <a href="https://github.com/apache/james-project/blob/master/upgrade-instructions.md#340-version">3.4.0 upgrade instructions</a></p>
-<p class="tableblock">Note: Because of ElasticSearch upgrade (2.2 → 6.3) this migration cannot be done in a rolling fashion manner.</p>
-<p class="tableblock">2. Rolling upgrade to 3.5.0, and apply <a href="https://github.com/apache/james-project/blob/master/upgrade-instructions.md#350-version">3.5.0 upgrade instructions</a></p>
-<p class="tableblock">3. Upgrade to 3.6.0, and apply <a href="https://github.com/apache/james-project/blob/master/upgrade-instructions.md#360-version">3.6.0 upgrade instructions</a></p>
-<p class="tableblock">Note: Because of ElasticSearch upgrade (6.3 → 7.10) this migration cannot be done in a rolling fashion manner.</p>
-<p class="tableblock">4. Upgrade, and apply <a href="https://github.com/apache/james-project/blob/master/upgrade-instructions.md#370-version">3.7.0 upgrade instructions</a></p>
-<p class="tableblock">5. Upgrade, and apply <a href="https://github.com/apache/james-project/blob/master/upgrade-instructions.md#380-version">3.8.0 upgrade instructions</a></p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/operate/logging.html b/james-distributed-app/3.8.1/operate/logging.html
deleted file mode 100644
index f7a168f..0000000
--- a/james-distributed-app/3.8.1/operate/logging.html
+++ /dev/null
@@ -1,794 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Logging :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Operate</a></li>
- <li><a href="logging.html">Logging</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/operate/logging.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Logging</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>We recommend to closely monitoring <strong>ERROR</strong> and <strong>WARNING</strong> logs. Those
-logs should be considered not normal.</p>
-</div>
-<div class="paragraph">
-<p>If you encounter some suspicious logs:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>If you have any doubt about the log being caused by a bug in James
-source code, please reach us via the bug tracker, the user mailing list or our Gitter channel (see our
-<a href="http://james.apache.org/#second">community page</a>)</p>
-</li>
-<li>
-<p>They can be due to insufficient performance from tier applications (eg
-Cassandra timeouts). In such case we advise you to conduct a close
-review of performances at the tier level.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Leveraging filters in Kibana discover view can help to filter out
-''already known'' frequently occurring logs.</p>
-</div>
-<div class="paragraph">
-<p>When reporting ERROR or WARNING logs, consider adding the full logs, and
-related data (eg the raw content of a mail triggering an issue) to the
-bug report in order to ease resolution.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_logging_configuration"><a class="anchor" href="#_logging_configuration"></a>Logging configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Distributed James uses <a href="http://logback.qos.ch/">logback</a> as a logging library
-and <a href="https://docs.fluentbit.io/">FluentBit</a> as centralize logging.</p>
-</div>
-<div class="paragraph">
-<p>Information about logback configuration can be found
-<a href="http://logback.qos.ch/manual/configuration.html">here</a>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_structured_logging"><a class="anchor" href="#_structured_logging"></a>Structured logging</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_pushing_logs_to_elasticsearch"><a class="anchor" href="#_pushing_logs_to_elasticsearch"></a>Pushing logs to ElasticSearch</h3>
-<div class="paragraph">
-<p>Distributed Server leverages the use of MDC in order to achieve structured logging,
-and better add context to the logged information. We furthermore ship
-<a href="https://github.com/linagora/logback-elasticsearch-appender">Logback Elasticsearch Appender</a>
-on the classpath to easily allow direct log indexation in
-<a href="https://www.elastic.co/elasticsearch">ElasticSearch</a>.</p>
-</div>
-<div class="paragraph">
-<p>Here is a sample <code>conf/logback.xml</code> configuration file for logback with the following
-pre-requisites:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Logging both in an unstructured fashion on the console and in a structured fashion in ElasticSearch</p>
-</li>
-<li>
-<p>Logging ElasticSearch Log appender logs in the console</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Configuration for pushing log direct to ElasticSearch</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Logging ElasticSearch Log appender logs in the console</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><?xml version="1.0" encoding="UTF-8"?>
-<configuration scan="true" scanPeriod="30 seconds">
-
- <contextListener class="ch.qos.logback.classic.jul.LevelChangePropagator">
- <resetJUL>true</resetJUL>
- </contextListener>
-
- <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
- <encoder>
- <pattern>%d{yyyy.MM.dd HH:mm:ss.SSS} %highlight([%-5level]) %logger{15} - %msg%n%rEx</pattern>
- <immediateFlush>false</immediateFlush>
- </encoder>
- </appender>
-
- <appender name="ELASTIC" class="com.linagora.logback.elasticsearch.ElasticsearchAppender">
- <url>http://elasticsearch:9200/_bulk</url>
- <index>logs-james-%date{yyyy.MM.dd}</index>
- <type>tester</type>
- <includeMdc>true</includeMdc>
- <excludedMdcKeys>host</excludedMdcKeys>
- <errorLoggerName>es-error-logger</errorLoggerName>
- <properties>
- <property>
- <name>host</name>
- <value>${HOSTNAME}</value>
- <allowEmpty>false</allowEmpty>
- </property>
- <property>
- <name>severity</name>
- <value>%level</value>
- </property>
- <property>
- <name>thread</name>
- <value>%thread</value>
- </property>
- <property>
- <name>stacktrace</name>
- <value>%ex</value>
- </property>
- <property>
- <name>logger</name>
- <value>%logger</value>
- </property>
- </properties>
- <headers>
- <header>
- <name>Content-Type</name>
- <value>application/json</value>
- </header>
- </headers>
- </appender>
-
- <root level="WARN">
- <appender-ref ref="ELASTIC" />
- </root>
-
- <logger name="es-error-logger" level="DEBUG" additivity="false">
- <appender-ref ref="CONSOLE" />
- </logger>
-
- <logger name="org.apache.james" level="INFO" />
-
-</configuration></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_using_fluentbit_as_a_log_forwarder"><a class="anchor" href="#_using_fluentbit_as_a_log_forwarder"></a>Using FluentBit as a log forwarder</h3>
-<div class="sect3">
-<h4 id="_using_docker"><a class="anchor" href="#_using_docker"></a>Using Docker</h4>
-<div class="paragraph">
-<p>Distributed Server leverages the use of MDC in order to achieve structured logging, and better add context to the logged information. We furthermore ship json logs to file with RollingFileAppender on the classpath to easily allow FluentBit to directly tail the log file.
-Here is a sample conf/logback.xml configuration file for logback with the following pre-requisites:</p>
-</div>
-<div class="paragraph">
-<p>Logging in a structured json fashion and write to file for centralizing logging.
-Centralize logging third party like FluentBit can tail from logging’s file then filter/process and put in to ElastichSearch</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><?xml version="1.0" encoding="UTF-8"?>
-<configuration>
-
- <contextListener class="ch.qos.logback.classic.jul.LevelChangePropagator">
- <resetJUL>true</resetJUL>
- </contextListener>
-
- <appender name="LOG_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
- <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
- <fileNamePattern>logs/james.%d{yyyy-MM-dd}.%i.log</fileNamePattern>
- <maxHistory>1</maxHistory>
- <totalSizeCap>200MB</totalSizeCap>
- <maxFileSize>100MB</maxFileSize>
- </rollingPolicy>
-
- <encoder class="ch.qos.logback.core.encoder.LayoutWrappingEncoder">
- <layout class="ch.qos.logback.contrib.json.classic.JsonLayout">
- <timestampFormat>yyyy-MM-dd'T'HH:mm:ss.SSSX</timestampFormat>
- <timestampFormatTimezoneId>Etc/UTC</timestampFormatTimezoneId>
-
- <!-- Importance for handling multiple lines log -->
- <appendLineSeparator>true</appendLineSeparator>
-
- <jsonFormatter class="ch.qos.logback.contrib.jackson.JacksonJsonFormatter">
- <prettyPrint>false</prettyPrint>
- </jsonFormatter>
- </layout>
- </encoder>
- </appender>
-
- <root level="INFO">
- <appender-ref ref="LOG_FILE" />
- </root>
-
-</configuration></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>First you need to create a <code>logs</code> folder, then mount it to James container and to FluentBit.</p>
-</div>
-<div class="paragraph">
-<p>docker-compose:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>version: "3"
-
-services:
- james:
- depends_on:
- - elasticsearch
- - cassandra
- - rabbitmq
- - s3
- entrypoint: bash -c "java -cp 'james-server.jar:extension-jars/*:james-server-memory-guice.lib/*' -Dworking.directory=/root/ -Dlogback.configurationFile=/root/conf/logback.xml org.apache.james.CassandraRabbitMQJamesServerMain"
- image: linagora/james-rabbitmq-project:branch-master
- container_name: james
- hostname: james.local
- volumes:
- - ./extension-jars:/root/extension-jars
- - ./conf/logback.xml:/root/conf/logback.xml
- - ./logs:/root/logs
- ports:
- - "80:80"
- - "25:25"
- - "110:110"
- - "143:143"
- - "465:465"
- - "587:587"
- - "993:993"
- - "8080:8000"
-
- elasticsearch:
- image: docker.elastic.co/elasticsearch/elasticsearch:7.10.2
- ports:
- - "9200:9200"
- environment:
- - discovery.type=single-node
-
- cassandra:
- image: cassandra:4.1.3
- ports:
- - "9042:9042"
-
- rabbitmq:
- image: rabbitmq:3.12.1-management
- ports:
- - "5672:5672"
- - "15672:15672"
-
- s3:
- image: registry.scality.com/cloudserver/cloudserver:8.7.25
- container_name: s3.docker.test
- environment:
- - SCALITY_ACCESS_KEY_ID=accessKey1
- - SCALITY_SECRET_ACCESS_KEY=secretKey1
- - S3BACKEND=mem
- - LOG_LEVEL=trace
- - REMOTE_MANAGEMENT_DISABLE=1
-
- fluent-bit:
- image: fluent/fluent-bit:1.5.7
- volumes:
- - ./fluentbit/fluent-bit.conf:/fluent-bit/etc/fluent-bit.conf
- - ./fluentbit/parsers.conf:/fluent-bit/etc/parsers.conf
- - ./logs:/fluent-bit/log
- ports:
- - "24224:24224"
- - "24224:24224/udp"
- depends_on:
- - elasticsearch
-
- kibana:
- image: docker.elastic.co/kibana/kibana:7.10.2
- environment:
- ELASTICSEARCH_HOSTS: http://elasticsearch:9200
- ports:
- - "5601:5601"
- depends_on:
- - elasticsearch</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>FluentBit config as:
-the <code>Host elasticsearch</code> pointing to <code>elasticsearch</code> service in docker-compose file.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[SERVICE]
- Parsers_File /fluent-bit/etc/parsers.conf
-
-[INPUT]
- name tail
- path /fluent-bit/log/*.log
- Parser docker
- docker_mode on
- buffer_chunk_size 1MB
- buffer_max_size 1MB
- mem_buf_limit 64MB
- Refresh_Interval 30
-
-[OUTPUT]
- Name stdout
- Match *
-
-
-[OUTPUT]
- Name es
- Match *
- Host elasticsearch
- Port 9200
- Index fluentbit
- Logstash_Format On
- Logstash_Prefix fluentbit-james
- Type docker</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>FluentBit Parser config:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[PARSER]
- Name docker
- Format json
- Time_Key timestamp
- Time_Format %Y-%m-%dT%H:%M:%S.%LZ
- Time_Keep On
- Decode_Field_As escaped_utf8 log do_next
- Decode_Field_As escaped log do_next
- Decode_Field_As json log</pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_using_kubernetes"><a class="anchor" href="#_using_kubernetes"></a>Using Kubernetes</h4>
-<div class="paragraph">
-<p>If using James in a Kubernetes environment, you can just append the logs to the console in a JSON formatted way
-using Jackson to easily allow FluentBit to directly tail them.</p>
-</div>
-<div class="paragraph">
-<p>Here is a sample conf/logback.xml configuration file for achieving this:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><?xml version="1.0" encoding="UTF-8"?>
-<configuration>
-
- <contextListener class="ch.qos.logback.classic.jul.LevelChangePropagator">
- <resetJUL>true</resetJUL>
- </contextListener>
-
- <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
- <encoder class="ch.qos.logback.core.encoder.LayoutWrappingEncoder">
- <layout class="ch.qos.logback.contrib.json.classic.JsonLayout">
- <timestampFormat>yyyy-MM-dd'T'HH:mm:ss.SSSX</timestampFormat>
- <timestampFormatTimezoneId>Etc/UTC</timestampFormatTimezoneId>
-
- <!-- Importance for handling multiple lines log -->
- <appendLineSeparator>true</appendLineSeparator>
-
- <jsonFormatter class="ch.qos.logback.contrib.jackson.JacksonJsonFormatter">
- <prettyPrint>false</prettyPrint>
- </jsonFormatter>
- </layout>
- </encoder>
- </appender>
-
- <root level="INFO">
- <appender-ref ref="CONSOLE" />
- </root>
-
-</configuration></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Regarding FluentBit on Kubernetes, you need to install it as a DaemonSet. Some official template exist
-with FluentBit outputting logs to ElasticSearch. For more information on how to install it,
-with your cluster, you can look at this <a href="https://docs.fluentbit.io/manual/installation/kubernetes">documentation</a>.</p>
-</div>
-<div class="paragraph">
-<p>As stated by the <a href="https://docs.fluentbit.io/manual/installation/kubernetes#details">detail</a> of the
-official documentation, FluentBit is configured to consume out of the box logs from containers
-on the same running node. So it should scrap your James logs without extra configuration.</p>
-</div>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/operate/metrics.html b/james-distributed-app/3.8.1/operate/metrics.html
deleted file mode 100644
index c617363..0000000
--- a/james-distributed-app/3.8.1/operate/metrics.html
+++ /dev/null
@@ -1,739 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Metrics :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Operate</a></li>
- <li><a href="metrics.html">Metrics</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/operate/metrics.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Metrics</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>James relies on the <a href="https://metrics.dropwizard.io/4.1.2/manual/core.html">Dropwizard metric library</a>
-for keeping track of some core metrics of James.</p>
-</div>
-<div class="paragraph">
-<p>Such metrics are made available via JMX. You can connect for instance using VisualVM and the associated
-mbean plugins.</p>
-</div>
-<div class="paragraph">
-<p>We also support displaying them via <a href="https://grafana.com/">Grafana</a>. Two methods can be used to back grafana display:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Prometheus metric collection - Data are exposed on a HTTP endpoint for Prometheus scrape.</p>
-</li>
-<li>
-<p>ElasticSearch metric collection - This method is depreciated and will be removed in next version.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_expose_metrics_for_prometheus_collection"><a class="anchor" href="#_expose_metrics_for_prometheus_collection"></a>Expose metrics for Prometheus collection</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>To enable James metrics, add <code>extensions.routes</code> to <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/configure/webadmin.adoc">webadmin.properties</a> file:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">extensions.routes=org.apache.james.webadmin.dropwizard.MetricsRoutes</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Connect to james-admin url to test the result:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>http://james-admin-url/metrics</pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_configure_prometheus_data_source"><a class="anchor" href="#_configure_prometheus_data_source"></a>Configure Prometheus Data source</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>You need to set up <a href="https://prometheus.io/docs/prometheus/latest/getting_started/">Prometheus</a> first to scrape James metrics.<br>
-Add Apache James WebAdmin Url or IP address to <code>prometheus.yaml</code> configuration file:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>scrape_configs:
- # The job name is added as a label `job=<job_name>` to any timeseries scraped from this config.
- - job_name: 'WebAdmin url Example'
- scrape_interval: 5s
- metrics_path: /metrics
- static_configs:
- - targets: ['james-webamin-url']
- - job_name: 'WebAdmin IP Example'
- scrape_interval: 5s
- metrics_path: /metrics
- static_configs:
- - targets: ['192.168.100.10:8000']</pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_connect_prometheus_to_grafana"><a class="anchor" href="#_connect_prometheus_to_grafana"></a>Connect Prometheus to Grafana</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>You can do this either from <a href="https://prometheus.io/docs/visualization/grafana/">Grafana UI</a> or from a <a href="https://grafana.com/docs/grafana/latest/datasources/prometheus/">configuration file</a>.<br>
-The following <code>docker-compose.yaml</code> will help you install a simple Prometheus/ Grafana stack :</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">version: '3'
-#Metric monitoring
- grafana:
- image: grafana/grafana:latest
- container_name: grafana
- ports:
- - "3000:3000"
-
- prometheus:
- image: prom/prometheus:latest
- restart: unless-stopped
- ports:
- - "9090:9090"
- volumes:
- - ./conf/prometheus.yml:/etc/prometheus/prometheus.yml</code></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_getting_dashboards"><a class="anchor" href="#_getting_dashboards"></a>Getting dashboards</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Now that the Promtheus/Grafana servers are up, go to this <a href="https://github.com/apache/james-project/tree/master/server/grafana-reporting/prometheus-datasource/">link</a> to get all dashboards JSON file. Import the different JSON files in this directory to Grafana via UI.</p>
-</div>
-<div class="imageblock">
-<div class="content">
-<img src="../_images/preload-dashboards.png" alt="Pre-loaded dashboards">
-</div>
-</div>
-<div class="paragraph">
-<p>*Note: For communication between multiple docker-compose projects, see <a href="https://stackoverflow.com/questions/38088279/communication-between-multiple-docker-compose-projects">here</a> for example. An easier approach is to merge James and Metric docker-compose files together.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_available_metrics"><a class="anchor" href="#_available_metrics"></a>Available metrics</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Here are the available metrics :</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>James JVM metrics</p>
-</li>
-<li>
-<p>Number of active SMTP connections</p>
-</li>
-<li>
-<p>Number of SMTP commands received</p>
-</li>
-<li>
-<p>Number of active IMAP connections</p>
-</li>
-<li>
-<p>Number of IMAP commands received</p>
-</li>
-<li>
-<p>Number of active LMTP connections</p>
-</li>
-<li>
-<p>Number of LMTP commands received</p>
-</li>
-<li>
-<p>Number of per queue number of enqueued mails</p>
-</li>
-<li>
-<p>Number of sent emails</p>
-</li>
-<li>
-<p>Number of delivered emails</p>
-</li>
-<li>
-<p>Diverse Response time percentiles, counts and rates for JMAP</p>
-</li>
-<li>
-<p>Diverse Response time percentiles, counts and rates for IMAP</p>
-</li>
-<li>
-<p>Diverse Response time percentiles, counts and rates for SMTP</p>
-</li>
-<li>
-<p>Diverse Response time percentiles, counts and rates for WebAdmin</p>
-</li>
-<li>
-<p>Diverse Response time percentiles, counts and rates for each Mail Queue</p>
-</li>
-<li>
-<p>Per mailet and per matcher Response time percentiles</p>
-</li>
-<li>
-<p>Diverse Response time percentiles, counts and rates for DNS</p>
-</li>
-<li>
-<p>Cassandra Java driver metrics</p>
-</li>
-<li>
-<p>Tika HTTP client statistics</p>
-</li>
-<li>
-<p>SpamAssassin TCP client statistics</p>
-</li>
-<li>
-<p>Mailbox listeners statistics time percentiles</p>
-</li>
-<li>
-<p>Mailbox listeners statistics requests rate</p>
-</li>
-<li>
-<p>Pre-deletion hooks execution statistics time percentiles</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_available_grafana_boards"><a class="anchor" href="#_available_grafana_boards"></a>Available Grafana boards</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Here are the various relevant Grafana boards for the Distributed Server:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://github.com/apache/james-project/tree/master/server/grafana-reporting/prometheus-datasource/James_BlobStore.json">BlobStore</a> :
-Rates and percentiles for the BlobStore component</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/tree/master/server/grafana-reporting/prometheus-datasource/James_DNS_Dashboard.json">DNS</a> :
-Latencies and query counts for DNS resolution.</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/tree/master/server/grafana-reporting/prometheus-datasource/James_IMAP_Board.json">IMAP</a> :
-Latencies for the IMAP protocol</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/tree/master/server/grafana-reporting/prometheus-datasource/James_IMAP_CountBoard.json">IMAP counts</a> :
-Request counts for the IMAP protocol</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/tree/master/server/grafana-reporting/prometheus-datasource/James_JMAP_Board.json">JMAP</a> :
-Latencies for the JMAP protocol</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/tree/master/server/grafana-reporting/prometheus-datasource/James_JMAP_CountBoard.json">JMAP counts</a> :
-Request counts for the JMAP protocol</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/tree/master/server/grafana-reporting/prometheus-datasource/James_JVM.json">JVM</a> :
-JVM statistics (heap, gcs, etc…​)</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/tree/master/server/grafana-reporting/prometheus-datasource/James_MAILET.json">Mailets</a> :
-Per-mailet execution timings.</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/tree/master/server/grafana-reporting/prometheus-datasource/James_MATCHER.json">Matchers</a> :
-Per-matcher execution timings</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/tree/master/server/grafana-reporting/prometheus-datasource/James_MailQueue.json">MailQueue</a> :
-MailQueue statistics</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/tree/master/server/grafana-reporting/prometheus-datasource/James_SMTP_Board.json">SMTP</a> :
-SMTP latencies reports</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/tree/master/server/grafana-reporting/prometheus-datasource/James_SMTP_CountBoard.json">SMTP count</a> :
-Request count for the SMTP protocol</p>
-</li>
-</ul>
-</div>
-<div class="sect2">
-<h3 id="_dashboard_samples"><a class="anchor" href="#_dashboard_samples"></a>Dashboard samples</h3>
-<div class="paragraph">
-<p>Latencies for the JMAP protocol<br></p>
-</div>
-<div class="imageblock">
-<div class="content">
-<img src="../_images/JMAP_board.png" alt="JMAP">
-</div>
-</div>
-<div class="paragraph">
-<p>Latencies for the IMAP protocol<br></p>
-</div>
-<div class="imageblock">
-<div class="content">
-<img src="../_images/IMAP_board.png" alt="IMAP">
-</div>
-</div>
-<div class="paragraph">
-<p>JVM Statistics<br></p>
-</div>
-<div class="imageblock">
-<div class="content">
-<img src="../_images/JVM_board.png" alt="JVM">
-</div>
-</div>
-<div class="paragraph">
-<p>BlobStore Statistics<br></p>
-</div>
-<div class="imageblock">
-<div class="content">
-<img src="../_images/BlobStore.png" alt="BlobStore">
-</div>
-</div>
-<div class="paragraph">
-<p>webAdmin Statistics<br></p>
-</div>
-<div class="imageblock">
-<div class="content">
-<img src="../_images/webAdmin.png" alt="webAdmin">
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_expose_metrics_for_elasticsearch_collection"><a class="anchor" href="#_expose_metrics_for_elasticsearch_collection"></a>Expose metrics for Elasticsearch collection</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The following command allow you to run a fresh grafana server :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>docker run -i -p 3000:3000 grafana/grafana</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Once running, you need to set up an ElasticSearch data-source : - select
-proxy mode - Select version 2.x of ElasticSearch - make the URL point
-your ES node - Specify the index name. By default, it should be :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[james-metrics-]YYYY-MM</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Import the different dashboards you want.</p>
-</div>
-<div class="paragraph">
-<p>You then need to enable reporting through ElasticSearch. Modify your
-James ElasticSearch configuration file accordingly. To help you doing
-this, you can take a look to
-<a href="https://github.com/apache/james-project/blob/3.7.x/server/apps/distributed-app/sample-configuration/elasticsearch.properties">elasticsearch.properties</a>.</p>
-</div>
-<div class="paragraph">
-<p>If some metrics seem abnormally slow despite in depth database
-performance tuning, feedback is appreciated as well on the bug tracker,
-the user mailing list or our Gitter channel (see our
-<a href="http://james.apache.org/#second">community page</a>) . Any additional
-details categorizing the slowness are appreciated as well (details of
-the slow requests for instance).</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/operate/migrating.html b/james-distributed-app/3.8.1/operate/migrating.html
deleted file mode 100644
index f08b4b7..0000000
--- a/james-distributed-app/3.8.1/operate/migrating.html
+++ /dev/null
@@ -1,461 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Migrating existing data :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="metrics.html">Metrics</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Operate</a></li>
- <li><a href="migrating.html">Migrating existing data</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/operate/migrating.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Migrating existing data</h1>
-<div class="paragraph">
-<p>This page presents how operators can migrate your user mailbox and mails into the Distributed Server in order to adopt it.</p>
-</div>
-<div class="paragraph">
-<p>We assume you have a <a href="../configure/index.html" class="xref page">well configured</a> running Distributed server
-at hand. We also assume existing mails are hosted on a tier mail server which can be accessed via IMAP and supports
-impersonation.</p>
-</div>
-<div class="paragraph">
-<p>First, you want to create the domains handled by your server, as well as the users you will be hosting. This operation
-can be performed via WebAdmin or the CLI.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Using webadmin :</p>
-<div class="ulist">
-<ul>
-<li>
-<p>Read <a href="webadmin.html#_create_a_domain" class="xref page">this section</a> for creating domains</p>
-</li>
-<li>
-<p>Read <a href="webadmin.html#_create_a_user" class="xref page">this section</a> for creating users</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p>Using the CLI :</p>
-<div class="ulist">
-<ul>
-<li>
-<p>Read <a href="cli.html#_manage_domains" class="xref page">this section</a> for creating domains</p>
-</li>
-<li>
-<p>Read <a href="cli.html#_managing_users" class="xref page">this section</a> for creating users</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Second, you want to allow an administrator account of your Distributed Server to have write access on other user mailboxes.
-This can be setted up this the <strong>administratorId</strong> configuration option of the <a href="../configure/usersrepository.html" class="xref page">usersrepository.xml</a> configuration file.</p>
-</div>
-<div class="paragraph">
-<p>Then, it is time to run <a href="https://github.com/imapsync/imapsync">imapsync</a> script to copy the emails from the previous mail server
-into the Distributed Server. Here is an example migrating a single user, relying on impersonation:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>imapsync --host1 previous.server.domain.tld \
- --user1 user@domain.tld --authuser1 adminOldServer@domain.tld \
- --proxyauth1 --password1 passwordOfTheOldAdmin \
- --host2 distributed.james.domain.tld \
- --user2 use1@domain.tld \
- --authuser2 adminNewServer@domain.tld --proxyauth2 \
- --password2 passwordOfTheNewAdmin</pre>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/operate/performanceChecklist.html b/james-distributed-app/3.8.1/operate/performanceChecklist.html
deleted file mode 100644
index b136f47..0000000
--- a/james-distributed-app/3.8.1/operate/performanceChecklist.html
+++ /dev/null
@@ -1,639 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Performance checklist :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="guide.html">Operator guide</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Operate</a></li>
- <li><a href="performanceChecklist.html">Performance checklist</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/operate/performanceChecklist.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Performance checklist</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This guide aims to help James operators refine their James configuration and set up to achieve better performance.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_database_setup"><a class="anchor" href="#_database_setup"></a>Database setup</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Cassandra, OpenSearch, RabbitMQ is a large topic in itself that we do not intend to cover here. Yet, here are some
-very basic recommendation that are always beneficial to keep in mind.</p>
-</div>
-<div class="paragraph">
-<p>We recommend:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Running Cassandra, OpenSearch on commodity hardware with attached SSD. SAN disks are known to cause performance
-issues for these technologies. HDD disks are to be banned for these performance related applications.</p>
-</li>
-<li>
-<p>We recommend getting an Object Storage SaaS offering that suites your needs. Most generalist S3 offers will suite
-James needs.</p>
-</li>
-<li>
-<p>We do provide a guide on xref:[Database benchmarks] that can help identify and fix issues.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_james_configuration"><a class="anchor" href="#_james_configuration"></a>James configuration</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_cassandra"><a class="anchor" href="#_cassandra"></a>Cassandra</h3>
-<div class="paragraph">
-<p>People tunning for performance would likely accept relaxing their consistency needs. James allows doing this.</p>
-</div>
-<div class="paragraph">
-<p><strong>LightWeight Transactions (LWT)</strong> can be disabled where they are not essential. This can be done within
-xref:[cassandra.properties]:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>mailbox.read.strong.consistency=false
-message.read.strong.consistency=false
-message.write.strong.consistency.unsafe=false
-mailrepository.strong.consistency=false</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Also, James allows for <strong>Read repairs</strong> where consistency checks are piggy backed on reads randomly. This of course
-comes at a performance cost as it generates extre reads, thus minimizing read repair probability can help improving
-performance. This can be done within
-xref:[cassandra.properties]:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>mailbox.read.repair.chance=0.00
-mailbox.counters.read.repair.chance.max=0.000
-mailbox.counters.read.repair.chance.one.hundred=0.000</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>One can also avoid some Cassandra requests by disabling ACLs (meaning users will only access to the mailboxes they own,
-all mailbox-sharing features will thus not be achievable). This can be done within
-xref:[cassandra.properties]:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>acl.enabled=false</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Important settings in the `` file includes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Throttling: if too low then the Cassandra cluster is under-utilized. If too high, request bursts can cause significant
-Cassandra overload.</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> advanced.throttler {
- class = org.apache.james.backends.cassandra.utils.LockLessConcurrencyLimitingRequestThrottler
-
- max-queue-size = 10000
-
- max-concurrent-requests = 192
- }</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_object_storage"><a class="anchor" href="#_object_storage"></a>Object storage</h3>
-<div class="paragraph">
-<p>We recommend the use of the blob store cache, which will be populated by email headers which shall be treated as metadata.</p>
-</div>
-<div class="paragraph">
-<p><code>blob.properties</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>cache.enable=true
-cache.cassandra.ttl=1year
-cache.sizeThresholdInBytes=16 KiB</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_rabbitmq"><a class="anchor" href="#_rabbitmq"></a>RabbitMQ</h3>
-<div class="paragraph">
-<p>We recommend against the use of the CassandraMailQueueView, as browsing and advanced queue management features
-is unnecessary for Mail Delivery Agent and are not meaningful in the absence of delays.</p>
-</div>
-<div class="paragraph">
-<p>Similarly, we recommend turning off queue size metrics, which are expensive to compute.</p>
-</div>
-<div class="paragraph">
-<p>We also recommend against the use of publish confirms, which comes at a high performance price.</p>
-</div>
-<div class="paragraph">
-<p>In <code>rabbitmq.properties</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>cassandra.view.enabled=false
-
-mailqueue.size.metricsEnabled=false
-
-event.bus.publish.confirm.enabled=false
-mailqueue.publish.confirm.enabled=false</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_jmap_protocol"><a class="anchor" href="#_jmap_protocol"></a>JMAP protocol</h3>
-<div class="paragraph">
-<p>If you are not using JMAP, disabling it will avoid you the cost of populating related projections and thus is recommended.
-Within <code>jmap.properties</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>enabled=false</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>We recommend turning on EmailQueryView as it enables resolution of mailbox listing against Cassandra, thus unlocking massive
-stability / performance gains. Within <code>jmap.properties</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>view.email.query.enabled=true</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_imap_smtp"><a class="anchor" href="#_imap_smtp"></a>IMAP / SMTP</h3>
-<div class="paragraph">
-<p>We recommend against resolving client connection DNS names. This behaviour can be disabled via a system property within
-<code>jvm.properties</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>james.protocols.mdc.hostname=false</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Concurrent IMAP request count is the critical setting. In <code>imapServer.xml</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><concurrentRequests>200</concurrentRequests>
-<maxQueueSize>4096</maxQueueSize></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Other recommendation includes avoiding unecessary work upon IMAP IDLE, not starting dedicated BOSS threads:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><ignoreIDLEUponProcessing>false</ignoreIDLEUponProcessing>
-<bossWorkerCount>0</bossWorkerCount></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_other_generic_recommendations"><a class="anchor" href="#_other_generic_recommendations"></a>Other generic recommendations</h3>
-<div class="ulist">
-<ul>
-<li>
-<p>Remove unneeded listeners / mailets</p>
-</li>
-<li>
-<p>Reduce duplication of Matchers within mailetcontainer.xml</p>
-</li>
-<li>
-<p>Limit usage of "DEBUG" loglevel. INFO should be more than decent in most cases.</p>
-</li>
-<li>
-<p>While GC tunning is a science in itself, we had good results with G1GC and a low pause time:</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>-Xlog:gc*:file=/root/gc.log -XX:MaxGCPauseMillis=20 -XX:ParallelGCThreads=2</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>We recommand tunning bach sizes: <code>batchsizes.properties</code>. This allows, limiting parallel S3 reads, while loading many
-messages concurrently on Cassandra, and improves IMAP massive operations support.</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>fetch.metadata=200
-fetch.headers=30
-fetch.body=30
-fetch.full=30
-
-copy=8192
-
-move=8192</pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/operate/security.html b/james-distributed-app/3.8.1/operate/security.html
deleted file mode 100644
index 6049ddf..0000000
--- a/james-distributed-app/3.8.1/operate/security.html
+++ /dev/null
@@ -1,808 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Security checklist :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Operate</a></li>
- <li><a href="security.html">Security checklist</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/operate/security.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Security checklist</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This document aims as summarizing threats, security best practices as well as recommendations.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_threats"><a class="anchor" href="#_threats"></a>Threats</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Operating an email server exposes you to the following threats:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Spammers might attempt to use your servers to send their spam messages on their behalf. We speak of
-<strong>open relay</strong>. In addition to the resources consumed being an open relay will affect the trust other mail
-installations have in you, and thus will cause legitimate traffic to be rejected.</p>
-</li>
-<li>
-<p>Emails mostly consist of private data, which shall only be accessed by their legitimate user. Failure
-to do so might result in <strong>information disclosure</strong>.</p>
-</li>
-<li>
-<p><strong>Email forgery</strong>. An attacker might craft an email on the behalf of legitimate users.</p>
-</li>
-<li>
-<p>Email protocols allow user to authenticate and thus can be used as <strong>oracles</strong> to guess user passwords.</p>
-</li>
-<li>
-<p><strong>Spam</strong>. Non legitimate traffic can be a real burden to your users.</p>
-</li>
-<li>
-<p><strong>Phishing</strong>: Crafted emails that tricks the user into doing unintended actions.</p>
-</li>
-<li>
-<p><strong>Viruses</strong>: An attacker sends an attachment that contains an exploit that could run if a user opens it.</p>
-</li>
-<li>
-<p><strong>Denial of service</strong>: A small request may result in a very large response and require considerable work on the server…​</p>
-</li>
-<li>
-<p><strong>Denial of service</strong>: A malicious JMAP client may use the JMAP push subscription to attempt to flood a third party
-server with requests, creating a denial-of-service attack and masking the attacker’s true identity.</p>
-</li>
-<li>
-<p><strong>Dictionary Harvest Attacks</strong>: An attacker can rely on SMTP command reply code to know if a user exists or not. This
-can be used to obtain the list of local users and later use those address as targets for other attacks.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_best_practices"><a class="anchor" href="#_best_practices"></a>Best practices</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The following sections ranks best practices.</p>
-</div>
-<div class="sect2">
-<h3 id="_best_practices_must"><a class="anchor" href="#_best_practices_must"></a>Best practices: Must</h3>
-<div class="ulist">
-<ul>
-<li>
-<p>1. Configure James in order not to be an <a href="../configure/smtp.html#_about_open_relays" class="xref page">open relay</a>. This should be the
-case with the default configuration.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Be sure in <a href="../configure/smtp.html" class="xref page">smtpserver.xml</a> to activate the following options: <code>verifyIdentity</code>.</p>
-</div>
-<div class="paragraph">
-<p>We then recommend to manually test your installation in order to ensure that:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Unauthenticated SMTP users cannot send mails to external email addresses (they are not relayed)</p>
-</li>
-<li>
-<p>Unauthenticated SMTP users can send mails to internal email addresses</p>
-</li>
-<li>
-<p>Unauthenticated SMTP users cannot use local addresses in their mail from, and send emails both locally and to distant targets.</p>
-</li>
-<li>
-<p>2. Avoid <strong>STARTTLS</strong> usage and favor SSL. Upgrade from a non encrypted channel into an encrypted channel is an opportunity
-for additional vulnerabilities. This is easily prevented by requiring SSL connection upfront. <a href="https://nostarttls.secvuln.info/">Read more…​</a></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Please note that STARTTLS is still beneficial in the context of email relaying, which happens on SMTP port 25 unencrypted,
-and enable opportunistic encryption upgrades that would not overwise be possible. We recommend keeping STARTTLS activated
-for SMTP port 25.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>3. Use SSL for <a href="../configure/mailets.html#_remotedelivery" class="xref page">remote delivery</a> whenever you are using a gateway relaying SMTP server.</p>
-</li>
-<li>
-<p>4. Rely on an external identity service, dedicated to user credential storage. James supports <a href="../configure/usersrepository.html#_configuring_a_ldap" class="xref page">LDAP</a>. If you are
-forced to store users in James be sure to choose <code>PBKDF2</code> as a hashing algorithm. Also, delays on authentication failures
-are supported via the <code>verifyFailureDelay</code> property. Note that IMAP / SMTP connections are closed after 3 authentication
-failures.</p>
-</li>
-<li>
-<p>5. Ensure that <a href="../configure/webadmin.html" class="xref page">WebAdmin</a> is not exposed unencrypted to the outer world. Doing so trivially
-exposes yourself. You can either disable it, activate JWT security, or restrict it to listen only on localhost.</p>
-</li>
-<li>
-<p>6. Set up <code>HTTPS</code> for http based protocols, namely <strong>JMAP</strong> and <strong>WebAdmin</strong>. We recommend the use of a reverse proxy like Nginx.</p>
-</li>
-<li>
-<p>7. Set up <a href="https://james.apache.org/howTo/spf.html">SPF</a> and <a href="https://james.apache.org/howTo/dkim.html">DKIM</a>
-for your outgoing emails to be trusted.</p>
-</li>
-<li>
-<p>8. Prevent access to JMX. This can be achieved through a strict firewalling policy
-(<a href="https://nickbloor.co.uk/2017/10/22/analysis-of-cve-2017-12628/">blocking port 9999 is not enough</a>)
-or <a href="../configure/jmx.html" class="xref page">disabling JMX</a>. JMX is needed to use the existing CLI application but webadmin do offer similar
-features. Set the <code>jmx.remote.x.mlet.allow.getMBeansFromURL</code> to <code>false</code> to disable JMX remote code execution feature.</p>
-</li>
-<li>
-<p>9. If JMAP is enabled, be sure that JMAP PUSH cannot be used for server side request forgery. This can be
-<a href="../configure/jmap.html" class="xref page">configured</a> using the <code>push.prevent.server.side.request.forgery=true</code> property,
-forbidding push to private addresses.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_best_practice_should"><a class="anchor" href="#_best_practice_should"></a>Best practice: Should</h3>
-<div class="ulist">
-<ul>
-<li>
-<p>1. Avoid advertising login/authenticate capabilities in clear channels. This might prevent some clients to attempt login
-on clear channels, and can be configured for both <a href="../configure/smtp.html" class="xref page">SMTP</a> and <a href="../configure/imap.html" class="xref page">IMAP</a>
-using <code>auth.plainAuthEnabled=false</code>.</p>
-</li>
-<li>
-<p>2. Verify <a href="https://james.apache.org/howTo/spf.html">SPF</a> and <a href="../configure/mailets.html#_dkimverify" class="xref page">DKIM</a> for your incoming emails.</p>
-</li>
-<li>
-<p>3. Set up reasonable <a href="webadmin.html#_administrating_quotas" class="xref page">storage quota</a> for your users.</p>
-</li>
-<li>
-<p>4. We recommend setting up anti-spam and anti-virus solutions. James comes with some <a href="../configure/spam.html" class="xref page">Rspamd and SpamAssassin</a>
-integration, and some <a href="../configure/mailets.html#_clamavscan" class="xref page">ClamAV</a> tooling exists.
-Rspamd supports anti-phishing modules.
-Filtering with third party systems upstream is also possible.</p>
-</li>
-<li>
-<p>5. In order to limit your attack surface, disable protocols you or your users do not use. This includes the JMAP protocol,
-POP3, ManagedSieve, etc…​ Be conservative on what you expose.</p>
-</li>
-<li>
-<p>6. If operating behind a load-balancer, set up the <a href="https://www.haproxy.org/download/1.8/doc/proxy-protocol.txt">PROXY protocol</a> for
-TCP based protocols (IMAP and SMTP <code>proxyRequired</code> option)</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_best_practice_could"><a class="anchor" href="#_best_practice_could"></a>Best practice: Could</h3>
-<div class="ulist">
-<ul>
-<li>
-<p>1. Set up <a href="https://openid.net/connect/">OIDC</a> for IMAP, SMTP and JMAP. Disable login/plain/basic authentication.</p>
-</li>
-<li>
-<p>2. You can configure <a href="../configure/ssl.html#_client_authentication_via_certificates" class="xref page">Client authentication via certificates</a>.</p>
-</li>
-<li>
-<p>3. You can <a href="../configure/mailets.html#_smimesign" class="xref page">sign</a>, <a href="../configure/mailets.html#_smimechecksignature" class="xref page">verify</a>
-and <a href="../configure/mailets.html#_smimedecrypt" class="xref page">decrypt</a> your email traffic using <a href="https://datatracker.ietf.org/doc/html/rfc5751">SMIME</a>.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_known_vulnerabilities"><a class="anchor" href="#_known_vulnerabilities"></a>Known vulnerabilities</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Several vulnerabilities have had been reported for previous releases of Apache James server.</p>
-</div>
-<div class="paragraph">
-<p>Be sure not to run those! We highly recommend running the latest release, which we put great effort in not to use
-outdated dependencies.</p>
-</div>
-<div class="sect2">
-<h3 id="_reporting_vulnerabilities"><a class="anchor" href="#_reporting_vulnerabilities"></a>Reporting vulnerabilities</h3>
-<div class="paragraph">
-<p>We follow the standard procedures within the ASF regarding <a href="https://apache.org/security/committers.html#vulnerability-handling">vulnerability handling</a></p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_cve_2024_21742_mime4j_dom_header_injection"><a class="anchor" href="#_cve_2024_21742_mime4j_dom_header_injection"></a>CVE-2024-21742: Mime4J DOM header injection</h3>
-<div class="paragraph">
-<p>Apache JAMES MIME4J prior to version 0.8.10 allow attackers able to specify the value of a header field to craft other header fields.</p>
-</div>
-<div class="paragraph">
-<p><strong>Severity</strong>: Moderate</p>
-</div>
-<div class="paragraph">
-<p><strong>Mitigation</strong>: Release 0.8.10 rejects the use of LF inside a header field thus preventing the issue.</p>
-</div>
-<div class="paragraph">
-<p>Upgrading to Apache James MIME4J 0.8.10 is thus advised.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_cve_2023_51747_smtp_smuggling_in_apache_james"><a class="anchor" href="#_cve_2023_51747_smtp_smuggling_in_apache_james"></a>CVE-2023-51747: SMTP smuggling in Apache James</h3>
-<div class="paragraph">
-<p>Apache James distribution prior to release 3.7.5 and release 3.8.1 is subject to SMTP smuggling, when used in combination
-of antother vulnerable server and can result in SPF bypass, leading to email forgery.</p>
-</div>
-<div class="paragraph">
-<p><strong>Severity</strong>: High</p>
-</div>
-<div class="paragraph">
-<p><strong>Mitigation</strong>: Release 3.7.5 and 3.8.1 interpret strictly the CRLF delimiter and thus prevent the issue.</p>
-</div>
-<div class="paragraph">
-<p>Upgrading to Apache James 3.7.5 or 3.8.1 is thus advised.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_cve_2023_51518_privilege_escalation_via_jmx_pre_authentication_deserialisation"><a class="anchor" href="#_cve_2023_51518_privilege_escalation_via_jmx_pre_authentication_deserialisation"></a>CVE-2023-51518: Privilege escalation via JMX pre-authentication deserialisation</h3>
-<div class="paragraph">
-<p>Apache James distribution prior to release 3.7.5 and 3.8.1 allow privilege escalation via JMX pre-authentication deserialisation.
-An attacker would need to identify a deserialization glitch before triggering an exploit.</p>
-</div>
-<div class="paragraph">
-<p><strong>Severity</strong>: Moderate</p>
-</div>
-<div class="paragraph">
-<p><strong>Mitigation</strong>:We recommend turning off JMX whenever possible.</p>
-</div>
-<div class="paragraph">
-<p>Release 3.7.5 and 3.8.1 disable deserialization on unauthencited channels.</p>
-</div>
-<div class="paragraph">
-<p>Upgrading to Apache James 3.7.5 on 3.8.1 is thus advised.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_cve_2023_26269_privilege_escalation_through_unauthenticated_jmx"><a class="anchor" href="#_cve_2023_26269_privilege_escalation_through_unauthenticated_jmx"></a>CVE-2023-26269: Privilege escalation through unauthenticated JMX</h3>
-<div class="paragraph">
-<p>Apache James distribution prior to release 3.7.4 allows privilege escalation through the use of JMX.</p>
-</div>
-<div class="paragraph">
-<p><strong>Severity</strong>: Moderate</p>
-</div>
-<div class="paragraph">
-<p><strong>Mitigation</strong>: We recommend turning on authentication on. If the CLI is unused we recommend turning JMX off.</p>
-</div>
-<div class="paragraph">
-<p>Release 3.7.4 set up implicitly JMX authentication for Guice based products and addresses the underlying JMX exploits.</p>
-</div>
-<div class="paragraph">
-<p>Upgrading to Apache James 3.7.4 is thus advised.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_cve_2022_45935_temporary_file_information_disclosure_in_apache_james"><a class="anchor" href="#_cve_2022_45935_temporary_file_information_disclosure_in_apache_james"></a>CVE-2022-45935: Temporary File Information Disclosure in Apache JAMES</h3>
-<div class="paragraph">
-<p>Apache James distribution prior to release 3.7.3 is vulnerable to a temporary File Information Disclosure.</p>
-</div>
-<div class="paragraph">
-<p><strong>Severity</strong>: Moderate</p>
-</div>
-<div class="paragraph">
-<p><strong>Mitigation</strong>: We recommend to upgrade to Apache James 3.7.3 or higher, which fixes this vulnerability.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_cve_2021_44228_starttls_command_injection_in_apache_james"><a class="anchor" href="#_cve_2021_44228_starttls_command_injection_in_apache_james"></a>CVE-2021-44228: STARTTLS command injection in Apache JAMES</h3>
-<div class="paragraph">
-<p>Apache James distribution prior to release 3.7.1 is vulnerable to a buffering attack relying on the use of the STARTTLS command.</p>
-</div>
-<div class="paragraph">
-<p>Fix of CVE-2021-38542, which solved similar problem from Apache James 3.6.1, is subject to a parser differential and do not take into account concurrent requests.</p>
-</div>
-<div class="paragraph">
-<p><strong>Severity</strong>: Moderate</p>
-</div>
-<div class="paragraph">
-<p><strong>Mitigation</strong>: We recommend to upgrade to Apache James 3.7.1 or higher, which fixes this vulnerability.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_cve_2021_38542_apache_james_vulnerable_to_starttls_command_injection_imap_and_pop3"><a class="anchor" href="#_cve_2021_38542_apache_james_vulnerable_to_starttls_command_injection_imap_and_pop3"></a>CVE-2021-38542: Apache James vulnerable to STARTTLS command injection (IMAP and POP3)</h3>
-<div class="paragraph">
-<p>Apache James prior to release 3.6.1 is vulnerable to a buffering attack relying on the use of the STARTTLS
-command. This can result in Man-in -the-middle command injection attacks, leading potentially to leakage
-of sensible information.</p>
-</div>
-<div class="paragraph">
-<p><strong>Severity</strong>: Moderate</p>
-</div>
-<div class="paragraph">
-<p>This issue is being tracked as <a href="https://issues.apache.org/jira/browse/JAMES-1862">JAMES-1862</a></p>
-</div>
-<div class="paragraph">
-<p><strong>Mitigation</strong>: We recommend upgrading to Apache James 3.6.1, which fixes this vulnerability.</p>
-</div>
-<div class="paragraph">
-<p>Furthermore, we recommend, if possible to dis-activate STARTTLS and rely solely on explicit TLS for mail protocols, including SMTP, IMAP and POP3.</p>
-</div>
-<div class="paragraph">
-<p>Read more <a href="https://nostarttls.secvuln.info/">about STARTTLS security here</a>.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_cve_2021_40110_apache_james_imap_vulnerable_to_a_redos"><a class="anchor" href="#_cve_2021_40110_apache_james_imap_vulnerable_to_a_redos"></a>CVE-2021-40110: Apache James IMAP vulnerable to a ReDoS</h3>
-<div class="paragraph">
-<p>Using Jazzer fuzzer, we identified that an IMAP user can craft IMAP LIST commands to orchestrate a Denial
-Of Service using a vulnerable Regular expression. This affected Apache James prior to 3.6.1</p>
-</div>
-<div class="paragraph">
-<p><strong>Severity</strong>: Moderate</p>
-</div>
-<div class="paragraph">
-<p>This issue is being tracked as <a href="https://issues.apache.org/jira/browse/JAMES-3635">JAMES-3635</a></p>
-</div>
-<div class="paragraph">
-<p><strong>Mitigation</strong>: We recommend upgrading to Apache James 3.6.1, which enforce the use of RE2J regular
-expression engine to execute regex in linear time without back-tracking.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_cve_2021_40111_apache_james_imap_parsing_denial_of_service"><a class="anchor" href="#_cve_2021_40111_apache_james_imap_parsing_denial_of_service"></a>CVE-2021-40111: Apache James IMAP parsing Denial Of Service</h3>
-<div class="paragraph">
-<p>While fuzzing with Jazzer the IMAP parsing stack we discover that crafted APPEND and STATUS IMAP command
-could be used to trigger infinite loops resulting in expensive CPU computations and OutOfMemory exceptions.
-This can be used for a Denial Of Service attack. The IMAP user needs to be authenticated to exploit this
-vulnerability. This affected Apache James prior to version 3.6.1.</p>
-</div>
-<div class="paragraph">
-<p><strong>Severity</strong>: Moderate</p>
-</div>
-<div class="paragraph">
-<p>This issue is being tracked as <a href="https://issues.apache.org/jira/browse/JAMES-3634">JAMES-3634</a></p>
-</div>
-<div class="paragraph">
-<p><strong>Mitigation</strong>: We recommend upgrading to Apache James 3.6.1, which fixes this vulnerability.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_cve_2021_40525_apache_james_sieve_file_storage_vulnerable_to_path_traversal_attacks"><a class="anchor" href="#_cve_2021_40525_apache_james_sieve_file_storage_vulnerable_to_path_traversal_attacks"></a>CVE-2021-40525: Apache James: Sieve file storage vulnerable to path traversal attacks</h3>
-<div class="paragraph">
-<p>Apache James ManagedSieve implementation alongside with the file storage for sieve scripts is vulnerable
-to path traversal, allowing reading and writing any file.</p>
-</div>
-<div class="paragraph">
-<p><strong>Severity</strong>: Moderate</p>
-</div>
-<div class="paragraph">
-<p>This issue is being tracked as <a href="https://issues.apache.org/jira/browse/JAMES-3646">JAMES-3646</a></p>
-</div>
-<div class="paragraph">
-<p><strong>Mitigation</strong>:This vulnerability had been patched in Apache James 3.6.1 and higher. We recommend the upgrade.</p>
-</div>
-<div class="paragraph">
-<p>This could also be mitigated by ensuring manageSieve is disabled, which is the case by default.</p>
-</div>
-<div class="paragraph">
-<p>Distributed and Cassandra based products are also not impacted.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_cve_2017_12628_privilege_escalation_using_jmx"><a class="anchor" href="#_cve_2017_12628_privilege_escalation_using_jmx"></a>CVE-2017-12628 Privilege escalation using JMX</h3>
-<div class="paragraph">
-<p>The Apache James Server prior version 3.0.1 is vulnerable to Java deserialization issues.
-One can use this for privilege escalation.
-This issue can be mitigated by:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Upgrading to James 3.0.1 onward</p>
-</li>
-<li>
-<p>Using a recent JRE (Exploit could not be reproduced on OpenJdk 8 u141)</p>
-</li>
-<li>
-<p>Exposing JMX socket only to localhost (default behaviour)</p>
-</li>
-<li>
-<p>Possibly running James in a container</p>
-</li>
-<li>
-<p>Disabling JMX all-together (Guice only)</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Read more <a href="http://james.apache.org//james/update/2017/10/20/james-3.0.1.html">here</a>.</p>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/operate/webadmin.html b/james-distributed-app/3.8.1/operate/webadmin.html
deleted file mode 100644
index d04830f..0000000
--- a/james-distributed-app/3.8.1/operate/webadmin.html
+++ /dev/null
@@ -1,8354 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — WebAdmin REST administration API :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run/run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../run/run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../run/k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="logging.html">Logging</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Operate</a></li>
- <li><a href="webadmin.html">WebAdmin REST administration API</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/operate/webadmin.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — WebAdmin REST administration API</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>The web administration supports for now the CRUD operations on the domains, the users, their mailboxes and their quotas,
- managing mail repositories, performing cassandra migrations, and much more, as described in the following sections.</p>
-</div>
-<div class="paragraph">
-<p><strong>WARNING</strong>: 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>
-</div>
-<div class="paragraph">
-<p>By the way, some endpoints are not filtered by authentication. Those endpoints are not related to data stored in James,
-for example: Swagger documentation & James health checks.</p>
-</div>
-<div class="paragraph">
-<p>In case of any error, the system will return an error message which is
-json format like this:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- statusCode: <error_code>,
- type: <error_type>,
- message: <the_error_message>
- cause: <the_detail_message_from_throwable>
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Also be aware that, in case things go wrong, all endpoints might return
-a 500 internal error (with a JSON body formatted as exposed above). To
-avoid information duplication, this is omitted on endpoint specific
-documentation.</p>
-</div>
-<div class="paragraph">
-<p>Finally, please note that in case of a malformed URL the 400 bad request
-response will contain an HTML body.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_healthcheck"><a class="anchor" href="#_healthcheck"></a>HealthCheck</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_check_all_components"><a class="anchor" href="#_check_all_components"></a>Check all components</h3>
-<div class="paragraph">
-<p>This endpoint is simple for now and is just returning the http status
-code corresponding to the state of checks (see below). The user has to
-check in the logs in order to have more information about failing
-checks.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/healthcheck</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return a list of healthChecks execution result, with an aggregated
-result:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "status": "healthy",
- "checks": [
- {
- "componentName": "Cassandra backend",
- "escapedComponentName": "Cassandra%20backend",
- "status": "healthy"
- "cause": null
- }
- ]
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>status</strong> field can be:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>healthy</strong>: Component works normally</p>
-</li>
-<li>
-<p><strong>degraded</strong>: Component works in degraded mode. Some non-critical
-services may not be working, or latencies are high, for example. Cause
-contains explanations.</p>
-</li>
-<li>
-<p><strong>unhealthy</strong>: The component is currently not working. Cause contains
-explanations.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Supported health checks include:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>Cassandra backend</strong>: Cassandra storage.</p>
-</li>
-<li>
-<p><strong>OpenSearch Backend</strong>: OpenSearch storage.</p>
-</li>
-<li>
-<p><strong>EventDeadLettersHealthCheck</strong></p>
-</li>
-<li>
-<p><strong>Guice application lifecycle</strong></p>
-</li>
-<li>
-<p><strong>JPA Backend</strong>: JPA storage.</p>
-</li>
-<li>
-<p><strong>MailReceptionCheck</strong> We rely on a configured user, send an email to him and
-assert that the email is well received, and can be read within the given configured
-period. Unhealthy means that the email could not be received before reacing the timeout.</p>
-</li>
-<li>
-<p><strong>MessageFastViewProjection</strong> Health check of the component storing JMAP properties
-which are fast to retrieve. Those properties are computed in advance
-from messages and persisted in order to archive a better performance.
-There are some latencies between a source update and its projections
-updates. Incoherency problems arise when reads are performed in this
-time-window. We piggyback the projection update on missed JMAP read in
-order to decrease the outdated time window for a given entry. The health
-is determined by the ratio of missed projection reads. (lower than 10%
-causes <code>degraded</code>)</p>
-</li>
-<li>
-<p><strong>RabbitMQ backend</strong>: RabbitMQ messaging.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: All checks have answered with a Healthy or Degraded status. James
-services can still be used.</p>
-</li>
-<li>
-<p>503: At least one check have answered with a Unhealthy status</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_check_single_component"><a class="anchor" href="#_check_single_component"></a>Check single component</h3>
-<div class="paragraph">
-<p>Performs a health check for the given component. The component is
-referenced by its URL encoded name.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/healthcheck/checks/Cassandra%20backend</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the component’s name, the component’s escaped name, the
-health status and a cause.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "componentName": "Cassandra backend",
- "escapedComponentName": "Cassandra%20backend",
- "status": "healthy"
- "cause": null
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The check has answered with a Healthy or Degraded status.</p>
-</li>
-<li>
-<p>404: A component with the given name was not found.</p>
-</li>
-<li>
-<p>503: The check has answered with an Unhealthy status.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_list_all_health_checks"><a class="anchor" href="#_list_all_health_checks"></a>List all health checks</h3>
-<div class="paragraph">
-<p>This endpoint lists all the available health checks.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/healthcheck/checks</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the list of all available health checks.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[
- {
- "componentName": "Cassandra backend",
- "escapedComponentName": "Cassandra%20backend"
- }
-]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: List of available health checks</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_task_management"><a class="anchor" href="#_task_management"></a>Task management</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Some webadmin features schedule tasks. The task management API allow to
-monitor and manage the execution of the following tasks.</p>
-</div>
-<div class="paragraph">
-<p>Note that the <code>taskId</code> used in the following APIs is returned by other
-WebAdmin APIs scheduling tasks.</p>
-</div>
-<div class="sect2">
-<h3 id="_getting_a_task_details"><a class="anchor" href="#_getting_a_task_details"></a>Getting a task details</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/tasks/3294a976-ce63-491e-bd52-1b6f465ed7a2</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>An Execution Report will be returned:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<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": "type-of-the-task"
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note that:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>status</code> can have the value:</p>
-<div class="ulist">
-<ul>
-<li>
-<p><code>waiting</code>: The task is scheduled but its execution did not start yet</p>
-</li>
-<li>
-<p><code>inProgress</code>: The task is currently executed</p>
-</li>
-<li>
-<p><code>cancelled</code>: The task had been cancelled</p>
-</li>
-<li>
-<p><code>completed</code>: The task execution is finished, and this execution is a
-success</p>
-</li>
-<li>
-<p><code>failed</code>: The task execution is finished, and this execution is a
-failure</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p><code>additionalInformation</code> is a task specific object giving additional
-information and context about that task. The structure of this
-<code>additionalInformation</code> field is provided along the specific task
-submission endpoint.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The specific task was found and the execution report exposed
-above is returned</p>
-</li>
-<li>
-<p>400: Invalid task ID</p>
-</li>
-<li>
-<p>404: Task ID was not found</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_awaiting_a_task"><a class="anchor" href="#_awaiting_a_task"></a>Awaiting a task</h3>
-<div class="paragraph">
-<p>One can await the end of a task, then receive its final execution
-report.</p>
-</div>
-<div class="paragraph">
-<p>That feature is especially usefully for testing purpose but still can
-serve real-life scenario.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/tasks/3294a976-ce63-491e-bd52-1b6f465ed7a2/await?timeout=duration</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>An Execution Report will be returned.</p>
-</div>
-<div class="paragraph">
-<p><code>timeout</code> is optional. By default it is set to 365 days (the maximum
-value). The expected value is expressed in the following format:
-<code>Nunit</code>. <code>N</code> should be strictly positive. <code>unit</code> could be either in the
-short form (<code>s</code>, <code>m</code>, <code>h</code>, etc.), or in the long form (<code>day</code>, <code>week</code>,
-<code>month</code>, etc.).</p>
-</div>
-<div class="paragraph">
-<p>Examples:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>30s</code></p>
-</li>
-<li>
-<p><code>5m</code></p>
-</li>
-<li>
-<p><code>7d</code></p>
-</li>
-<li>
-<p><code>1y</code></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The specific task was found and the execution report exposed
-above is returned</p>
-</li>
-<li>
-<p>400: Invalid task ID or invalid timeout</p>
-</li>
-<li>
-<p>404: Task ID was not found</p>
-</li>
-<li>
-<p>408: The timeout has been reached</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_cancelling_a_task"><a class="anchor" href="#_cancelling_a_task"></a>Cancelling a task</h3>
-<div class="paragraph">
-<p>You can cancel a task by calling:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/tasks/3294a976-ce63-491e-bd52-1b6f465ed7a2</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Task had been cancelled</p>
-</li>
-<li>
-<p>400: Invalid task ID</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_listing_tasks"><a class="anchor" href="#_listing_tasks"></a>Listing tasks</h3>
-<div class="paragraph">
-<p>A list of all tasks can be retrieved:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/tasks</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return a list of Execution reports</p>
-</div>
-<div class="paragraph">
-<p>One can filter the above results by status. For example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/tasks?status=inProgress</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return a list of Execution reports that are currently in progress. This list is sorted by
-reverse submitted date (recent tasks goes first).</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: A list of corresponding tasks is returned</p>
-</li>
-<li>
-<p>400: Invalid status value</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Additional optional task parameters are supported:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>status</code> one of <code>waiting</code>, <code>inProgress</code>, <code>canceledRequested</code>, <code>completed</code>, <code>canceled</code>, <code>failed</code>. Only
-tasks with the given status are returned.</p>
-</li>
-<li>
-<p><code>type</code>: only tasks with the given type are returned.</p>
-</li>
-<li>
-<p><code>submittedBefore</code>: Date. Returns only tasks submitted before this date.</p>
-</li>
-<li>
-<p><code>submittedAfter</code>: Date. Returns only tasks submitted after this date.</p>
-</li>
-<li>
-<p><code>startedBefore</code>: Date. Returns only tasks started before this date.</p>
-</li>
-<li>
-<p><code>startedAfter</code>: Date. Returns only tasks started after this date.</p>
-</li>
-<li>
-<p><code>completedBefore</code>: Date. Returns only tasks completed before this date.</p>
-</li>
-<li>
-<p><code>completedAfter</code>: Date. Returns only tasks completed after this date.</p>
-</li>
-<li>
-<p><code>failedBefore</code>: Date. Returns only tasks failed before this date.</p>
-</li>
-<li>
-<p><code>failedAfter</code>: Date. Returns only tasks faield after this date.</p>
-</li>
-<li>
-<p><code>offset</code>: Integer, number of tasks to skip in the response. Useful for paging.</p>
-</li>
-<li>
-<p><code>limit</code>: Integer, maximum number of tasks to return in one call</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Example of date format: <code>2023-04-15T07:23:27.541254+07:00</code> and <code>2023-04-15T07%3A23%3A27.541254%2B07%3A00</code> once URL encoded.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_endpoints_returning_a_task"><a class="anchor" href="#_endpoints_returning_a_task"></a>Endpoints returning a task</h3>
-<div class="paragraph">
-<p>Many endpoints do generate a task.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /endpoint?action={action}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The response to these requests will be the scheduled <code>taskId</code> :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"taskId":"5641376-02ed-47bd-bcc7-76ff6262d92a"}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Positionned headers:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Location header indicates the location of the resource associated with
-the scheduled task. Example:</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>Location: /tasks/3294a976-ce63-491e-bd52-1b6f465ed7a2</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Task generation succeeded. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>Other response codes might be returned depending on the endpoint</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The additional information returned depends on the scheduled task type
-and is documented in the endpoint documentation.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_administrating_domains"><a class="anchor" href="#_administrating_domains"></a>Administrating domains</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_create_a_domain"><a class="anchor" href="#_create_a_domain"></a>Create a domain</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/domains/domainToBeCreated</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name domainToBeCreated:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>can not be null or empty</p>
-</li>
-<li>
-<p>can not contain `@'</p>
-</li>
-<li>
-<p>can not be more than 255 characters</p>
-</li>
-<li>
-<p>can not contain `/'</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The domain was successfully added</p>
-</li>
-<li>
-<p>400: The domain name is invalid</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_delete_a_domain"><a class="anchor" href="#_delete_a_domain"></a>Delete a domain</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/domains/{domainToBeDeleted}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note: Deletion of an auto-detected domain, default domain or of an
-auto-detected ip is not supported. We encourage you instead to review
-your <a href="https://james.apache.org/server/config-domainlist.html">domain list
-configuration</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The domain was successfully removed</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_test_if_a_domain_exists"><a class="anchor" href="#_test_if_a_domain_exists"></a>Test if a domain exists</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/domains/{domainName}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The domain exists</p>
-</li>
-<li>
-<p>404: The domain does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_get_the_list_of_domains"><a class="anchor" href="#_get_the_list_of_domains"></a>Get the list of domains</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/domains</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Possible response:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>["domain1", "domain2"]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The domain list was successfully retrieved</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_get_the_list_of_aliases_for_a_domain"><a class="anchor" href="#_get_the_list_of_aliases_for_a_domain"></a>Get the list of aliases for a domain</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/domains/destination.domain.tld/aliases</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Possible response:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[
- {"source": "source1.domain.tld"},
- {"source": "source2.domain.tld"}
-]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>When sending an email to an email address having <code>source1.domain.tld</code> or
-<code>source2.domain.tld</code> as a domain part (example:
-<code>user@source1.domain.tld</code>), then the domain part will be rewritten into
-destination.domain.tld (so into <code>user@destination.domain.tld</code>).</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The domain aliases was successfully retrieved</p>
-</li>
-<li>
-<p>400: destination.domain.tld has an invalid syntax</p>
-</li>
-<li>
-<p>404: destination.domain.tld is not part of handled domains and does
-not have local domains as aliases.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_create_an_alias_for_a_domain"><a class="anchor" href="#_create_an_alias_for_a_domain"></a>Create an alias for a domain</h3>
-<div class="paragraph">
-<p>To create a domain alias execute the following query:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/domains/destination.domain.tld/aliases/source.domain.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>When sending an email to an email address having <code>source.domain.tld</code> as
-a domain part (example: <code>user@source.domain.tld</code>), then the domain part
-will be rewritten into <code>destination.domain.tld</code> (so into
-<code>user@destination.domain.tld</code>).</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The redirection now exists</p>
-</li>
-<li>
-<p>400: <code>source.domain.tld</code> or <code>destination.domain.tld</code> have an invalid
-syntax</p>
-</li>
-<li>
-<p>400: <code>source, domain</code> and <code>destination domain</code> are the same</p>
-</li>
-<li>
-<p>404: <code>source.domain.tld</code> are not part of handled domains.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Be aware that no checks to find possible loops that would result of this creation will be performed.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_delete_an_alias_for_a_domain"><a class="anchor" href="#_delete_an_alias_for_a_domain"></a>Delete an alias for a domain</h3>
-<div class="paragraph">
-<p>To delete a domain alias execute the following query:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/domains/destination.domain.tld/aliases/source.domain.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>When sending an email to an email address having <code>source.domain.tld</code> as
-a domain part (example: <code>user@source.domain.tld</code>), then the domain part
-will be rewritten into <code>destination.domain.tld</code> (so into
-<code>user@destination.domain.tld</code>).</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The redirection now no longer exists</p>
-</li>
-<li>
-<p>400: <code>source.domain.tld</code> or destination.domain.tld have an invalid
-syntax</p>
-</li>
-<li>
-<p>400: source, domain and destination domain are the same</p>
-</li>
-<li>
-<p>404: <code>source.domain.tld</code> are not part of handled domains.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_delete_all_users_data_of_a_domain"><a class="anchor" href="#_delete_all_users_data_of_a_domain"></a>Delete all users data of a domain</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/domains/{domainToBeUsed}?action=deleteData</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Would create a task that deletes data of all users of the domain.</p>
-</div>
-<div class="paragraph">
-<p>[More details about endpoints returning a task](#_endpoints_returning_a_task).</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Error in the request. Details can be found in the reported error.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>DeleteUsersDataOfDomainTask</code> and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type": "DeleteUsersDataOfDomainTask",
- "domain": "domain.tld",
- "successfulUsersCount": 2,
- "failedUsersCount": 1,
- "failedUsers": ["faileduser@domain.tld"],
- "timestamp": "2023-05-22T08:52:47.076261Z"
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Notes: <code>failedUsers</code> only lists maximum 100 failed users.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_administrating_users"><a class="anchor" href="#_administrating_users"></a>Administrating users</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_create_a_user"><a class="anchor" href="#_create_a_user"></a>Create a user</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/users/usernameToBeUsed \
- -d '{"password":"passwordToBeUsed"}' \
- -H "Content-Type: application/json"</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name usernameToBeUsed representing valid users, hence it should
-match the criteria at <a href="../configure/usersrepository.html" class="xref page">User Repositories documentation</a></p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The user was successfully created</p>
-</li>
-<li>
-<p>400: The user name or the payload is invalid</p>
-</li>
-<li>
-<p>409: The user name already exists</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Note: If the user exists already, its password cannot be updated using this.
-If you want to update a user’s password, please have a look at <strong>Update a user password</strong> below.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_updating_a_user_password"><a class="anchor" href="#_updating_a_user_password"></a>Updating a user password</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/users/usernameToBeUsed?force \
- -d '{"password":"passwordToBeUsed"}' \
- -H "Content-Type: application/json"</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The user’s password was successfully updated</p>
-</li>
-<li>
-<p>400: The user name or the payload is invalid</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This also can be used to create a new user.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_verifying_a_user_password"><a class="anchor" href="#_verifying_a_user_password"></a>Verifying a user password</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/users/usernameToBeUsed/verify \
- -d '{"password":"passwordToBeVerified"}' \
- -H "Content-Type: application/json"</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The user’s password was correct</p>
-</li>
-<li>
-<p>401: Wrong password or user does not exist</p>
-</li>
-<li>
-<p>400: The user name or the payload is invalid</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This intentionally treats non-existing users as unauthenticated, to prevent a username oracle attack.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_testing_a_user_existence"><a class="anchor" href="#_testing_a_user_existence"></a>Testing a user existence</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XHEAD http://ip:port/users/usernameToBeUsed</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name ``usernameToBeUsed'' represents a valid user, hence it
-should match the criteria at <a href="../configure/usersrepository.html" class="xref page">User Repositories documentation</a></p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The user exists</p>
-</li>
-<li>
-<p>400: The user name is invalid</p>
-</li>
-<li>
-<p>404: The user does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_deleting_a_user"><a class="anchor" href="#_deleting_a_user"></a>Deleting a user</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/users/{userToBeDeleted}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The user was successfully deleted</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_retrieving_the_user_list"><a class="anchor" href="#_retrieving_the_user_list"></a>Retrieving the user list</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/users</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[{"username":"username@domain-jmapauthentication.tld"},{"username":"username@domain.tld"}]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The user name list was successfully retrieved</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_retrieving_the_list_of_allowed_from_headers_for_a_given_user"><a class="anchor" href="#_retrieving_the_list_of_allowed_from_headers_for_a_given_user"></a>Retrieving the list of allowed <code>From</code> headers for a given user</h3>
-<div class="paragraph">
-<p>This endpoint allows to know which From headers a given user is allowed to use when sending mails.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/users/givenUser/allowedFromHeaders</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>["user@domain.tld","alias@domain.tld"]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The list was successfully retrieved</p>
-</li>
-<li>
-<p>400: The user is invalid</p>
-</li>
-<li>
-<p>404: The user is unknown</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_add_a_delegated_user_of_a_base_user"><a class="anchor" href="#_add_a_delegated_user_of_a_base_user"></a>Add a delegated user of a base user</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/users/baseUser/authorizedUsers/delegatedUser</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Addition of the delegated user succeeded</p>
-</li>
-<li>
-<p>404: The base user does not exist</p>
-</li>
-<li>
-<p>400: The delegated user does not exist</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Note: Delegation is only available on top of Cassandra products and not implemented yet on top of JPA backends.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_remove_a_delegated_user_of_a_base_user"><a class="anchor" href="#_remove_a_delegated_user_of_a_base_user"></a>Remove a delegated user of a base user</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/users/baseUser/authorizedUsers/delegatedUser</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Removal of the delegated user succeeded</p>
-</li>
-<li>
-<p>404: The base user does not exist</p>
-</li>
-<li>
-<p>400: The delegated user does not exist</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Note: Delegation is only available on top of Cassandra products and not implemented yet on top of JPA backends.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_retrieving_the_list_of_delegated_users_of_a_base_user"><a class="anchor" href="#_retrieving_the_list_of_delegated_users_of_a_base_user"></a>Retrieving the list of delegated users of a base user</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/users/baseUser/authorizedUsers</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>["alice@domain.tld","bob@domain.tld"]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The list was successfully retrieved</p>
-</li>
-<li>
-<p>404: The base user does not exist</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Note: Delegation is only available on top of Cassandra products and not implemented yet on top of JPA backends.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_remove_all_delegated_users_of_a_base_user"><a class="anchor" href="#_remove_all_delegated_users_of_a_base_user"></a>Remove all delegated users of a base user</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/users/baseUser/authorizedUsers</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Removal of the delegated users succeeded</p>
-</li>
-<li>
-<p>404: The base user does not exist</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Note: Delegation is only available on top of Cassandra products and not implemented yet on top of JPA backends.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_change_a_username"><a class="anchor" href="#_change_a_username"></a>Change a username</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/users/oldUser/rename/newUser?action=rename</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Would migrate account data from <code>oldUser</code> to <code>newUser</code>.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Implemented migration steps are:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>ForwardUsernameChangeTaskStep</code>: creates forward from old user to new user and migrates existing forwards</p>
-</li>
-<li>
-<p><code>FilterUsernameChangeTaskStep</code>: migrates users filtering rules</p>
-</li>
-<li>
-<p><code>DelegationUsernameChangeTaskStep</code>: migrates delegations where the impacted user is either delegatee or delegator</p>
-</li>
-<li>
-<p><code>MailboxUsernameChangeTaskStep</code>: migrates mailboxes belonging to the old user to the account of the new user. It also
-migrates user’s mailbox subscriptions.</p>
-</li>
-<li>
-<p><code>ACLUsernameChangeTaskStep</code>: migrates ACLs on mailboxes the migrated user has access to and updates subscriptions accordingly.</p>
-</li>
-<li>
-<p><code>QuotaUsernameChangeTaskStep</code>: migrates quotas user from old user to new user.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Error in the request. Details can be found in the reported error. If you encounter the error "'oldUser' parameter should be an existing user," please note that this validation can be bypassed by specifying the <code>force</code> query parameter.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The <code>fromStep</code> query parameter allows skipping previous steps, allowing to resume the username change from a failed step.</p>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>UsernameChangeTask</code> and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type": "UsernameChangeTask",
- "oldUser": "jessy.jones@domain.tld",
- "newUser": "jessy.smith@domain.tld",
- "status": {
- "A": "DONE",
- "B": "FAILED",
- "C": "ABORTED"
- },
- "fromStep": null,
- "timestamp": "2023-02-17T02:54:01.246477Z"
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Valid status includes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>SKIPPED</code>: bypassed via <code>fromStep</code> setting</p>
-</li>
-<li>
-<p><code>WAITING</code>: Awaits execution</p>
-</li>
-<li>
-<p><code>IN_PROGRESS</code>: Currently executed</p>
-</li>
-<li>
-<p><code>FAILED</code>: Error encountered while executing this step. Check the logs.</p>
-</li>
-<li>
-<p><code>ABORTED</code>: Won’t be executed because of previous step failures.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_delete_data_of_a_user"><a class="anchor" href="#_delete_data_of_a_user"></a>Delete data of a user</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/users/usernameToBeUsed?action=deleteData</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Would create a task that deletes data of the user.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Implemented deletion steps are:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>RecipientRewriteTableUserDeletionTaskStep</code>: deletes all rewriting rules related to this user.</p>
-</li>
-<li>
-<p><code>FilterUserDeletionTaskStep</code>: deletes all filters belonging to the user.</p>
-</li>
-<li>
-<p><code>DelegationUserDeletionTaskStep</code>: deletes all delegations from / to the user.</p>
-</li>
-<li>
-<p><code>MailboxUserDeletionTaskStep</code>: deletes mailboxes of this user, all ACLs of this user, as well as his subscriptions.</p>
-</li>
-<li>
-<p><code>WebPushUserDeletionTaskStep</code>: deletes push data registered for this user.</p>
-</li>
-<li>
-<p><code>IdentityUserDeletionTaskStep</code>: deletes identities registered for this user.</p>
-</li>
-<li>
-<p><code>VacationUserDeletionTaskStep</code>: deletes vacations registered for this user.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Error in the request. Details can be found in the reported error.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The <code>fromStep</code> query parameter allows skipping previous steps, allowing to resume the user data deletion from a failed step.</p>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>DeleteUserDataTask</code> and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type": "DeleteUserDataTask",
- "username": "jessy.jones@domain.tld",
- "status": {
- "A": "DONE",
- "B": "FAILED",
- "C": "ABORTED"
- },
- "fromStep": null,
- "timestamp": "2023-02-17T02:54:01.246477Z"
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Valid status includes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>SKIPPED</code>: bypassed via <code>fromStep</code> setting</p>
-</li>
-<li>
-<p><code>WAITING</code>: Awaits execution</p>
-</li>
-<li>
-<p><code>IN_PROGRESS</code>: Currently executed</p>
-</li>
-<li>
-<p><code>FAILED</code>: Error encountered while executing this step. Check the logs.</p>
-</li>
-<li>
-<p><code>ABORTED</code>: Won’t be executed because of previous step failures.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_retrieving_the_user_identities"><a class="anchor" href="#_retrieving_the_user_identities"></a>Retrieving the user identities</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/users/{baseUser}/identities?default=true</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>API to get the list of identities of a user</p>
-</div>
-<div class="paragraph">
-<p>The response will look like:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">[
- {
- "name":"identity name 1",
- "email":"bob@domain.tld",
- "id":"4c039533-75b9-45db-becc-01fb0e747aa8",
- "mayDelete":true,
- "textSignature":"textSignature 1",
- "htmlSignature":"htmlSignature 1",
- "sortOrder":1,
- "bcc":[
- {
- "emailerName":"bcc name 1",
- "mailAddress":"bcc1@domain.org"
- }
- ],
- "replyTo":[
- {
- "emailerName":"reply name 1",
- "mailAddress":"reply1@domain.org"
- }
- ]
- }
-]</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Query parameters:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>default: (Optional) allows getting the default identity of a user. In order to do that: <code>default=true</code></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The list was successfully retrieved</p>
-</li>
-<li>
-<p>400: The user is invalid</p>
-</li>
-<li>
-<p>404: The user is unknown or the default identity can not be found.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The optional <code>default</code> query parameter allows getting the default identity of a user.
-In order to do that: <code>default=true</code></p>
-</div>
-<div class="paragraph">
-<p>The web-admin server will return <code>404</code> response code when the default identity can not be found.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_creating_a_jmap_user_identity"><a class="anchor" href="#_creating_a_jmap_user_identity"></a>Creating a JMAP user identity</h3>
-<div class="paragraph">
-<p>API to create a new JMAP user identity</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/users/{username}/identities \
--d '{
- "name": "Bob",
- "email": "bob@domain.tld",
- "mayDelete": true,
- "htmlSignature": "a html signature",
- "textSignature": "a text signature",
- "bcc": [{
- "email": "boss2@domain.tld",
- "name": "My Boss 2"
- }],
- "replyTo": [{
- "email": "boss@domain.tld",
- "name": "My Boss"
- }],
- "sortOrder": 0
- }' \
--H "Content-Type: application/json"</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: The new identity was successfully created</p>
-</li>
-<li>
-<p>404: The username is unknown</p>
-</li>
-<li>
-<p>400: The payload is invalid</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Resource name ``username'' represents a valid user</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_updating_a_jmap_user_identity"><a class="anchor" href="#_updating_a_jmap_user_identity"></a>Updating a JMAP user identity</h3>
-<div class="paragraph">
-<p>API to update an exist JMAP user identity</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/users/{username}/identities/{identityId} \
--d '{
- "name": "Bob",
- "htmlSignature": "a html signature",
- "textSignature": "a text signature",
- "bcc": [{
- "email": "boss2@domain.tld",
- "name": "My Boss 2"
- }],
- "replyTo": [{
- "email": "boss@domain.tld",
- "name": "My Boss"
- }],
- "sortOrder": 1
- }' \
--H "Content-Type: application/json"</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The identity were successfully updated</p>
-</li>
-<li>
-<p>404: The username is unknown</p>
-</li>
-<li>
-<p>400: The payload is invalid</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Resource name <code>username'' represents a valid user
-Resource name </code>identityId'' represents a exist user identity</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_administrating_vacation_settings"><a class="anchor" href="#_administrating_vacation_settings"></a>Administrating vacation settings</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_get_vacation_settings"><a class="anchor" href="#_get_vacation_settings"></a>Get vacation settings</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/vacation/usernameToBeUsed</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name usernameToBeUsed representing valid users, hence it should
-match the criteria at <a href="../configure/usersrepository.html" class="xref page">User Repositories documentation</a></p>
-</div>
-<div class="paragraph">
-<p>The response will look like this:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "enabled": true,
- "fromDate": "2021-09-20T10:00:00Z",
- "toDate": "2021-09-27T18:00:00Z",
- "subject": "Out of office",
- "textBody": "I am on vacation, will be back soon.",
- "htmlBody": "<p>I am on vacation, will be back soon.</p>"
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The vacation settings were successfully retrieved</p>
-</li>
-<li>
-<p>404: The user name is unknown</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_update_vacation_settings"><a class="anchor" href="#_update_vacation_settings"></a>Update vacation settings</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/vacation/usernameToBeUsed</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Request body must be a JSON structure as described above.</p>
-</div>
-<div class="paragraph">
-<p>If any field is not set in the request, the corresponding field in the existing vacation message is left unchanged.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The vacation settings were successfully updated</p>
-</li>
-<li>
-<p>404: The user name is unknown</p>
-</li>
-<li>
-<p>400: The payload is invalid</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_delete_vacation_settings"><a class="anchor" href="#_delete_vacation_settings"></a>Delete vacation settings</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/vacation/usernameToBeUsed</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>For convenience, this disables and clears the existing vacation settings of the user.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The vacation settings were successfully disabled</p>
-</li>
-<li>
-<p>404: The user name is unknown</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_administrating_mailboxes"><a class="anchor" href="#_administrating_mailboxes"></a>Administrating mailboxes</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_all_mailboxes"><a class="anchor" href="#_all_mailboxes"></a>All mailboxes</h3>
-<div class="paragraph">
-<p>Several actions can be performed on the server mailboxes.</p>
-</div>
-<div class="paragraph">
-<p>Request pattern is:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /mailboxes?action={action1},...</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Error in the request. Details can be found in the reported error.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The kind of task scheduled depends on the action parameter. See below
-for details.</p>
-</div>
-<div class="sect3">
-<h4 id="_fixing_mailboxes_inconsistencies"><a class="anchor" href="#_fixing_mailboxes_inconsistencies"></a>Fixing mailboxes inconsistencies</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /mailboxes?task=SolveInconsistencies</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule a task for fixing inconsistencies for the mailbox
-deduplicated object stored in Cassandra.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>The <code>I-KNOW-WHAT-I-M-DOING</code> header is mandatory (you can read more
-information about it in the warning section below).</p>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type
-<code>solve-mailbox-inconsistencies</code> and the following
-<code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"solve-mailbox-inconsistencies",
- "processedMailboxEntries": 3,
- "processedMailboxPathEntries": 3,
- "fixedInconsistencies": 2,
- "errors": 1,
- "conflictingEntries":[{
- "mailboxDaoEntry":{
- "mailboxPath":"#private:user:mailboxName",
- "mailboxId":"464765a0-e4e7-11e4-aba4-710c1de3782b"
- }," +
- "mailboxPathDaoEntry":{
- "mailboxPath":"#private:user:mailboxName2",
- "mailboxId":"464765a0-e4e7-11e4-aba4-710c1de3782b"
- }
- }]
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note that conflicting entry inconsistencies will not be fixed and will
-require to explicitly use <a href="#_correcting_ghost_mailbox">ghost mailbox</a>
-endpoint in order to merge the conflicting mailboxes and prevent any
-message loss.</p>
-</div>
-<div class="paragraph">
-<p><strong>WARNING</strong>: this task can cancel concurrently running legitimate user
-operations upon dirty read. As such this task should be run offline.</p>
-</div>
-<div class="paragraph">
-<p>A dirty read is when data is read between the two writes of the
-denormalization operations (no isolation).</p>
-</div>
-<div class="paragraph">
-<p>In order to ensure being offline, stop the traffic on SMTP, JMAP and
-IMAP ports, for example via re-configuration or firewall rules.</p>
-</div>
-<div class="paragraph">
-<p>Due to all of those risks, a <code>I-KNOW-WHAT-I-M-DOING</code> header should be
-positioned to <code>ALL-SERVICES-ARE-OFFLINE</code> in order to prevent accidental
-calls.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_recomputing_mailbox_counters"><a class="anchor" href="#_recomputing_mailbox_counters"></a>Recomputing mailbox counters</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /mailboxes?task=RecomputeMailboxCounters</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will recompute counters (unseen & total count) for the mailbox object
-stored in Cassandra.</p>
-</div>
-<div class="paragraph">
-<p>Cassandra maintains a per mailbox projection for message count and
-unseen message count. As with any projection, it can go out of sync,
-leading to inconsistent results being returned to the client.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type
-<code>recompute-mailbox-counters</code> and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"recompute-mailbox-counters",
- "processedMailboxes": 3,
- "failedMailboxes": ["464765a0-e4e7-11e4-aba4-710c1de3782b"]
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note that conflicting inconsistencies entries will not be fixed and will
-require to explicitly use <a href="#_correcting_ghost_mailbox">ghost mailbox</a>
-endpoint in order to merge the conflicting mailboxes and prevent any
-message loss.</p>
-</div>
-<div class="paragraph">
-<p><strong>WARNING</strong>: this task do not take into account concurrent modifications
-upon a single mailbox counter recomputation. Rerunning the task will
-<em>eventually</em> provide the consistent result. As such we advise to run
-this task offline.</p>
-</div>
-<div class="paragraph">
-<p>In order to ensure being offline, stop the traffic on SMTP, JMAP and
-IMAP ports, for example via re-configuration or firewall rules.</p>
-</div>
-<div class="paragraph">
-<p><code>trustMessageProjection</code> query parameter can be set to <code>true</code>. Content
-of <code>messageIdTable</code> (listing messages by their mailbox context) table
-will be trusted and not compared against content of <code>imapUidTable</code> table
-(listing messages by their messageId mailbox independent identifier).
-This will result in a better performance running the task at the cost of
-safety in the face of message denormalization inconsistencies.</p>
-</div>
-<div class="paragraph">
-<p>Defaults to false, which generates additional checks. You can read
-<a href="https://github.com/apache/james-project/blob/master/src/adr/0022-cassandra-message-inconsistency.md">this
-ADR</a> to better understand the message projection and how it can become
-inconsistent.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_recomputing_global_jmap_fast_message_view_projection"><a class="anchor" href="#_recomputing_global_jmap_fast_message_view_projection"></a>Recomputing Global JMAP fast message view projection</h4>
-<div class="paragraph">
-<p>Message fast view projection stores message properties expected to be
-fast to fetch but are actually expensive to compute, in order for
-GetMessages operation to be fast to execute for these properties.</p>
-</div>
-<div class="paragraph">
-<p>These projection items are asynchronously computed on mailbox events.</p>
-</div>
-<div class="paragraph">
-<p>You can force the full projection recomputation by calling the following
-endpoint:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /mailboxes?task=recomputeFastViewProjectionItems</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule a task for recomputing the fast message view projection
-for all mailboxes.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>An admin can specify the concurrency that should be used when running
-the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>messagesPerSecond</code> rate at which messages should be processed, per
-second. Defaults to 10.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must have a strictly positive integer as a value
-and be passed as query parameters.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /mailboxes?task=recomputeFastViewProjectionItems&messagesPerSecond=20</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type
-<code>RecomputeAllFastViewProjectionItemsTask</code> and the following
-<code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"RecomputeAllPreviewsTask",
- "processedUserCount": 3,
- "processedMessageCount": 3,
- "failedUserCount": 2,
- "failedMessageCount": 1,
- "runningOptions": {
- "messagesPerSecond":20
- }
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Error in the request. Details can be found in the reported error.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_populate_email_query_view"><a class="anchor" href="#_populate_email_query_view"></a>Populate email query view</h4>
-<div class="paragraph">
-<p>Email query view is an optional projection to offload common JMAP <code>Email/query</code> requests used for listing mails on Cassandra
-and not on the search index thus improving the overall reliability / performance on this operation.</p>
-</div>
-<div class="paragraph">
-<p>These projection items are asynchronously computed on mailbox events.</p>
-</div>
-<div class="paragraph">
-<p>You can populate this projection with the following request:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /mailboxes?task=populateEmailQueryView</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule a task for recomputing the fast message view projection
-for all mailboxes.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>An admin can specify the concurrency that should be used when running
-the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>messagesPerSecond</code> rate at which messages should be processed, per
-second. Defaults to 10.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must have a strictly positive integer as a value
-and be passed as query parameters.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /mailboxes?task=populateEmailQueryView&messagesPerSecond=20</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type
-<code>PopulateEmailQueryViewTask</code> and the following
-<code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"PopulateEmailQueryViewTask",
- "processedUserCount": 3,
- "processedMessageCount": 3,
- "failedUserCount": 2,
- "failedMessageCount": 1,
- "runningOptions": {
- "messagesPerSecond":20
- }
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Error in the request. Details can be found in the reported error.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_recomputing_cassandra_filtering_projection"><a class="anchor" href="#_recomputing_cassandra_filtering_projection"></a>Recomputing Cassandra filtering projection</h4>
-<div class="paragraph">
-<p>You can force the reset of the Cassandra filtering projection by calling the following
-endpoint:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /mailboxes?task=populateFilteringProjection</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule a task.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type
-<code>PopulateFilteringProjectionTask</code> and the following
-<code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"RecomputeAllPreviewsTask",
- "processedUserCount": 3,
- "failedUserCount": 2
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Error in the request. Details can be found in the reported error.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_reindexing_action"><a class="anchor" href="#_reindexing_action"></a>ReIndexing action</h4>
-<div class="paragraph">
-<p>Be also aware of the limits of this API:</p>
-</div>
-<div class="paragraph">
-<p>Warning: During the re-indexing, the result of search operations might
-be altered.</p>
-</div>
-<div class="paragraph">
-<p>Warning: Canceling this task should be considered unsafe as it will
-leave the currently reIndexed mailbox as partially indexed.</p>
-</div>
-<div class="paragraph">
-<p>Warning: While we have been trying to reduce the inconsistency window to
-a maximum (by keeping track of ongoing events), concurrent changes done
-during the reIndexing might be ignored.</p>
-</div>
-<div class="sect4">
-<h5 id="_reindexing_all_mails"><a class="anchor" href="#_reindexing_all_mails"></a>ReIndexing all mails</h5>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/mailboxes?task=reIndex</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule a task for reIndexing all the mails stored on this James
-server.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>An admin can specify the concurrency that should be used when running
-the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>messagesPerSecond</code> rate at which messages should be processed per
-second. Default is 50.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must have a strictly positive integer as a value
-and be passed as query parameter.</p>
-</div>
-<div class="paragraph">
-<p>An admin can also specify the reindexing mode it wants to use when
-running the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>mode</code> the reindexing mode used. There are 2 modes for the moment:</p>
-<div class="ulist">
-<ul>
-<li>
-<p><code>rebuildAll</code> allows to rebuild all indexes. This is the default mode.</p>
-</li>
-<li>
-<p><code>fixOutdated</code> will check for outdated indexed document and reindex
-only those.</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must be passed as query parameter.</p>
-</div>
-<div class="paragraph">
-<p>It’s good to note as well that there is a limitation with the
-<code>fixOutdated</code> mode. As we first collect metadata of stored messages to
-compare them with the ones in the index, a failed <code>expunged</code> operation
-might not be well corrected (as the message might not exist anymore but
-still be indexed).</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/mailboxes?task=reIndex&messagesPerSecond=200&mode=rebuildAll</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>full-reindexing</code> and
-the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"full-reindexing",
- "runningOptions":{
- "messagesPerSecond":200,
- "mode":"REBUILD_ALL"
- },
- "successfullyReprocessedMailCount":18,
- "failedReprocessedMailCount": 3,
- "mailboxFailures": ["12", "23" ],
- "messageFailures": [
- {
- "mailboxId": "1",
- "uids": [1, 36]
- }]
-}</pre>
-</div>
-</div>
-</div>
-<div class="sect4">
-<h5 id="_fixing_previously_failed_reindexing"><a class="anchor" href="#_fixing_previously_failed_reindexing"></a>Fixing previously failed ReIndexing</h5>
-<div class="paragraph">
-<p>Will schedule a task for reIndexing all the mails which had failed to be
-indexed from the ReIndexingAllMails task.</p>
-</div>
-<div class="paragraph">
-<p>Given <code>bbdb69c9-082a-44b0-a85a-6e33e74287a5</code> being a <code>taskId</code> generated
-for a reIndexing tasks</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST 'http://ip:port/mailboxes?task=reIndex&reIndexFailedMessagesOf=bbdb69c9-082a-44b0-a85a-6e33e74287a5'</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>An admin can specify the concurrency that should be used when running
-the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>messagesPerSecond</code> rate at which messages should be processed per
-second. Default is 50.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must have a strictly positive integer as a value
-and be passed as query parameter.</p>
-</div>
-<div class="paragraph">
-<p>An admin can also specify the reindexing mode it wants to use when
-running the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>mode</code> the reindexing mode used. There are 2 modes for the moment:</p>
-<div class="ulist">
-<ul>
-<li>
-<p><code>rebuildAll</code> allows to rebuild all indexes. This is the default mode.</p>
-</li>
-<li>
-<p><code>fixOutdated</code> will check for outdated indexed document and reindex
-only those.</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must be passed as query parameter.</p>
-</div>
-<div class="paragraph">
-<p>It’s good to note as well that there is a limitation with the
-<code>fixOutdated</code> mode. As we first collect metadata of stored messages to
-compare them with the ones in the index, a failed <code>expunged</code> operation
-might not be well corrected (as the message might not exist anymore but
-still be indexed).</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/mailboxes?task=reIndex&reIndexFailedMessagesOf=bbdb69c9-082a-44b0-a85a-6e33e74287a5&messagesPerSecond=200&mode=rebuildAll</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type
-<code>error-recovery-indexation</code> and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"error-recovery-indexation"
- "runningOptions":{
- "messagesPerSecond":200,
- "mode":"REBUILD_ALL"
- },
- "successfullyReprocessedMailCount":18,
- "failedReprocessedMailCount": 3,
- "mailboxFailures": ["12", "23" ],
- "messageFailures": [{
- "mailboxId": "1",
- "uids": [1, 36]
- }]
-}</pre>
-</div>
-</div>
-</div>
-<div class="sect4">
-<h5 id="_create_missing_parent_mailboxes"><a class="anchor" href="#_create_missing_parent_mailboxes"></a>Create missing parent mailboxes</h5>
-<div class="paragraph">
-<p>Will schedule a task for creating all the missing parent mailboxes in a hierarchical mailbox tree, which is the result
-of a partially failed rename operation of a child mailbox.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/mailboxes?task=createMissingParents</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Error in the request. Details can be found in the reported error.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>createMissingParents</code> and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"createMissingParents"
- "created": ["1", "2" ],
- "totalCreated": 2,
- "failures": [],
- "totalFailure": 0
-}</pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_single_mailbox"><a class="anchor" href="#_single_mailbox"></a>Single mailbox</h3>
-<div class="sect3">
-<h4 id="_reindexing_a_mailbox_mails"><a class="anchor" href="#_reindexing_a_mailbox_mails"></a>ReIndexing a mailbox mails</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/mailboxes/{mailboxId}?task=reIndex</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule a task for reIndexing all the mails in one mailbox.</p>
-</div>
-<div class="paragraph">
-<p>Note that `mailboxId' path parameter needs to be a (implementation
-dependent) valid mailboxId.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>An admin can specify the concurrency that should be used when running
-the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>messagesPerSecond</code> rate at which messages should be processed per
-second. Default is 50.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must have a strictly positive integer as a value
-and be passed as query parameter.</p>
-</div>
-<div class="paragraph">
-<p>An admin can also specify the reindexing mode it wants to use when
-running the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>mode</code> the reindexing mode used. There are 2 modes for the moment:</p>
-<div class="ulist">
-<ul>
-<li>
-<p><code>rebuildAll</code> allows to rebuild all indexes. This is the default mode.</p>
-</li>
-<li>
-<p><code>fixOutdated</code> will check for outdated indexed document and reindex
-only those.</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must be passed as query parameter.</p>
-</div>
-<div class="paragraph">
-<p>It’s good to note as well that there is a limitation with the
-<code>fixOutdated</code> mode. As we first collect metadata of stored messages to
-compare them with the ones in the index, a failed <code>expunged</code> operation
-might not be well corrected (as the message might not exist anymore but
-still be indexed).</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/mailboxes/{mailboxId}?task=reIndex&messagesPerSecond=200&mode=fixOutdated</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Error in the request. Details can be found in the reported error.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>mailbox-reindexing</code> and
-the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"mailbox-reindexing",
- "runningOptions":{
- "messagesPerSecond":200,
- "mode":"FIX_OUTDATED"
- },
- "mailboxId":"{mailboxId}",
- "successfullyReprocessedMailCount":18,
- "failedReprocessedMailCount": 3,
- "mailboxFailures": ["12"],
- "messageFailures": [
- {
- "mailboxId": "1",
- "uids": [1, 36]
- }]
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Warning: During the re-indexing, the result of search operations might
-be altered.</p>
-</div>
-<div class="paragraph">
-<p>Warning: Canceling this task should be considered unsafe as it will
-leave the currently reIndexed mailbox as partially indexed.</p>
-</div>
-<div class="paragraph">
-<p>Warning: While we have been trying to reduce the inconsistency window to
-a maximum (by keeping track of ongoing events), concurrent changes done
-during the reIndexing might be ignored.</p>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_administrating_messages"><a class="anchor" href="#_administrating_messages"></a>Administrating Messages</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_reindexing_a_single_mail_by_messageid"><a class="anchor" href="#_reindexing_a_single_mail_by_messageid"></a>ReIndexing a single mail by messageId</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/messages/{messageId}?task=reIndex</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule a task for reIndexing a single email in all the mailboxes
-containing it.</p>
-</div>
-<div class="paragraph">
-<p>Note that `messageId' path parameter needs to be a (implementation
-dependent) valid messageId.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Error in the request. Details can be found in the reported error.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>messageId-reindexing</code>
-and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "messageId":"18"
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Warning: During the re-indexing, the result of search operations might
-be altered.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_fixing_message_inconsistencies"><a class="anchor" href="#_fixing_message_inconsistencies"></a>Fixing message inconsistencies</h3>
-<div class="paragraph">
-<p>This task is only available on top of Guice Cassandra products.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /messages?task=SolveInconsistencies</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule a task for fixing message inconsistencies created by the
-message denormalization process.</p>
-</div>
-<div class="paragraph">
-<p>Messages are denormalized and stored in separated data tables in
-Cassandra, so they can be accessed by their unique identifier or mailbox
-identifier & local mailbox identifier through different protocols.</p>
-</div>
-<div class="paragraph">
-<p>Failure in the denormalization process will lead to inconsistencies, for
-example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>BOB receives a message
-The denormalization process fails
-BOB can read the message via JMAP
-BOB cannot read the message via IMAP
-
-BOB marks a message as SEEN
-The denormalization process fails
-The message is SEEN via JMAP
-The message is UNSEEN via IMAP</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>An admin can specify the concurrency that should be used when running
-the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>messagesPerSecond</code> rate of messages to be processed per second.
-Default is 100.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must have a strictly positive integer as a value
-and be passed as query parameter.</p>
-</div>
-<div class="paragraph">
-<p>An admin can also specify the reindexing mode it wants to use when
-running the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>mode</code> the reindexing mode used. There are 2 modes for the moment:</p>
-<div class="ulist">
-<ul>
-<li>
-<p><code>rebuildAll</code> allows to rebuild all indexes. This is the default mode.</p>
-</li>
-<li>
-<p><code>fixOutdated</code> will check for outdated indexed document and reindex
-only those.</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must be passed as query parameter.</p>
-</div>
-<div class="paragraph">
-<p>It’s good to note as well that there is a limitation with the
-<code>fixOutdated</code> mode. As we first collect metadata of stored messages to
-compare them with the ones in the index, a failed <code>expunged</code> operation
-might not be well corrected (as the message might not exist anymore but
-still be indexed).</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /messages?task=SolveInconsistencies&messagesPerSecond=200&mode=rebuildAll</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Error in the request. Details can be found in the reported error.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type
-<code>solve-message-inconsistencies</code> and the following
-<code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"solve-message-inconsistencies",
- "timestamp":"2007-12-03T10:15:30Z",
- "processedImapUidEntries": 2,
- "processedMessageIdEntries": 1,
- "addedMessageIdEntries": 1,
- "updatedMessageIdEntries": 0,
- "removedMessageIdEntries": 1,
- "runningOptions":{
- "messagesPerSecond": 200,
- "mode":"REBUILD_ALL"
- },
- "fixedInconsistencies": [
- {
- "mailboxId": "551f0580-82fb-11ea-970e-f9c83d4cf8c2",
- "messageId": "d2bee791-7e63-11ea-883c-95b84008f979",
- "uid": 1
- },
- {
- "mailboxId": "551f0580-82fb-11ea-970e-f9c83d4cf8c2",
- "messageId": "d2bee792-7e63-11ea-883c-95b84008f979",
- "uid": 2
- }
- ],
- "errors": [
- {
- "mailboxId": "551f0580-82fb-11ea-970e-f9c83d4cf8c2",
- "messageId": "ffffffff-7e63-11ea-883c-95b84008f979",
- "uid": 3
- }
- ]
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>User actions concurrent to the inconsistency fixing task could result in
-concurrency issues. New inconsistencies could be created.</p>
-</div>
-<div class="paragraph">
-<p>However the source of truth will not be impacted, hence rerunning the
-task will eventually fix all issues.</p>
-</div>
-<div class="paragraph">
-<p>This task could be run safely online and can be scheduled on a recurring
-basis outside of peak traffic by an admin to ensure Cassandra message
-consistency.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_deleting_old_messages_of_all_users"><a class="anchor" href="#_deleting_old_messages_of_all_users"></a>Deleting old messages of all users</h3>
-<div class="paragraph">
-<p><strong>Note:</strong>
-Consider enabling the <a href="../configure/vault.html" class="xref page">Deleted Messages Vault</a>
-if you use this feature.</p>
-</div>
-<div class="paragraph">
-<p>Old messages tend to pile up in user INBOXes. An admin might want to delete
-these on behalf of the users, e.g. all messages older than 30 days:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/messages?olderThan=30d</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>The <code>olderThan</code> parameter should be expressed in the following format: <code>Nunit</code>.
-<code>N</code> should be strictly positive. <code>unit</code> could be either in the short form
-(<code>d</code>, <code>w</code>, <code>y</code> etc.), or in the long form (<code>days</code>, <code>weeks</code>, <code>months</code>, <code>years</code>).
-The default unit is <code>days</code>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Error in the request. Details can be found in the reported error.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the type <code>ExpireMailboxTask</code> and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type": "ExpireMailboxTask"
- "mailboxesExpired": 5,
- "mailboxesFailed": 2,
- "mailboxesProcessed": 10,
- "messagesDeleted": 23,
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>To delete old mails from a different mailbox than INBOX, e.g. a mailbox
-named "Archived" :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/messages?mailbox=Archived&olderThan=30d</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Since this is a somewhat expensive operation, the task is throttled to one user
-per second. You may speed it up via <code>usersPerSecond=10</code> for example. But keep
-in mind that a high rate might overwhelm your database or blob store.</p>
-</div>
-<div class="paragraph">
-<p><strong>Scanning search only:</strong> (unsupported for Lucene and OpenSearch search implementations)<br>
-Some mail clients can add an <code>Expires</code> header (RFC 4021) to their messages.
-Instead of specifying an absolute age, you may choose to delete only such
-messages where the expiration date from this header lies in the past:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/messages?byExpiresHeader</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>In this case you should also add the <a href="../configure/mailets.html" class="xref page">mailet</a>
-<code>Expires</code> to your mailet container, which can sanitize expiration date headers.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_administrating_user_mailboxes"><a class="anchor" href="#_administrating_user_mailboxes"></a>Administrating user mailboxes</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_creating_a_mailbox"><a class="anchor" href="#_creating_a_mailbox"></a>Creating a mailbox</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/users/{usernameToBeUsed}/mailboxes/{mailboxNameToBeCreated}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user Resource
-name <code>mailboxNameToBeCreated</code> should not be empty, nor contain % * characters, nor starting with #.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The mailbox now exists on the server</p>
-</li>
-<li>
-<p>400: Invalid mailbox name</p>
-</li>
-<li>
-<p>404: The user name does not exist. Note that this check can be bypassed by specifying the <code>force</code> query parameter.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<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>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/users/{usernameToBeUsed}/mailboxes/INBOX.work</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_deleting_a_mailbox_and_its_children"><a class="anchor" href="#_deleting_a_mailbox_and_its_children"></a>Deleting a mailbox and its children</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/users/{usernameToBeUsed}/mailboxes/{mailboxNameToBeDeleted}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user Resource
-name <code>mailboxNameToBeDeleted</code> should not be empty</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The mailbox now does not exist on the server</p>
-</li>
-<li>
-<p>400: Invalid mailbox name</p>
-</li>
-<li>
-<p>404: The user name does not exist. Note that this check can be bypassed by specifying the <code>force</code> query parameter.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_testing_existence_of_a_mailbox"><a class="anchor" href="#_testing_existence_of_a_mailbox"></a>Testing existence of a mailbox</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/users/{usernameToBeUsed}/mailboxes/{mailboxNameToBeTested}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user Resource
-name <code>mailboxNameToBeTested</code> should not be empty</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The mailbox exists</p>
-</li>
-<li>
-<p>400: Invalid mailbox name</p>
-</li>
-<li>
-<p>404: The user name does not exist, the mailbox does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_listing_user_mailboxes"><a class="anchor" href="#_listing_user_mailboxes"></a>Listing user mailboxes</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/users/{usernameToBeUsed}/mailboxes</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[{"mailboxName":"INBOX"},{"mailboxName":"outbox"}]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The mailboxes list was successfully retrieved</p>
-</li>
-<li>
-<p>404: The user name does not exist, the mailbox does not exist. Note that this check can be bypassed by specifying the <code>force</code> query parameter.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_deleting_user_mailboxes"><a class="anchor" href="#_deleting_user_mailboxes"></a>Deleting user mailboxes</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/users/{usernameToBeUsed}/mailboxes</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The user do not have mailboxes anymore</p>
-</li>
-<li>
-<p>404: The user name does not exist. Note that this check can be bypassed by specifying the <code>force</code> query parameter.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_exporting_user_mailboxes"><a class="anchor" href="#_exporting_user_mailboxes"></a>Exporting user mailboxes</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/users/{usernameToBeUsed}/mailboxes?action=export</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned</p>
-</li>
-<li>
-<p>404: The user name does not exist</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>MailboxesExportTask</code>
-and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"MailboxesExportTask",
- "timestamp":"2007-12-03T10:15:30Z",
- "username": "user",
- "stage": "STARTING"
-}</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_reindexing_a_user_mails"><a class="anchor" href="#_reindexing_a_user_mails"></a>ReIndexing a user mails</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/users/{usernameToBeUsed}/mailboxes?task=reIndex</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule a task for reIndexing all the mails in ``<a href="mailto:user@domain.com">user@domain.com</a>''
-mailboxes (encoded above).</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>An admin can specify the concurrency that should be used when running
-the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>messagesPerSecond</code> rate at which messages should be processed per
-second. Default is 50.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must have a strictly positive integer as a value
-and be passed as query parameter.</p>
-</div>
-<div class="paragraph">
-<p>An admin can also specify the reindexing mode it wants to use when
-running the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>mode</code> the reindexing mode used. There are 2 modes for the moment:</p>
-<div class="ulist">
-<ul>
-<li>
-<p><code>rebuildAll</code> allows to rebuild all indexes. This is the default mode.</p>
-</li>
-<li>
-<p><code>fixOutdated</code> will check for outdated indexed document and reindex
-only those.</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must be passed as query parameter.</p>
-</div>
-<div class="paragraph">
-<p>It’s good to note as well that there is a limitation with the
-<code>fixOutdated</code> mode. As we first collect metadata of stored messages to
-compare them with the ones in the index, a failed <code>expunged</code> operation
-might not be well corrected (as the message might not exist anymore but
-still be indexed).</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/users/{usernameToBeUsed}/mailboxes?task=reIndex&messagesPerSecond=200&mode=fixOutdated</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Error in the request. Details can be found in the reported error.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>user-reindexing</code> and
-the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"user-reindexing",
- "runningOptions":{
- "messagesPerSecond":200,
- "mode":"FIX_OUTDATED"
- },
- "user":"user@domain.com",
- "successfullyReprocessedMailCount":18,
- "failedReprocessedMailCount": 3,
- "mailboxFailures": ["12", "23" ],
- "messageFailures": [
- {
- "mailboxId": "1",
- "uids": [1, 36]
- }]
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Warning: During the re-indexing, the result of search operations might
-be altered.</p>
-</div>
-<div class="paragraph">
-<p>Warning: Canceling this task should be considered unsafe as it will
-leave the currently reIndexed mailbox as partially indexed.</p>
-</div>
-<div class="paragraph">
-<p>Warning: While we have been trying to reduce the inconsistency window to
-a maximum (by keeping track of ongoing events), concurrent changes done
-during the reIndexing might be ignored.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_counting_emails"><a class="anchor" href="#_counting_emails"></a>Counting emails</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/users/{usernameToBeUsed}/mailboxes/{mailboxName}/messageCount</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the total count of messages within the mailbox of that user.</p>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user.</p>
-</div>
-<div class="paragraph">
-<p>Resource name <code>mailboxName</code> should not be empty, nor contain <code>% *</code> characters, nor starting with <code>#</code>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The number of emails in a given mailbox</p>
-</li>
-<li>
-<p>400: Invalid mailbox name</p>
-</li>
-<li>
-<p>404: Invalid get on user mailboxes. The <code>usernameToBeUsed</code> or <code>mailboxName</code> does not exit'</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_counting_unseen_emails"><a class="anchor" href="#_counting_unseen_emails"></a>Counting unseen emails</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/users/{usernameToBeUsed}/mailboxes/{mailboxName}/unseenMessageCount</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the total count of unseen messages within the mailbox of that user.</p>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user.</p>
-</div>
-<div class="paragraph">
-<p>Resource name <code>mailboxName</code> should not be empty, nor contain <code>% *</code> characters, nor starting with <code>#</code>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The number of unseen emails in a given mailbox</p>
-</li>
-<li>
-<p>400: Invalid mailbox name</p>
-</li>
-<li>
-<p>404: Invalid get on user mailboxes. The <code>usernameToBeUsed</code> or <code>mailboxName</code> does not exit'</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_clearing_mailbox_content"><a class="anchor" href="#_clearing_mailbox_content"></a>Clearing mailbox content</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/users/{usernameToBeUsed}/mailboxes/{mailboxName}/messages</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule a task for clearing all the mails in <code>mailboxName</code> mailbox of <code>usernameToBeUsed</code>.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user.</p>
-</div>
-<div class="paragraph">
-<p>Resource name <code>mailboxName</code> should not be empty, nor contain <code>% *</code> characters, nor starting with <code>#</code>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Invalid mailbox name</p>
-</li>
-<li>
-<p>404: Invalid get on user mailboxes. The <code>username</code> or <code>mailboxName</code> does not exit</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>ClearMailboxContentTask</code> and
-the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "mailboxName": "mbx1",
- "messagesFailCount": 9,
- "messagesSuccessCount": 10,
- "timestamp": "2007-12-03T10:15:30Z",
- "type": "ClearMailboxContentTask",
- "username": "bob@domain.tld"
-}</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_subscribing_a_user_to_all_of_its_mailboxes"><a class="anchor" href="#_subscribing_a_user_to_all_of_its_mailboxes"></a>Subscribing a user to all of its mailboxes</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/users/{usernameToBeUsed}/mailboxes?task=subscribeAll</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule a task for subscribing a user to all of its mailboxes.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Most users are unaware of what an IMAP subscription is, nor how they can manage it. If the subscription list gets out
-of sync with the mailbox list, it could result in downgraded user experience (see MAILBOX-405). This task allow
-to reset the subscription list to the mailbox list on a per user basis thus working around the aforementioned issues.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>404: No such user</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>SubscribeAllTask</code> and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"SubscribeAllTask",
- "username":"user@domain.com",
- "subscribedCount":18,
- "unsubscribedCount": 3
-}</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_recomputing_user_jmap_fast_message_view_projection"><a class="anchor" href="#_recomputing_user_jmap_fast_message_view_projection"></a>Recomputing User JMAP fast message view projection</h3>
-<div class="paragraph">
-<p>This action is only available for backends supporting JMAP protocol.</p>
-</div>
-<div class="paragraph">
-<p>Message fast view projection stores message properties expected to be
-fast to fetch but are actually expensive to compute, in order for
-GetMessages operation to be fast to execute for these properties.</p>
-</div>
-<div class="paragraph">
-<p>These projection items are asynchronously computed on mailbox events.</p>
-</div>
-<div class="paragraph">
-<p>You can force the full projection recomputation by calling the following
-endpoint:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /users/{usernameToBeUsed}/mailboxes?task=recomputeFastViewProjectionItems</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule a task for recomputing the fast message view projection
-for all mailboxes of <code>usernameToBeUsed</code>.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>An admin can specify the concurrency that should be used when running
-the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>messagesPerSecond</code> rate at which messages should be processed, per
-second. Defaults to 10.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must have a strictly positive integer as a value
-and be passed as query parameters.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /mailboxes?task=recomputeFastViewProjectionItems&messagesPerSecond=20</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type
-<code>RecomputeUserFastViewProjectionItemsTask</code> and the following
-<code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"RecomputeUserFastViewProjectionItemsTask",
- "username": "{usernameToBeUsed}",
- "processedMessageCount": 3,
- "failedMessageCount": 1,
- "runningOptions": {
- "messagesPerSecond":20
- }
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Error in the request. Details can be found in the reported error.</p>
-</li>
-<li>
-<p>404: User not found.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_administrating_quotas"><a class="anchor" href="#_administrating_quotas"></a>Administrating quotas</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_administrating_quotas_by_users"><a class="anchor" href="#_administrating_quotas_by_users"></a>Administrating quotas by users</h3>
-<div class="sect3">
-<h4 id="_getting_the_quota_for_a_user"><a class="anchor" href="#_getting_the_quota_for_a_user"></a>Getting the quota for a user</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/quota/users/{usernameToBeUsed}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user</p>
-</div>
-<div class="paragraph">
-<p>The answer is the details of the quota of that user.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "global": {
- "count":252,
- "size":242
- },
- "domain": {
- "count":152,
- "size":142
- },
- "user": {
- "count":52,
- "size":42
- },
- "computed": {
- "count":52,
- "size":42
- },
- "occupation": {
- "size":13,
- "count":21,
- "ratio": {
- "size":0.25,
- "count":0.5,
- "max":0.5
- }
- }
-}</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>The <code>global</code> entry represent the quota limit allowed on this James
-server.</p>
-</li>
-<li>
-<p>The <code>domain</code> entry represent the quota limit allowed for the user of
-that domain.</p>
-</li>
-<li>
-<p>The <code>user</code> entry represent the quota limit allowed for this specific
-user.</p>
-</li>
-<li>
-<p>The <code>computed</code> entry represent the quota limit applied for this user,
-resolved from the upper values.</p>
-</li>
-<li>
-<p>The <code>occupation</code> entry represent the occupation of the quota for this
-user. This includes used count and size as well as occupation ratio
-(used / limit).</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Note that <code>quota</code> object can contain a fixed value, an empty value
-(null) or an unlimited value (-1):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"count":52,"size":42}
-
-{"count":null,"size":null}
-
-{"count":52,"size":-1}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The user’s quota was successfully retrieved</p>
-</li>
-<li>
-<p>404: The user does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_updating_the_quota_for_a_user"><a class="anchor" href="#_updating_the_quota_for_a_user"></a>Updating the quota for a user</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/quota/users/{usernameToBeUsed}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user</p>
-</div>
-<div class="paragraph">
-<p>The body can contain a fixed value, an empty value (null) or an
-unlimited value (-1):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"count":52,"size":42}
-
-{"count":null,"size":null}
-
-{"count":52,"size":-1}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated</p>
-</li>
-<li>
-<p>400: The body is not a positive integer neither an unlimited value
-(-1).</p>
-</li>
-<li>
-<p>404: The user does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_getting_the_quota_count_for_a_user"><a class="anchor" href="#_getting_the_quota_count_for_a_user"></a>Getting the quota count for a user</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/quota/users/{usernameToBeUsed}/count</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user</p>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>52</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The user’s quota was successfully retrieved</p>
-</li>
-<li>
-<p>204: No quota count limit is defined at the user level for this user</p>
-</li>
-<li>
-<p>404: The user does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_updating_the_quota_count_for_a_user"><a class="anchor" href="#_updating_the_quota_count_for_a_user"></a>Updating the quota count for a user</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/quota/users/{usernameToBeUsed}/count</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user</p>
-</div>
-<div class="paragraph">
-<p>The body can contain a fixed value or an unlimited value (-1):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>52</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated</p>
-</li>
-<li>
-<p>400: The body is not a positive integer neither an unlimited value
-(-1).</p>
-</li>
-<li>
-<p>404: The user does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_deleting_the_quota_count_for_a_user"><a class="anchor" href="#_deleting_the_quota_count_for_a_user"></a>Deleting the quota count for a user</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/quota/users/{usernameToBeUsed}/count</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated to unlimited value.</p>
-</li>
-<li>
-<p>404: The user does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_getting_the_quota_size_for_a_user"><a class="anchor" href="#_getting_the_quota_size_for_a_user"></a>Getting the quota size for a user</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/quota/users/{usernameToBeUsed}/size</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user</p>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>52</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The user’s quota was successfully retrieved</p>
-</li>
-<li>
-<p>204: No quota size limit is defined at the user level for this user</p>
-</li>
-<li>
-<p>404: The user does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_updating_the_quota_size_for_a_user"><a class="anchor" href="#_updating_the_quota_size_for_a_user"></a>Updating the quota size for a user</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/quota/users/{usernameToBeUsed}/size</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user</p>
-</div>
-<div class="paragraph">
-<p>The body can contain a fixed value or an unlimited value (-1):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>52</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated</p>
-</li>
-<li>
-<p>400: The body is not a positive integer neither an unlimited value
-(-1).</p>
-</li>
-<li>
-<p>404: The user does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_deleting_the_quota_size_for_a_user"><a class="anchor" href="#_deleting_the_quota_size_for_a_user"></a>Deleting the quota size for a user</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/quota/users/{usernameToBeUsed}/size</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated to unlimited value.</p>
-</li>
-<li>
-<p>404: The user does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_searching_user_by_quota_ratio"><a class="anchor" href="#_searching_user_by_quota_ratio"></a>Searching user by quota ratio</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET 'http://ip:port/quota/users?minOccupationRatio=0.8&maxOccupationRatio=0.99&limit=100&offset=200&domain=domain.com'</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[
- {
- "username":"user@domain.com",
- "detail": {
- "global": {
- "count":252,
- "size":242
- },
- "domain": {
- "count":152,
- "size":142
- },
- "user": {
- "count":52,
- "size":42
- },
- "computed": {
- "count":52,
- "size":42
- },
- "occupation": {
- "size":48,
- "count":21,
- "ratio": {
- "size":0.9230,
- "count":0.5,
- "max":0.9230
- }
- }
- }
- },
- ...
-]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Where:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>minOccupationRatio</strong> is a query parameter determining the minimum
-occupation ratio of users to be returned.</p>
-</li>
-<li>
-<p><strong>maxOccupationRatio</strong> is a query parameter determining the maximum
-occupation ratio of users to be returned.</p>
-</li>
-<li>
-<p><strong>domain</strong> is a query parameter determining the domain of users to be
-returned.</p>
-</li>
-<li>
-<p><strong>limit</strong> is a query parameter determining the maximum number of users
-to be returned.</p>
-</li>
-<li>
-<p><strong>offset</strong> is a query parameter determining the number of users to skip.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Please note that users are alphabetically ordered on username.</p>
-</div>
-<div class="paragraph">
-<p>The response is a list of usernames, with attached quota details as
-defined <a href="#_getting_the_quota_for_a_user">here</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: List of users had successfully been returned.</p>
-</li>
-<li>
-<p>400: Validation issues with parameters</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_recomputing_current_quotas_for_users"><a class="anchor" href="#_recomputing_current_quotas_for_users"></a>Recomputing current quotas for users</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /quota/users?task=RecomputeCurrentQuotas</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will recompute current quotas (count and size) for all users stored in
-James.</p>
-</div>
-<div class="paragraph">
-<p>James maintains per quota a projection for current quota count and size.
-As with any projection, it can go out of sync, leading to inconsistent
-results being returned to the client.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>An admin can specify the concurrency that should be used when running
-the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>usersPerSecond</code> rate at which users quotas should be reprocessed, per
-second. Defaults to 1.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must have a strictly positive integer as a value
-and be passed as query parameters.</p>
-</div>
-<div class="paragraph">
-<p>An admin can select which quota component he wants to recompute:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>quotaComponent</code> component whose quota need to be reprocessed. It could be one of values: MAILBOX, SIEVE, JMAP_UPLOADS.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The admin could select several quota components. If he does not select, quotas of all components would be recomputed.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /quota/users?task=RecomputeCurrentQuotas&usersPerSecond=20&quotaComponent=MAILBOX&quotaComponent=JMAP_UPLOADS</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type
-<code>recompute-current-quotas</code> and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"recompute-current-quotas",
- "recomputeSingleQuotaComponentResults": [
- {
- "quotaComponent": "MAILBOX",
- "processedIdentifierCount": 3,
- "failedIdentifiers": ["#private&bob@localhost"]
- },
- {
- "quotaComponent": "JMAP_UPLOADS",
- "processedIdentifierCount": 3,
- "failedIdentifiers": ["bob@localhost"]
- }
- ],
- "runningOptions": {
- "usersPerSecond":20
- }
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>WARNING</strong>: this task do not take into account concurrent modifications
-upon a single current quota re-computation. Rerunning the task will
-<em>eventually</em> provide the consistent result.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_administrating_quotas_by_domains"><a class="anchor" href="#_administrating_quotas_by_domains"></a>Administrating quotas by domains</h3>
-<div class="sect3">
-<h4 id="_getting_the_quota_for_a_domain"><a class="anchor" href="#_getting_the_quota_for_a_domain"></a>Getting the quota for a domain</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/quota/domains/{domainToBeUsed}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>domainToBeUsed</code> should be an existing domain. For
-example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/quota/domains/james.org</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The answer will detail the default quota applied to users belonging to
-that domain:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "global": {
- "count":252,
- "size":null
- },
- "domain": {
- "count":null,
- "size":142
- },
- "computed": {
- "count":252,
- "size":142
- }
-}</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>The <code>global</code> entry represents the quota limit defined on this James
-server by default.</p>
-</li>
-<li>
-<p>The <code>domain</code> entry represents the quota limit allowed for the user of
-that domain by default.</p>
-</li>
-<li>
-<p>The <code>computed</code> entry represents the quota limit applied for the users
-of that domain, by default, resolved from the upper values.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Note that <code>quota</code> object can contain a fixed value, an empty value
-(null) or an unlimited value (-1):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"count":52,"size":42}
-
-{"count":null,"size":null}
-
-{"count":52,"size":-1}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The domain’s quota was successfully retrieved</p>
-</li>
-<li>
-<p>404: The domain does not exist</p>
-</li>
-<li>
-<p>405: Domain Quota configuration not supported when virtual hosting is
-deactivated.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_updating_the_quota_for_a_domain"><a class="anchor" href="#_updating_the_quota_for_a_domain"></a>Updating the quota for a domain</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/quota/domains/{domainToBeUsed}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>domainToBeUsed</code> should be an existing domain.</p>
-</div>
-<div class="paragraph">
-<p>The body can contain a fixed value, an empty value (null) or an
-unlimited value (-1):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"count":52,"size":42}
-
-{"count":null,"size":null}
-
-{"count":52,"size":-1}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated</p>
-</li>
-<li>
-<p>400: The body is not a positive integer neither an unlimited value
-(-1).</p>
-</li>
-<li>
-<p>404: The domain does not exist</p>
-</li>
-<li>
-<p>405: Domain Quota configuration not supported when virtual hosting is
-deactivated.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_getting_the_quota_count_for_a_domain"><a class="anchor" href="#_getting_the_quota_count_for_a_domain"></a>Getting the quota count for a domain</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/quota/domains/{domainToBeUsed}/count</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>domainToBeUsed</code> should be an existing domain.</p>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>52</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The domain’s quota was successfully retrieved</p>
-</li>
-<li>
-<p>204: No quota count limit is defined at the domain level for this
-domain</p>
-</li>
-<li>
-<p>404: The domain does not exist</p>
-</li>
-<li>
-<p>405: Domain Quota configuration not supported when virtual hosting is
-desactivated.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_updating_the_quota_count_for_a_domain"><a class="anchor" href="#_updating_the_quota_count_for_a_domain"></a>Updating the quota count for a domain</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/quota/domains/{domainToBeUsed}/count</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>domainToBeUsed</code> should be an existing domain.</p>
-</div>
-<div class="paragraph">
-<p>The body can contain a fixed value or an unlimited value (-1):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>52</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated</p>
-</li>
-<li>
-<p>400: The body is not a positive integer neither an unlimited value
-(-1).</p>
-</li>
-<li>
-<p>404: The domain does not exist</p>
-</li>
-<li>
-<p>405: Domain Quota configuration not supported when virtual hosting is
-desactivated.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_deleting_the_quota_count_for_a_domain"><a class="anchor" href="#_deleting_the_quota_count_for_a_domain"></a>Deleting the quota count for a domain</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/quota/domains/{domainToBeUsed}/count</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>domainToBeUsed</code> should be an existing domain.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated to unlimited value.</p>
-</li>
-<li>
-<p>404: The domain does not exist</p>
-</li>
-<li>
-<p>405: Domain Quota configuration not supported when virtual hosting is
-deactivated.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_getting_the_quota_size_for_a_domain"><a class="anchor" href="#_getting_the_quota_size_for_a_domain"></a>Getting the quota size for a domain</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/quota/domains/{domainToBeUsed}/size</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>domainToBeUsed</code> should be an existing domain.</p>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>52</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The domain’s quota was successfully retrieved</p>
-</li>
-<li>
-<p>204: No quota size limit is defined at the domain level for this
-domain</p>
-</li>
-<li>
-<p>404: The domain does not exist</p>
-</li>
-<li>
-<p>405: Domain Quota configuration not supported when virtual hosting is
-deactivated.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_updating_the_quota_size_for_a_domain"><a class="anchor" href="#_updating_the_quota_size_for_a_domain"></a>Updating the quota size for a domain</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/quota/domains/{domainToBeUsed}/size</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>domainToBeUsed</code> should be an existing domain.</p>
-</div>
-<div class="paragraph">
-<p>The body can contain a fixed value or an unlimited value (-1):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>52</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated</p>
-</li>
-<li>
-<p>400: The body is not a positive integer neither an unlimited value
-(-1).</p>
-</li>
-<li>
-<p>404: The domain does not exist</p>
-</li>
-<li>
-<p>405: Domain Quota configuration not supported when virtual hosting is
-deactivated.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_deleting_the_quota_size_for_a_domain"><a class="anchor" href="#_deleting_the_quota_size_for_a_domain"></a>Deleting the quota size for a domain</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/quota/domains/{domainToBeUsed}/size</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>domainToBeUsed</code> should be an existing domain.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated to unlimited value.</p>
-</li>
-<li>
-<p>404: The domain does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_administrating_global_quotas"><a class="anchor" href="#_administrating_global_quotas"></a>Administrating global quotas</h3>
-<div class="sect3">
-<h4 id="_getting_the_global_quota"><a class="anchor" href="#_getting_the_global_quota"></a>Getting the global quota</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/quota</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The answer is the details of the global quota.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "count":252,
- "size":242
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note that <code>quota</code> object can contain a fixed value, an empty value
-(null) or an unlimited value (-1):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"count":52,"size":42}
-
-{"count":null,"size":null}
-
-{"count":52,"size":-1}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The quota was successfully retrieved</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_updating_global_quota"><a class="anchor" href="#_updating_global_quota"></a>Updating global quota</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/quota</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The body can contain a fixed value, an empty value (null) or an
-unlimited value (-1):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"count":52,"size":42}
-
-{"count":null,"size":null}
-
-{"count":52,"size":-1}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated</p>
-</li>
-<li>
-<p>400: The body is not a positive integer neither an unlimited value
-(-1).</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_getting_the_global_quota_count"><a class="anchor" href="#_getting_the_global_quota_count"></a>Getting the global quota count</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/quota/count</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name usernameToBeUsed should be an existing user</p>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>52</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The quota was successfully retrieved</p>
-</li>
-<li>
-<p>204: No quota count limit is defined at the global level</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_updating_the_global_quota_count"><a class="anchor" href="#_updating_the_global_quota_count"></a>Updating the global quota count</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/quota/count</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The body can contain a fixed value or an unlimited value (-1):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>52</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated</p>
-</li>
-<li>
-<p>400: The body is not a positive integer neither an unlimited value
-(-1).</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_deleting_the_global_quota_count"><a class="anchor" href="#_deleting_the_global_quota_count"></a>Deleting the global quota count</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/quota/count</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated to unlimited value.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_getting_the_global_quota_size"><a class="anchor" href="#_getting_the_global_quota_size"></a>Getting the global quota size</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/quota/size</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>52</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The quota was successfully retrieved</p>
-</li>
-<li>
-<p>204: No quota size limit is defined at the global level</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_updating_the_global_quota_size"><a class="anchor" href="#_updating_the_global_quota_size"></a>Updating the global quota size</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/quota/size</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The body can contain a fixed value or an unlimited value (-1):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>52</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated</p>
-</li>
-<li>
-<p>400: The body is not a positive integer neither an unlimited value
-(-1).</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_deleting_the_global_quota_size"><a class="anchor" href="#_deleting_the_global_quota_size"></a>Deleting the global quota size</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/quota/size</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated to unlimited value.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_administrating_sieve_quotas"><a class="anchor" href="#_administrating_sieve_quotas"></a>Administrating Sieve quotas</h3>
-<div class="paragraph">
-<p>Some limitations on space Users Sieve script can occupy can be
-configured by default, and overridden by user.</p>
-</div>
-<div class="sect3">
-<h4 id="_retrieving_global_sieve_quota"><a class="anchor" href="#_retrieving_global_sieve_quota"></a>Retrieving global sieve quota</h4>
-<div class="paragraph">
-<p>This endpoints allows to retrieve the global Sieve quota, which will be
-users default:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/sieve/quota/default</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the bytes count allowed by user per default on this server.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>102400</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Request is a success and the value is returned</p>
-</li>
-<li>
-<p>204: No default quota is being configured</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_updating_global_sieve_quota"><a class="anchor" href="#_updating_global_sieve_quota"></a>Updating global sieve quota</h4>
-<div class="paragraph">
-<p>This endpoints allows to update the global Sieve quota, which will be
-users default:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/sieve/quota/default</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>With the body being the bytes count allowed by user per default on this
-server.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>102400</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Operation succeeded</p>
-</li>
-<li>
-<p>400: Invalid payload</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_removing_global_sieve_quota"><a class="anchor" href="#_removing_global_sieve_quota"></a>Removing global sieve quota</h4>
-<div class="paragraph">
-<p>This endpoints allows to remove the global Sieve quota. There will no
-more be users default:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/sieve/quota/default</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Operation succeeded</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_retrieving_user_sieve_quota"><a class="anchor" href="#_retrieving_user_sieve_quota"></a>Retrieving user sieve quota</h4>
-<div class="paragraph">
-<p>This endpoints allows to retrieve the Sieve quota of a user, which will
-be this users quota:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/sieve/quota/users/user@domain.com</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the bytes count allowed for this user.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>102400</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Request is a success and the value is returned</p>
-</li>
-<li>
-<p>204: No quota is being configured for this user</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_updating_user_sieve_quota"><a class="anchor" href="#_updating_user_sieve_quota"></a>Updating user sieve quota</h4>
-<div class="paragraph">
-<p>This endpoints allows to update the Sieve quota of a user, which will be
-users default:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/sieve/quota/users/user@domain.com</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>With the body being the bytes count allowed for this user on this
-server.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>102400</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Operation succeeded</p>
-</li>
-<li>
-<p>400: Invalid payload</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_removing_user_sieve_quota"><a class="anchor" href="#_removing_user_sieve_quota"></a>Removing user sieve quota</h4>
-<div class="paragraph">
-<p>This endpoints allows to remove the Sieve quota of a user. There will no
-more quota for this user:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/sieve/quota/users/user@domain.com</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Operation succeeded</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_administrating_jmap_uploads"><a class="anchor" href="#_administrating_jmap_uploads"></a>Administrating Jmap Uploads</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_cleaning_upload_repository"><a class="anchor" href="#_cleaning_upload_repository"></a>Cleaning upload repository</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/jmap/uploads?scope=expired</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule a task for clearing expired upload entries.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Query parameter <code>scope</code> is required and have the value <code>expired</code>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Scope invalid</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>UploadRepositoryCleanupTask</code> and
-the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "scope": "expired",
- "timestamp": "2007-12-03T10:15:30Z",
- "type": "UploadRepositoryCleanupTask"
-}</pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_running_blob_garbage_collection"><a class="anchor" href="#_running_blob_garbage_collection"></a>Running blob garbage collection</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>When deduplication is enabled one needs to explicitly run a garbage collection in order to delete no longer referenced
-blobs.</p>
-</div>
-<div class="paragraph">
-<p>To do so:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/blobs?scope=unreferenced</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Additional parameters include Bloom filter tuning parameters:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>associatedProbability</strong>: Allow to define the targeted false positive rate. Note that subsequent runs do not have the
-same false-positives. Defaults to <code>0.01</code>.</p>
-</li>
-<li>
-<p><strong>expectedBlobCount</strong>: Expected count of blobs used to size the bloom filters. Defaults to <code>1.000.000</code>.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>These settings directly impacts the memory footprint of the bloom filter. <a href="https://hur.st/bloomfilter/">Simulators</a> can
-help understand those parameters.</p>
-</div>
-<div class="paragraph">
-<p>The created task has the following additional information:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "referenceSourceCount": 3456,
- "blobCount": 5678,
- "gcedBlobCount": 1234,
- "bloomFilterExpectedBlobCount": 10000,
- "bloomFilterAssociatedProbability": 0.01
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Where:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>bloomFilterExpectedBlobCount</strong> correspond to the supplied <strong>expectedBlobCount</strong> query parameter.</p>
-</li>
-<li>
-<p><strong>bloomFilterAssociatedProbability</strong> correspond to the supplied <strong>associatedProbability</strong> query parameter.</p>
-</li>
-<li>
-<p><strong>referenceSourceCount</strong> is the count of distinct blob references encountered while populating the bloom filter.</p>
-</li>
-<li>
-<p><strong>blobCount</strong> is the count of blobs tried against the bloom filter. This value can be used to better size the bloom
-filter in later runs.</p>
-</li>
-<li>
-<p><strong>gcedBlobCount</strong> is the count of blobs that were garbage collected.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_administrating_recipient_rewriting"><a class="anchor" href="#_administrating_recipient_rewriting"></a>Administrating Recipient rewriting</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_address_group"><a class="anchor" href="#_address_group"></a>Address group</h3>
-<div class="paragraph">
-<p>You can use <strong>webadmin</strong> to define address groups.</p>
-</div>
-<div class="paragraph">
-<p>When a specific email is sent to the group mail address, every group
-member will receive it.</p>
-</div>
-<div class="paragraph">
-<p>Note that the group mail address is virtual: it does not correspond to
-an existing user.</p>
-</div>
-<div class="paragraph">
-<p>This feature uses <a href="../architecture/index.html#_recipient_rewrite_tables" class="xref page">Recipients rewrite table</a>
-and requires the
-<a 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>
-</div>
-<div class="paragraph">
-<p>Note that email addresses are restricted to ASCII character set. Mail
-addresses not matching this criteria will be rejected.</p>
-</div>
-<div class="sect3">
-<h4 id="_listing_groups"><a class="anchor" href="#_listing_groups"></a>Listing groups</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/address/groups</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the groups as a list of JSON Strings representing mail
-addresses. For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>["group1@domain.com", "group2@domain.com"]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_listing_members_of_a_group"><a class="anchor" href="#_listing_members_of_a_group"></a>Listing members of a group</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/address/groups/group@domain.com</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the group members as a list of JSON Strings representing
-mail addresses. For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>["member1@domain.com", "member2@domain.com"]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success</p>
-</li>
-<li>
-<p>400: Group structure is not valid</p>
-</li>
-<li>
-<p>404: The group does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_adding_a_group_member"><a class="anchor" href="#_adding_a_group_member"></a>Adding a group member</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/address/groups/group@domain.com/member@domain.com</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will add <a href="mailto:member@domain.com">member@domain.com</a> to <a href="mailto:group@domain.com">group@domain.com</a>, creating the group if
-needed</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Success</p>
-</li>
-<li>
-<p>400: Group structure or member is not valid</p>
-</li>
-<li>
-<p>400: Domain in the source is not managed by the DomainList</p>
-</li>
-<li>
-<p>409: Requested group address is already used for another purpose</p>
-</li>
-<li>
-<p>409: The addition of the group member would lead to a loop and thus cannot be performed</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_removing_a_group_member"><a class="anchor" href="#_removing_a_group_member"></a>Removing a group member</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/address/groups/group@domain.com/member@domain.com</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will remove <a href="mailto:member@domain.com">member@domain.com</a> from <a href="mailto:group@domain.com">group@domain.com</a>, removing the group
-if group is empty after deletion</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Success</p>
-</li>
-<li>
-<p>400: Group structure or member is not valid</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_address_forwards"><a class="anchor" href="#_address_forwards"></a>Address forwards</h3>
-<div class="paragraph">
-<p>You can use <strong>webadmin</strong> to define address forwards.</p>
-</div>
-<div class="paragraph">
-<p>When a specific email is sent to the base mail address, every forward
-destination addresses will receive it.</p>
-</div>
-<div class="paragraph">
-<p>Please note that the base address can be optionaly part of the forward
-destination. In that case, the base recipient also receive a copy of the
-mail. Otherwise he is omitted.</p>
-</div>
-<div class="paragraph">
-<p>Forwards can be defined for existing users. It then defers from
-``groups''.</p>
-</div>
-<div class="paragraph">
-<p>This feature uses <a href="../architecture/index.html#_recipient_rewrite_tables" class="xref page">Recipients rewrite table</a>
-and requires the
-<a 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>
-</div>
-<div class="paragraph">
-<p>Note that email addresses are restricted to ASCII character set. Mail
-addresses not matching this criteria will be rejected.</p>
-</div>
-<div class="sect3">
-<h4 id="_listing_forwards"><a class="anchor" href="#_listing_forwards"></a>Listing Forwards</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/address/forwards</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the users having forwards configured as a list of JSON
-Strings representing mail addresses. For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>["user1@domain.com", "user2@domain.com"]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_listing_destinations_in_a_forward"><a class="anchor" href="#_listing_destinations_in_a_forward"></a>Listing destinations in a forward</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/address/forwards/user@domain.com</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the destination addresses of this forward as a list of JSON
-Strings representing mail addresses. For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[
- {"mailAddress":"destination1@domain.com"},
- {"mailAddress":"destination2@domain.com"}
-]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success</p>
-</li>
-<li>
-<p>400: Forward structure is not valid</p>
-</li>
-<li>
-<p>404: The given user don’t have forwards or does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_adding_a_new_destination_to_a_forward"><a class="anchor" href="#_adding_a_new_destination_to_a_forward"></a>Adding a new destination to a forward</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/address/forwards/user@domain.com/targets/destination@domain.com</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will add <a href="mailto:destination@domain.com">destination@domain.com</a> to <a href="mailto:user@domain.com">user@domain.com</a>, creating the forward
-if needed</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Success</p>
-</li>
-<li>
-<p>400: Forward structure or member is not valid</p>
-</li>
-<li>
-<p>400: Domain in the source is not managed by the DomainList</p>
-</li>
-<li>
-<p>404: Requested forward address does not match an existing user</p>
-</li>
-<li>
-<p>409: The creation of the forward would lead to a loop and thus cannot be performed</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_removing_a_destination_of_a_forward"><a class="anchor" href="#_removing_a_destination_of_a_forward"></a>Removing a destination of a forward</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/address/forwards/user@domain.com/targets/destination@domain.com</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will remove <a href="mailto:destination@domain.com">destination@domain.com</a> from <a href="mailto:user@domain.com">user@domain.com</a>, removing the
-forward if forward is empty after deletion</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Success</p>
-</li>
-<li>
-<p>400: Forward structure or member is not valid</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_address_aliases"><a class="anchor" href="#_address_aliases"></a>Address aliases</h3>
-<div class="paragraph">
-<p>You can use <strong>webadmin</strong> to define aliases for an user.</p>
-</div>
-<div class="paragraph">
-<p>When a specific email is sent to the alias address, the destination
-address of the alias will receive it.</p>
-</div>
-<div class="paragraph">
-<p>Aliases can be defined for existing users.</p>
-</div>
-<div class="paragraph">
-<p>This feature uses <a href="../architecture/index.html#_recipient_rewrite_tables" class="xref page">Recipients rewrite table</a>
-and requires the
-<a 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>
-</div>
-<div class="paragraph">
-<p>Note that email addresses are restricted to ASCII character set. Mail
-addresses not matching this criteria will be rejected.</p>
-</div>
-<div class="sect3">
-<h4 id="_listing_users_with_aliases"><a class="anchor" href="#_listing_users_with_aliases"></a>Listing users with aliases</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/address/aliases</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the users having aliases configured as a list of JSON
-Strings representing mail addresses. For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>["user1@domain.com", "user2@domain.com"]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_listing_alias_sources_of_an_user"><a class="anchor" href="#_listing_alias_sources_of_an_user"></a>Listing alias sources of an user</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/address/aliases/user@domain.com</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the aliases of this user as a list of JSON Strings
-representing mail addresses. For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[
- {"source":"alias1@domain.com"},
- {"source":"alias2@domain.com"}
-]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success</p>
-</li>
-<li>
-<p>400: Alias structure is not valid</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_adding_a_new_alias_to_an_user"><a class="anchor" href="#_adding_a_new_alias_to_an_user"></a>Adding a new alias to an user</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/address/aliases/user@domain.com/sources/alias@domain.com</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will add <a href="mailto:alias@domain.com">alias@domain.com</a> to <a href="mailto:user@domain.com">user@domain.com</a>, creating the alias if
-needed</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: OK</p>
-</li>
-<li>
-<p>400: Alias structure or member is not valid</p>
-</li>
-<li>
-<p>400: Source and destination can’t be the same!</p>
-</li>
-<li>
-<p>400: Domain in the destination or source is not managed by the
-DomainList</p>
-</li>
-<li>
-<p>409: The alias source exists as an user already</p>
-</li>
-<li>
-<p>409: The addition of the alias would lead to a loop and thus cannot be performed</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_removing_an_alias_of_an_user"><a class="anchor" href="#_removing_an_alias_of_an_user"></a>Removing an alias of an user</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/address/aliases/user@domain.com/sources/alias@domain.com</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will remove <a href="mailto:alias@domain.com">alias@domain.com</a> from <a href="mailto:user@domain.com">user@domain.com</a>, removing the alias if
-needed</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: OK</p>
-</li>
-<li>
-<p>400: Alias structure or member is not valid</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_domain_mappings"><a class="anchor" href="#_domain_mappings"></a>Domain mappings</h3>
-<div class="paragraph">
-<p>You can use <strong>webadmin</strong> to define domain mappings.</p>
-</div>
-<div class="paragraph">
-<p>Given a configured source (from) domain and a destination (to) domain,
-when an email is sent to an address belonging to the source domain, then
-the domain part of this address is overwritten, the destination domain
-is then used. A source (from) domain can have many destination (to)
-domains.</p>
-</div>
-<div class="paragraph">
-<p>For example: with a source domain <code>james.apache.org</code> maps to two
-destination domains <code>james.org</code> and <code>apache-james.org</code>, when a mail is
-sent to <code>admin@james.apache.org</code>, then it will be routed to
-<code>admin@james.org</code> and <code>admin@apache-james.org</code></p>
-</div>
-<div class="paragraph">
-<p>This feature uses <a href="../architecture/index.html#_recipient_rewrite_tables" class="xref page">Recipients rewrite table</a>
-and requires the
-<a 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>
-</div>
-<div class="paragraph">
-<p>Note that email addresses are restricted to ASCII character set. Mail
-addresses not matching this criteria will be rejected.</p>
-</div>
-<div class="sect3">
-<h4 id="_listing_all_domain_mappings"><a class="anchor" href="#_listing_all_domain_mappings"></a>Listing all domain mappings</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/domainMappings</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return all configured domain mappings</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "firstSource.org" : ["firstDestination.com", "secondDestination.net"],
- "secondSource.com" : ["thirdDestination.com", "fourthDestination.net"],
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: OK</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_listing_all_destination_domains_for_a_source_domain"><a class="anchor" href="#_listing_all_destination_domains_for_a_source_domain"></a>Listing all destination domains for a source domain</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/domainMappings/sourceDomain.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>With <code>sourceDomain.tld</code> as the value passed to <code>fromDomain</code> resource
-name, the API will return all destination domains configured to that
-domain</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>["firstDestination.com", "secondDestination.com"]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: OK</p>
-</li>
-<li>
-<p>400: The <code>fromDomain</code> resource name is invalid</p>
-</li>
-<li>
-<p>404: The <code>fromDomain</code> resource name is not found</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_adding_a_domain_mapping"><a class="anchor" href="#_adding_a_domain_mapping"></a>Adding a domain mapping</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/domainMappings/sourceDomain.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Body:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>destination.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>With <code>sourceDomain.tld</code> as the value passed to <code>fromDomain</code> resource
-name, the API will add a destination domain specified in the body to
-that domain</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: OK</p>
-</li>
-<li>
-<p>400: The <code>fromDomain</code> resource name is invalid</p>
-</li>
-<li>
-<p>400: The destination domain specified in the body is invalid</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Be aware that no checks to find possible loops that would result of this creation will be performed.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_removing_a_domain_mapping"><a class="anchor" href="#_removing_a_domain_mapping"></a>Removing a domain mapping</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/domainMappings/sourceDomain.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Body:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>destination.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>With <code>sourceDomain.tld</code> as the value passed to <code>fromDomain</code> resource
-name, the API will remove a destination domain specified in the body
-mapped to that domain</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: OK</p>
-</li>
-<li>
-<p>400: The <code>fromDomain</code> resource name is invalid</p>
-</li>
-<li>
-<p>400: The destination domain specified in the body is invalid</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_regex_mapping"><a class="anchor" href="#_regex_mapping"></a>Regex mapping</h3>
-<div class="paragraph">
-<p>You can use <strong>webadmin</strong> to create regex mappings.</p>
-</div>
-<div class="paragraph">
-<p>A regex mapping contains a mapping source and a Java Regular Expression
-(regex) in String as the mapping value. Everytime, if a mail containing
-a recipient matched with the mapping source, then that mail will be
-re-routed to a new recipient address which is re written by the regex.</p>
-</div>
-<div class="paragraph">
-<p>This feature uses <a href="../architecture/index.html#_recipient_rewrite_tables" class="xref page">Recipients rewrite table</a>
-and requires the
-<a href="https://github.com/apache/james-project/blob/master/server/mailet/mailets/src/main/java/org/apache/james/transport/mailets/RecipientRewriteTable.java">RecipientRewriteTable
-API</a> to be configured.</p>
-</div>
-<div class="sect3">
-<h4 id="_adding_a_regex_mapping"><a class="anchor" href="#_adding_a_regex_mapping"></a>Adding a regex mapping</h4>
-<div class="literalblock">
-<div class="content">
-<pre>POST /mappings/regex/mappingSource/targets/regex</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Where:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>the <code>mappingSource</code> is the path parameter represents for the Regex
-Mapping mapping source</p>
-</li>
-<li>
-<p>the <code>regex</code> is the path parameter represents for the Regex Mapping
-regex</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The route will add a regex mapping made from <code>mappingSource</code> and <code>regex</code>
-to RecipientRewriteTable.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/mappings/regex/james@domain.tld/targets/james@.*:james-intern@james.org</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Mapping added successfully.</p>
-</li>
-<li>
-<p>400: Invalid <code>mappingSource</code> path parameter.</p>
-</li>
-<li>
-<p>400: Invalid <code>regex</code> path parameter.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Be aware that no checks to find possible loops that would result of this creation will be performed.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_removing_a_regex_mapping"><a class="anchor" href="#_removing_a_regex_mapping"></a>Removing a regex mapping</h4>
-<div class="literalblock">
-<div class="content">
-<pre>DELETE /mappings/regex/{mappingSource}/targets/{regex}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Where:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>the <code>mappingSource</code> is the path parameter representing the Regex
-Mapping mapping source</p>
-</li>
-<li>
-<p>the <code>regex</code> is the path parameter representing the Regex Mapping regex</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The route will remove the regex mapping made from <code>regex</code> from the
-mapping source <code>mappingSource</code> to RecipientRewriteTable.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/mappings/regex/james@domain.tld/targets/[O_O]:james-intern@james.org</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Mapping deleted successfully.</p>
-</li>
-<li>
-<p>400: Invalid <code>mappingSource</code> path parameter.</p>
-</li>
-<li>
-<p>400: Invalid <code>regex</code> path parameter.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_address_mappings"><a class="anchor" href="#_address_mappings"></a>Address Mappings</h3>
-<div class="paragraph">
-<p>You can use <strong>webadmin</strong> to define address mappings.</p>
-</div>
-<div class="paragraph">
-<p>When a specific email is sent to the base mail address, every
-destination addresses will receive it.</p>
-</div>
-<div class="paragraph">
-<p>This feature uses <a href="../architecture/index.html#_recipient_rewrite_tables" class="xref page">Recipients rewrite table</a>
-and requires the
-<a 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>
-</div>
-<div class="paragraph">
-<p>Note that email addresses are restricted to ASCII character set. Mail
-addresses not matching this criteria will be rejected.</p>
-</div>
-<div class="paragraph">
-<p>Please use address mappings with caution, as it’s not a typed address.
-If you know the type of your address (forward, alias, domain, group,
-etc), prefer using the corresponding routes to those types.</p>
-</div>
-<div class="paragraph">
-<p>Here are the following actions available on address mappings:</p>
-</div>
-<div class="sect3">
-<h4 id="_add_an_address_mapping"><a class="anchor" href="#_add_an_address_mapping"></a>Add an address mapping</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/mappings/address/{mappingSource}/targets/{destinationAddress}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Add an address mapping to the Recipients rewrite table
-Mapping source is the value of {mappingSource} Mapping destination is
-the value of {destinationAddress} Type of mapping destination is
-Address</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Action successfully performed</p>
-</li>
-<li>
-<p>400: Invalid parameters</p>
-</li>
-<li>
-<p>409: The addition of the address mapping would lead to a loop and thus cannot be performed</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_remove_an_address_mapping"><a class="anchor" href="#_remove_an_address_mapping"></a>Remove an address mapping</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/mappings/address/{mappingSource}/targets/{destinationAddress}</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Remove an address mapping from the Recipients rewrite table</p>
-</li>
-<li>
-<p>Mapping source is the value of <code>mappingSource</code></p>
-</li>
-<li>
-<p>Mapping destination is the value of <code>destinationAddress</code></p>
-</li>
-<li>
-<p>Type of mapping destination is Address</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Action successfully performed</p>
-</li>
-<li>
-<p>400: Invalid parameters</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_list_all_mappings"><a class="anchor" href="#_list_all_mappings"></a>List all mappings</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mappings</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Get all mappings from the
-<a href="../architecture/index.html#_recipient_rewrite_tables" class="xref page">Recipients rewrite table</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response body:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "alias@domain.tld": [
- {
- "type": "Alias",
- "mapping": "user@domain.tld"
- },
- {
- "type": "Group",
- "mapping": "group-user@domain.tld"
- }
- ],
- "aliasdomain.tld": [
- {
- "type": "Domain",
- "mapping": "realdomain.tld"
- }
- ],
- "group@domain.tld": [
- {
- "type": "Address",
- "mapping": "user@domain.tld"
- }
- ]
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response code:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: OK</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_listing_user_mappings"><a class="anchor" href="#_listing_user_mappings"></a>Listing User Mappings</h3>
-<div class="paragraph">
-<p>This endpoint allows receiving all mappings of a corresponding user.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mappings/user/{userAddress}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Return all mappings of a user where:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>userAddress</code>: is the selected user</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Response body:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[
- {
- "type": "Address",
- "mapping": "user123@domain.tld"
- },
- {
- "type": "Alias",
- "mapping": "aliasuser123@domain.tld"
- },
- {
- "type": "Group",
- "mapping": "group123@domain.tld"
- }
-]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: OK</p>
-</li>
-<li>
-<p>400: Invalid parameter value</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_administrating_mail_repositories"><a class="anchor" href="#_administrating_mail_repositories"></a>Administrating mail repositories</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_create_a_mail_repository"><a class="anchor" href="#_create_a_mail_repository"></a>Create a mail repository</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/mailRepositories/{encodedPathOfTheRepository}?protocol={someProtocol}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>encodedPathOfTheRepository</code> should be the resource path
-of the created mail repository. Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/mailRepositories/mailRepo?protocol=file</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The repository is created</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_listing_mail_repositories"><a class="anchor" href="#_listing_mail_repositories"></a>Listing mail repositories</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mailRepositories</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[
- {
- "repository": "var/mail/error/",
- "path": "var%2Fmail%2Ferror%2F"
- },
- {
- "repository": "var/mail/relay-denied/",
- "path": "var%2Fmail%2Frelay-denied%2F"
- },
- {
- "repository": "var/mail/spam/",
- "path": "var%2Fmail%2Fspam%2F"
- },
- {
- "repository": "var/mail/address-error/",
- "path": "var%2Fmail%2Faddress-error%2F"
- }
-]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can use <code>id</code>, the encoded URL of the repository, to access it in
-later requests.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The list of mail repositories</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_getting_additional_information_for_a_mail_repository"><a class="anchor" href="#_getting_additional_information_for_a_mail_repository"></a>Getting additional information for a mail repository</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mailRepositories/{encodedPathOfTheRepository}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>encodedPathOfTheRepository</code> should be the resource path
-of an existing mail repository. Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mailRepositories/var%2Fmail%2Ferror%2F</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "repository": "var/mail/error/",
- "path": "mail%2Ferror%2F",
- "size": 243
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Additonnal information for that repository</p>
-</li>
-<li>
-<p>404: This repository can not be found</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_listing_mails_contained_in_a_mail_repository"><a class="anchor" href="#_listing_mails_contained_in_a_mail_repository"></a>Listing mails contained in a mail repository</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mailRepositories/{encodedPathOfTheRepository}/mails</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>encodedPathOfTheRepository</code> should be the resource path
-of an existing mail repository. Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mailRepositories/var%2Fmail%2Ferror%2F/mails</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The answer will contains all mailKey contained in that repository.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[
- "mail-key-1",
- "mail-key-2",
- "mail-key-3"
-]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note that this can be used to read mail details.</p>
-</div>
-<div class="paragraph">
-<p>You can pass additional URL parameters to this call in order to limit
-the output: - A limit: no more elements than the specified limit will be
-returned. This needs to be strictly positive. If no value is specified,
-no limit will be applied. - An offset: allow to skip elements. This
-needs to be positive. Default value is zero.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET 'http://ip:port/mailRepositories/var%2Fmail%2Ferror%2F/mails?limit=100&offset=500'</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The list of mail keys contained in that mail repository</p>
-</li>
-<li>
-<p>400: Invalid parameters</p>
-</li>
-<li>
-<p>404: This repository can not be found</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_readingdownloading_a_mail_details"><a class="anchor" href="#_readingdownloading_a_mail_details"></a>Reading/downloading a mail details</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mailRepositories/{encodedPathOfTheRepository}/mails/mailKey</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>encodedPathOfTheRepository</code> should be the resource path
-of an existing mail repository. Resource name <code>mailKey</code> should be the
-key of a mail stored in that repository. Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mailRepositories/var%2Fmail%2Ferror%2F/mails/mail-key-1</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If the Accept header in the request is ``application/json'', then the
-response looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "name": "mail-key-1",
- "sender": "sender@domain.com",
- "recipients": ["recipient1@domain.com", "recipient2@domain.com"],
- "state": "address-error",
- "error": "A small message explaining what happened to that mail...",
- "remoteHost": "111.222.333.444",
- "remoteAddr": "127.0.0.1",
- "lastUpdated": null
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If the Accept header in the request is ``message/rfc822'', then the
-response will be the <em>eml</em> file itself.</p>
-</div>
-<div class="paragraph">
-<p>Additional query parameter <code>additionalFields</code> add the existing
-information to the response for the supported values (only work with
-``application/json'' Accept header):</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>attributes</p>
-</li>
-<li>
-<p>headers</p>
-</li>
-<li>
-<p>textBody</p>
-</li>
-<li>
-<p>htmlBody</p>
-</li>
-<li>
-<p>messageSize</p>
-</li>
-<li>
-<p>perRecipientsHeaders</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mailRepositories/file%3A%2F%2Fvar%2Fmail%2Ferror%2F/mails/mail-key-1?additionalFields=attributes,headers,textBody,htmlBody,messageSize,perRecipientsHeaders</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Give the following kind of response:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "name": "mail-key-1",
- "sender": "sender@domain.com",
- "recipients": ["recipient1@domain.com", "recipient2@domain.com"],
- "state": "address-error",
- "error": "A small message explaining what happened to that mail...",
- "remoteHost": "111.222.333.444",
- "remoteAddr": "127.0.0.1",
- "lastUpdated": null,
- "attributes": {
- "name2": "value2",
- "name1": "value1"
- },
- "perRecipientsHeaders": {
- "third@party": {
- "headerName1": [
- "value1",
- "value2"
- ],
- "headerName2": [
- "value3",
- "value4"
- ]
- }
- },
- "headers": {
- "headerName4": [
- "value6",
- "value7"
- ],
- "headerName3": [
- "value5",
- "value8"
- ]
- },
- "textBody": "My body!!",
- "htmlBody": "My <em>body</em>!!",
- "messageSize": 42424242
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Details of the mail</p>
-</li>
-<li>
-<p>404: This repository or mail can not be found</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_removing_a_mail_from_a_mail_repository"><a class="anchor" href="#_removing_a_mail_from_a_mail_repository"></a>Removing a mail from a mail repository</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/mailRepositories/{encodedPathOfTheRepository}/mails/mailKey</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>encodedPathOfTheRepository</code> should be the resource path
-of an existing mail repository. Resource name <code>mailKey</code> should be the
-key of a mail stored in that repository. Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/mailRepositories/var%2Fmail%2Ferror%2F/mails/mail-key-1</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: This mail no longer exists in this repository</p>
-</li>
-<li>
-<p>404: This repository can not be found</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_removing_all_mails_from_a_mail_repository"><a class="anchor" href="#_removing_all_mails_from_a_mail_repository"></a>Removing all mails from a mail repository</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/mailRepositories/{encodedPathOfTheRepository}/mails</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>encodedPathOfTheRepository</code> should be the resource path
-of an existing mail repository. Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/mailRepositories/var%2Fmail%2Ferror%2F/mails</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Task generation succeeded. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>404: Could not find that mail repository</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>clear-mail-repository</code>
-and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "mailRepositoryPath":"var/mail/error/",
- "initialCount": 243,
- "remainingCount": 17
-}</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_reprocessing_mails_from_a_mail_repository"><a class="anchor" href="#_reprocessing_mails_from_a_mail_repository"></a>Reprocessing mails from a mail repository</h3>
-<div class="paragraph">
-<p>Sometime, you want to re-process emails stored in a mail repository. For
-instance, you can make a configuration error, or there can be a James
-bug that makes processing of some mails fail. Those mail will be stored
-in a mail repository. Once you solved the problem, you can reprocess
-them.</p>
-</div>
-<div class="paragraph">
-<p>To reprocess mails from a repository:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPATCH http://ip:port/mailRepositories/{encodedPathOfTheRepository}/mails?action=reprocess</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>encodedPathOfTheRepository</code> should be the resource path
-of an existing mail repository. Example:</p>
-</div>
-<div class="paragraph">
-<p>For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPATCH http://ip:port/mailRepositories/var%2Fmail%2Ferror%2F/mails?action=reprocess</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Additional query parameters are supported:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>queue</code> allows you to
-target the mail queue you want to enqueue the mails in. Defaults to
-<code>spool</code>.</p>
-</li>
-<li>
-<p><code>processor</code> allows you to overwrite the state of the
-reprocessing mails, and thus select the processors they will start their
-processing in. Defaults to the <code>state</code> field of each processed email.</p>
-</li>
-<li>
-<p><code>consume</code> (boolean defaulting to <code>true</code>) whether the reprocessing should consume the mail in its originating mail repository. Passing
-this value to <code>false</code> allows non destructive reprocessing as you keep a copy of the email in the mail repository and can be valuable
-when debugging.</p>
-</li>
-<li>
-<p><code>limit</code> (integer value. Optional, default is empty). It enables to limit the count of elements reprocessed.
-If unspecified the count of the processed elements is unbounded.</p>
-</li>
-<li>
-<p><code>maxRetries</code> Optional integer, defaults to no max retries limit. Only processed emails that had been retried less
-than this value. Ignored by default.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>redeliver_group_events</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPATCH 'http://ip:port/mailRepositories/var%2Fmail%2Ferror%2F/mails?action=reprocess&processor=transport&queue=spool'</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note that the <code>action</code> query parameter is compulsary and can only take
-value <code>reprocess</code>.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Task generation succeeded. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>404: Could not find that mail repository</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>reprocessing-all</code> and
-the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "mailRepositoryPath":"var/mail/error/",
- "targetQueue":"spool",
- "targetProcessor":"transport",
- "initialCount": 243,
- "remainingCount": 17
-}</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_reprocessing_a_specific_mail_from_a_mail_repository"><a class="anchor" href="#_reprocessing_a_specific_mail_from_a_mail_repository"></a>Reprocessing a specific mail from a mail repository</h3>
-<div class="paragraph">
-<p>To reprocess a specific mail from a mail repository:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPATCH http://ip:port/mailRepositories/{encodedPathOfTheRepository}/mails/mailKey?action=reprocess</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>encodedPathOfTheRepository</code> should be the resource id of
-an existing mail repository. Resource name <code>mailKey</code> should be the key
-of a mail stored in that repository. Example:</p>
-</div>
-<div class="paragraph">
-<p>For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPATCH http://ip:port/mailRepositories/var%2Fmail%2Ferror%2F/mails/name1?action=reprocess</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Additional query parameters are supported:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>queue</code> allows you to
-target the mail queue you want to enqueue the mails in. Defaults to
-<code>spool</code>.</p>
-</li>
-<li>
-<p><code>processor</code> allows you to overwrite the state of the
-reprocessing mails, and thus select the processors they will start their
-processing in. Defaults to the <code>state</code> field of each processed email.</p>
-</li>
-<li>
-<p><code>consume</code> (boolean defaulting to <code>true</code>) whether the reprocessing should consume the mail in its originating mail repository. Passing
-this value to <code>false</code> allows non destructive reprocessing as you keep a copy of the email in the mail repository and can be valuable
-when debugging.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>While <code>processor</code> being an optional parameter, not specifying it will
-result reprocessing the mails in their current state
-(<a href="https://james.apache.org/server/feature-mailetcontainer.html#Processors">see
-documentation about processors and state</a>). Consequently, only few cases
-will give a different result, definitively storing them out of the mail
-repository.</p>
-</div>
-<div class="paragraph">
-<p>For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPATCH 'http://ip:port/mailRepositories/var%2Fmail%2Ferror%2F/mails/name1?action=reprocess&processor=transport&queue=spool'</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note that the <code>action</code> query parameter is compulsary and can only take
-value <code>reprocess</code>.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Task generation succeeded. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>404: Could not find that mail repository</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>reprocessing-one</code> and
-the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "mailRepositoryPath":"var/mail/error/",
- "targetQueue":"spool",
- "targetProcessor":"transport",
- "mailKey":"name1"
-}</pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_administrating_mail_queues"><a class="anchor" href="#_administrating_mail_queues"></a>Administrating mail queues</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_listing_mail_queues"><a class="anchor" href="#_listing_mail_queues"></a>Listing mail queues</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mailQueues</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>["outgoing","spool"]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The list of mail queues</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_getting_a_mail_queue_details"><a class="anchor" href="#_getting_a_mail_queue_details"></a>Getting a mail queue details</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mailQueues/{mailQueueName}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>mailQueueName</code> is the name of a mail queue, this command
-will return the details of the given mail queue. For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"name":"outgoing","size":0}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success</p>
-</li>
-<li>
-<p>400: Mail queue is not valid</p>
-</li>
-<li>
-<p>404: The mail queue does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_listing_the_mails_of_a_mail_queue"><a class="anchor" href="#_listing_the_mails_of_a_mail_queue"></a>Listing the mails of a mail queue</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mailQueues/{mailQueueName}/mails</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Additional URL query parameters:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>limit</code>: Maximum number of mails returned in a single call. Only
-strictly positive integer values are accepted. Example:</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mailQueues/{mailQueueName}/mails?limit=100</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[{
- "name": "Mail1516976156284-8b3093b9-eebf-4c40-9c26-1450f4fcdc3c-to-test.com",
- "sender": "user@james.linagora.com",
- "recipients": ["someone@test.com"],
- "nextDelivery": "1969-12-31T23:59:59.999Z"
-}]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success</p>
-</li>
-<li>
-<p>400: Mail queue is not valid or limit is invalid</p>
-</li>
-<li>
-<p>404: The mail queue does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_deleting_mails_from_a_mail_queue"><a class="anchor" href="#_deleting_mails_from_a_mail_queue"></a>Deleting mails from a mail queue</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/mailQueues/{mailQueueName}/mails?sender=senderMailAddress</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>This request should have exactly one query parameter from the following
-list:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>sender: which is a mail address (i.e. <a href="mailto:sender@james.org">sender@james.org</a>)</p>
-</li>
-<li>
-<p>name: which is a string</p>
-</li>
-<li>
-<p>recipient: which is a mail address (i.e. <a href="mailto:recipient@james.org">recipient@james.org</a>)</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The mails from the given mail queue matching the query parameter will be
-deleted.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Task generation succeeded. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Invalid request</p>
-</li>
-<li>
-<p>404: The mail queue does not exist</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type
-<code>delete-mails-from-mail-queue</code> and the following
-<code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "queue":"outgoing",
- "initialCount":10,
- "remainingCount": 5,
- "sender": "sender@james.org",
- "name": "Java Developer",
- "recipient: "recipient@james.org"
-}</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_clearing_a_mail_queue"><a class="anchor" href="#_clearing_a_mail_queue"></a>Clearing a mail queue</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/mailQueues/{mailQueueName}/mails</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>All mails from the given mail queue will be deleted.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Task generation succeeded. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Invalid request</p>
-</li>
-<li>
-<p>404: The mail queue does not exist</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>clear-mail-queue</code> and
-the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "queue":"outgoing",
- "initialCount":10,
- "remainingCount": 0
-}</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_flushing_mails_from_a_mail_queue"><a class="anchor" href="#_flushing_mails_from_a_mail_queue"></a>Flushing mails from a mail queue</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPATCH http://ip:port/mailQueues/{mailQueueName}?delayed=true \
- -d '{"delayed": false}' \
- -H "Content-Type: application/json"</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>This request should have the query parameter <em>delayed</em> set to <em>true</em>, in
-order to indicate only delayed mails are affected. The payload should
-set the <code>delayed</code> field to false inorder to remove the delay. This is
-the only supported combination, and it performs a flush.</p>
-</div>
-<div class="paragraph">
-<p>The mails delayed in the given mail queue will be flushed.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Success (No content)</p>
-</li>
-<li>
-<p>400: Invalid request</p>
-</li>
-<li>
-<p>404: The mail queue does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_rabbitmq_republishing_a_mail_queue_from_cassandra"><a class="anchor" href="#_rabbitmq_republishing_a_mail_queue_from_cassandra"></a>RabbitMQ republishing a mail queue from cassandra</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST 'http://ip:port/mailQueues/{mailQueueName}?action=RepublishNotProcessedMails&olderThan=1d'</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>This method is specific to the distributed flavor of James, which relies
-on Cassandra and RabbitMQ for implementing a mail queue. In case of a
-RabbitMQ crash resulting in a loss of messages, this task can be
-launched to repopulate the <code>mailQueueName</code> queue in RabbitMQ using the
-information stored in Cassandra.</p>
-</div>
-<div class="paragraph">
-<p>The <code>olderThan</code> parameter is mandatory. It filters the mails to be
-restored, by taking into account only the mails older than the given
-value. The expected value should be expressed in the following format:
-<code>Nunit</code>. <code>N</code> should be strictly positive. <code>unit</code> could be either in the
-short form (<code>h</code>, <code>d</code>, <code>w</code>, etc.), or in the long form (<code>day</code>, <code>week</code>,
-<code>month</code>, etc.).</p>
-</div>
-<div class="paragraph">
-<p>Examples:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>5h</code></p>
-</li>
-<li>
-<p><code>7d</code></p>
-</li>
-<li>
-<p><code>1y</code></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Task created</p>
-</li>
-<li>
-<p>400: Invalid request</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The response body contains the id of the republishing task.
-<code>{ "taskId": "a650a66a-5984-431e-bdad-f1baad885856" }</code></p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_cassandra_view_of_the_rabbitmq_mailqueue_browse_start_update"><a class="anchor" href="#_cassandra_view_of_the_rabbitmq_mailqueue_browse_start_update"></a>Cassandra view of the RabbitMQ mailQueue: browse start update</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST 'http://ip:port/mailQueues/{mailQueueName}?action=updateBrowseStart</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return a task that updates the browse start of the aforementioned mailQueue, regardless of the configuration.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>This is an advanced, potentially expensive operation which requires a good understanding of the RabbitMQMailQueue design
-(<a href="https://github.com/apache/james-project/blob/master/src/adr/0031-distributed-mail-queue.md" class="bare">https://github.com/apache/james-project/blob/master/src/adr/0031-distributed-mail-queue.md</a>). Especially, care needs to
-be taken to call this at most once per slice (not doing so might be expensive).</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_sending_email_over_webadmin"><a class="anchor" href="#_sending_email_over_webadmin"></a>Sending email over webAdmin</h2>
-<div class="sectionbody">
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /mail-transfer-service
-
-{MIME message}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will send the following email to the recipients specified in the MIME message.</p>
-</div>
-<div class="paragraph">
-<p>The <code>{MIME message}</code> payload must match <code>message/rfc822</code> format.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_event_dead_letter"><a class="anchor" href="#_event_dead_letter"></a>Event Dead Letter</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The EventBus allows to register `group listeners' that are called in a
-distributed fashion. These group listeners enable the implementation of
-some advanced mailbox manager feature like indexing, spam reporting,
-quota management and the like.</p>
-</div>
-<div class="paragraph">
-<p>Upon exceptions, a bounded number of retries are performed (with
-exponential backoff delays). If after those retries the listener is
-still failing, then the event will be stored in the ``Event Dead
-Letter''. This API allows diagnosing issues, as well as performing event
-replay.</p>
-</div>
-<div class="sect2">
-<h3 id="_listing_mailbox_listener_groups"><a class="anchor" href="#_listing_mailbox_listener_groups"></a>Listing mailbox listener groups</h3>
-<div class="paragraph">
-<p>This endpoint allows discovering the list of mailbox listener groups.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/events/deadLetter/groups</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return a list of group names that can be further used to interact
-with the dead letter API:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>["org.apache.james.mailbox.events.EventBusTestFixture$GroupA", "org.apache.james.mailbox.events.GenericGroup-abc"]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success. A list of group names is returned.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_listing_failed_events"><a class="anchor" href="#_listing_failed_events"></a>Listing failed events</h3>
-<div class="paragraph">
-<p>This endpoint allows listing failed events for a given group:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/events/deadLetter/groups/org.apache.james.mailbox.events.EventBusTestFixture$GroupA</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return a list of insertionIds:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>["6e0dd59d-660e-4d9b-b22f-0354479f47b4", "58a8f59d-660e-4d9b-b22f-0354486322a2"]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success. A list of insertion ids is returned.</p>
-</li>
-<li>
-<p>400: Invalid group name</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_getting_event_details"><a class="anchor" href="#_getting_event_details"></a>Getting event details</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/events/deadLetter/groups/org.apache.james.mailbox.events.EventBusTestFixture$GroupA/6e0dd59d-660e-4d9b-b22f-0354479f47b4</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the full JSON associated with this event.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success. A JSON representing this event is returned.</p>
-</li>
-<li>
-<p>400: Invalid group name or <code>insertionId</code></p>
-</li>
-<li>
-<p>404: No event with this <code>insertionId</code></p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_deleting_an_event"><a class="anchor" href="#_deleting_an_event"></a>Deleting an event</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/events/deadLetter/groups/org.apache.james.mailbox.events.EventBusTestFixture$GroupA/6e0dd59d-660e-4d9b-b22f-0354479f47b4</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will delete this event.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Success</p>
-</li>
-<li>
-<p>400: Invalid group name or <code>insertionId</code></p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_deleting_all_events_of_a_group"><a class="anchor" href="#_deleting_all_events_of_a_group"></a>Deleting all events of a group</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/events/deadLetter/groups/org.apache.james.mailbox.events.EventBusTestFixture$GroupA</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will delete all events of this group.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Success</p>
-</li>
-<li>
-<p>400: Invalid group name</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_redeliver_all_events"><a class="anchor" href="#_redeliver_all_events"></a>Redeliver all events</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/events/deadLetter?action=reDeliver</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Additional query parameters are supported:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>limit</code> (integer value. Optional, default is empty). It enables to limit the count of elements redelivered.
-If unspecified the count of the processed elements is unbounded</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/events/deadLetter?action=reDeliver&limit=10</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will create a task that will attempt to redeliver all events stored in
-<code>Event Dead Letter''. If successful, redelivered events will then be
-removed from </code>Dead Letter''.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: the taskId of the created task</p>
-</li>
-<li>
-<p>400: Invalid action argument</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_redeliver_group_events"><a class="anchor" href="#_redeliver_group_events"></a>Redeliver group events</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/events/deadLetter/groups/org.apache.james.mailbox.events.EventBusTestFixture$GroupA?action=reDeliver</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will create a task that will attempt to redeliver all events of a
-particular group stored in <code>Event Dead Letter''. If successful,
-redelivered events will then be removed from </code>Dead Letter''.</p>
-</div>
-<div class="paragraph">
-<p>Additional query parameters are supported:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>limit</code> (integer value. Optional, default is empty). It enables to limit the count of elements redelivered.
-If unspecified the count of the processed elements is unbounded</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/events/deadLetter/groups/org.apache.james.mailbox.events.EventBusTestFixture$GroupA?action=reDeliver&limit=10</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: the taskId of the created task</p>
-</li>
-<li>
-<p>400: Invalid group name or action argument</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_redeliver_a_single_event"><a class="anchor" href="#_redeliver_a_single_event"></a>Redeliver a single event</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/events/deadLetter/groups/org.apache.james.mailbox.events.EventBusTestFixture$GroupA/6e0dd59d-660e-4d9b-b22f-0354479f47b4?action=reDeliver</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will create a task that will attempt to redeliver a single event of a
-particular group stored in <code>Event Dead Letter''. If successful,
-redelivered event will then be removed from </code>Dead Letter''.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: the taskId of the created task</p>
-</li>
-<li>
-<p>400: Invalid group name, insertion id or action argument</p>
-</li>
-<li>
-<p>404: No event with this insertionId</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_cassandra_extra_operations"><a class="anchor" href="#_cassandra_extra_operations"></a>Cassandra extra operations</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Some webadmin features to manage some extra operations on Cassandra
-tables, like solving inconsistencies on projection tables. Such
-inconsistencies can be for example created by a fail of the DAO to add a
-mapping into
-’mappings_sources`, while it was successful regarding the`rrt` table.</p>
-</div>
-<div class="sect2">
-<h3 id="_operations_on_mappings_sources"><a class="anchor" href="#_operations_on_mappings_sources"></a>Operations on mappings sources</h3>
-<div class="paragraph">
-<p>You can do a series of action on <code>mappings_sources</code> projection table :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /cassandra/mappings?action={action}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the taskId corresponding to the related task. Actions
-supported so far are :</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>SolveInconsistencies : cleans up first all the mappings in
-<code>mappings_sources</code> index and then repopulate it correctly. In the
-meantime, listing sources of a mapping might create temporary
-inconsistencies during the process.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>For example :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /cassandra/mappings?action=SolveInconsistencies</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes :</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: the taskId of the created task</p>
-</li>
-<li>
-<p>400: Invalid action argument for performing operation on mappings data</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_cassandra_schema_upgrades"><a class="anchor" href="#_cassandra_schema_upgrades"></a>Cassandra Schema upgrades</h3>
-<div class="paragraph">
-<p>Cassandra upgrades implies the creation of a new table. Thus restarting
-James is needed, as new tables are created on restart.</p>
-</div>
-<div class="paragraph">
-<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>
-</div>
-<div class="paragraph">
-<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>
-</div>
-<div class="paragraph">
-<p>These schema updates can be triggered by webadmin using the Cassandra
-backend.</p>
-</div>
-<div class="paragraph">
-<p>Note that currently the progress can be tracked by logs.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="#<em>retrieving_current_cassandra_schema_version</em>">Retrieving current
-Cassandra schema version</a></p>
-</li>
-<li>
-<p><a href="#<em>retrieving_latest_available_cassandra_schema_version</em>">Retrieving
-latest available Cassandra schema version</a></p>
-</li>
-<li>
-<p><a href="#<em>upgrading_to_a_specific_version</em>">Upgrading to a specific version</a></p>
-</li>
-<li>
-<p><a href="#<em>upgrading_to_the_latest_version</em>">Upgrading to the latest version</a></p>
-</li>
-</ul>
-</div>
-<div class="sect3">
-<h4 id="_retrieving_current_cassandra_schema_version"><a class="anchor" href="#_retrieving_current_cassandra_schema_version"></a>Retrieving current Cassandra schema version</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/cassandra/version</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"version": 2}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Where the number corresponds to the current schema version of the
-database you are using.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_retrieving_latest_available_cassandra_schema_version"><a class="anchor" href="#_retrieving_latest_available_cassandra_schema_version"></a>Retrieving latest available Cassandra schema version</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/cassandra/version/latest</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"version": 3}</pre>
-</div>
-</div>
-<div class="paragraph">
-<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>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_upgrading_to_a_specific_version"><a class="anchor" href="#_upgrading_to_a_specific_version"></a>Upgrading to a specific version</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST -H "Content-Type: application/json http://ip:port/cassandra/version/upgrade -d '3'</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule the run of the migrations you need to reach schema version
-3.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success. The scheduled task <code>taskId</code> is returned.</p>
-</li>
-<li>
-<p>400: The version is invalid. The version should be a strictly positive
-number.</p>
-</li>
-<li>
-<p>410: Error while planning this migration. This resource is gone away.
-Reason is mentionned in the body.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Note that several calls to this endpoint will be run in a sequential
-pattern.</p>
-</div>
-<div class="paragraph">
-<p>If the server restarts during the migration, the migration is silently
-aborted.</p>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>cassandra-migration</code>
-and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"targetVersion":3}</pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_upgrading_to_the_latest_version"><a class="anchor" href="#_upgrading_to_the_latest_version"></a>Upgrading to the latest version</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/cassandra/version/upgrade/latest</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule the run of the migrations you need to reach the latest
-schema version.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success. The scheduled task <code>taskId</code> is returned.</p>
-</li>
-<li>
-<p>410: Error while planning this migration. This resource is gone away.
-Reason is mentionned in the body.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Note that several calls to this endpoint will be run in a sequential
-pattern.</p>
-</div>
-<div class="paragraph">
-<p>If the server restarts during the migration, the migration is silently
-aborted.</p>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>cassandra-migration</code>
-and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"toVersion":2}</pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_correcting_ghost_mailbox"><a class="anchor" href="#_correcting_ghost_mailbox"></a>Correcting ghost mailbox</h3>
-<div class="paragraph">
-<p>This is a temporary workaround for the <strong>Ghost mailbox</strong> bug encountered
-using the Cassandra backend, as described in MAILBOX-322.</p>
-</div>
-<div class="paragraph">
-<p>You can use the mailbox merging feature in order to merge the old
-``ghosted'' mailbox with the new one.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/cassandra/mailbox/merging \
- -d '{"mergeOrigin":"{id1}", "mergeDestination":"{id2}"}' \
- -H "Content-Type: application/json"</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will scedule a task for :</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Delete references to <code>id1</code> mailbox</p>
-</li>
-<li>
-<p>Move it’s messages into <code>id2</code> mailbox</p>
-</li>
-<li>
-<p>Union the rights of both mailboxes</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Task generation succeeded. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Unable to parse the body.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>mailbox-merging</code> and
-the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "oldMailboxId":"5641376-02ed-47bd-bcc7-76ff6262d92a",
- "newMailboxId":"4555159-52ae-895f-ccb7-586a4412fb50",
- "totalMessageCount": 1,
- "messageMovedCount": 1,
- "messageFailedCount": 0
-}</pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_deleted_messages_vault"><a class="anchor" href="#_deleted_messages_vault"></a>Deleted Messages Vault</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The `Deleted Message Vault plugin' allows you to keep users deleted
-messages during a given retention time. This set of routes allow you to
-<em>restore</em> users deleted messages or export them in an archive.</p>
-</div>
-<div class="paragraph">
-<p>To move deleted messages in the vault, you need to specifically
-configure the DeletedMessageVault PreDeletionHook.</p>
-</div>
-<div class="sect2">
-<h3 id="_restore_deleted_messages"><a class="anchor" href="#_restore_deleted_messages"></a>Restore Deleted Messages</h3>
-<div class="paragraph">
-<p>Deleted messages of a specific user can be restored by calling the
-following endpoint:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/deletedMessages/users/userToRestore@domain.ext?action=restore
-
-{
- "combinator": "and",
- "criteria": [
- {
- "fieldName": "subject",
- "operator": "containsIgnoreCase",
- "value": "Apache James"
- },
- {
- "fieldName": "deliveryDate",
- "operator": "beforeOrEquals",
- "value": "2014-10-30T14:12:00Z"
- },
- {
- "fieldName": "deletionDate",
- "operator": "afterOrEquals",
- "value": "2015-10-20T09:08:00Z"
- },
- {
- "fieldName": "recipients","
- "operator": "contains","
- "value": "recipient@james.org"
- },
- {
- "fieldName": "hasAttachment",
- "operator": "equals",
- "value": "false"
- },
- {
- "fieldName": "sender",
- "operator": "equals",
- "value": "sender@apache.org"
- },
- {
- "fieldName": "originMailboxes",
- "operator": "contains",
- "value": "02874f7c-d10e-102f-acda-0015176f7922"
- }
- ]
-};</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The requested Json body is made from a list of criterion objects which
-have the following structure:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "fieldName": "supportedFieldName",
- "operator": "supportedOperator",
- "value": "A plain string representing the matching value of the corresponding field"
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Deleted Messages which are matched with the <strong>all</strong> criterion in the query
-body will be restored. Here are a list of supported fieldName for the
-restoring:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>subject: represents for deleted message <code>subject</code> field matching.
-Supports below string operators:</p>
-<div class="ulist">
-<ul>
-<li>
-<p>contains</p>
-</li>
-<li>
-<p>containsIgnoreCase</p>
-</li>
-<li>
-<p>equals</p>
-</li>
-<li>
-<p>equalsIgnoreCase</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p>deliveryDate: represents for deleted message <code>deliveryDate</code> field
-matching. Tested value should follow the right date time with zone
-offset format (ISO-8601) like <code>2008-09-15T15:53:00+05:00</code> or
-<code>2008-09-15T15:53:00Z</code> Supports below date time operators:</p>
-<div class="ulist">
-<ul>
-<li>
-<p>beforeOrEquals: is the deleted message’s <code>deliveryDate</code> before or
-equals the time of tested value.</p>
-</li>
-<li>
-<p>afterOrEquals: is the deleted message’s <code>deliveryDate</code> after or
-equals the time of tested value</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p>deletionDate: represents for deleted message <code>deletionDate</code> field
-matching. Tested value & Supports operators: similar to <code>deliveryDate</code></p>
-</li>
-<li>
-<p>sender: represents for deleted message <code>sender</code> field matching. Tested
-value should be a valid mail address. Supports mail address operator:</p>
-<div class="ulist">
-<ul>
-<li>
-<p>equals: does the tested sender equal to the sender of the tested
-deleted message ?<br></p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p>recipients: represents for deleted message <code>recipients</code> field
-matching. Tested value should be a valid mail address. Supports list
-mail address operator:</p>
-<div class="ulist">
-<ul>
-<li>
-<p>contains: does the tested deleted message’s recipients contain tested
-recipient ?</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p>hasAttachment: represents for deleted message <code>hasAttachment</code> field
-matching. Tested value could be <code>false</code> or <code>true</code>. Supports boolean
-operator:</p>
-<div class="ulist">
-<ul>
-<li>
-<p>equals: does the tested deleted message’s hasAttachment property
-equal to the tested hasAttachment value?</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p>originMailboxes: represents for deleted message <code>originMailboxes</code>
-field matching. Tested value is a string serialized of mailbox id.
-Supports list mailbox id operators:</p>
-<div class="ulist">
-<ul>
-<li>
-<p>contains: does the tested deleted message’s originMailbox ids contain
-tested mailbox id ?</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Messages in the Deleted Messages Vault of a specified user that are
-matched with Query Json Object in the body will be appended to his
-`Restored-Messages' mailbox, which will be created if needed.</p>
-</div>
-<div class="paragraph">
-<p><strong>Note</strong>:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Query parameter <code>action</code> is required and should have the value
-<code>restore</code> to represent the restoring feature. Otherwise, a bad request
-response will be returned</p>
-</li>
-<li>
-<p>Query parameter <code>action</code> is case sensitive</p>
-</li>
-<li>
-<p>fieldName & operator passed to the routes are case sensitive</p>
-</li>
-<li>
-<p>Currently, we only support query combinator <code>and</code> value, otherwise,
-requests will be rejected</p>
-</li>
-<li>
-<p>If you only want to restore by only one criterion, the json body could
-be simplified to a single criterion:</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "fieldName": "subject",
- "operator": "containsIgnoreCase",
- "value": "Apache James"
-}</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>For restoring all deleted messages, passing a query json with an empty
-criterion list to represent <code>matching all deleted messages</code>:</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "combinator": "and",
- "criteria": []
-}</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>For limiting the number of restored messages, you can use the <code>limit</code> query property:</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "combinator": "and",
- "limit": 99
- "criteria": []
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>Warning</strong>: Current web-admin uses <code>US</code> locale as the default. Therefore,
-there might be some conflicts when using String <code>containsIgnoreCase</code>
-comparators to apply on the String data of other special locales stored
-in the Vault. More details at
-<a href="https://issues.apache.org/jira/browse/MAILBOX-384">JIRA</a></p>
-</div>
-<div class="paragraph">
-<p>Response code:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Task for restoring deleted has been created</p>
-</li>
-<li>
-<p>400: Bad request:</p>
-<div class="ulist">
-<ul>
-<li>
-<p>action query param is not present</p>
-</li>
-<li>
-<p>action query param is not a valid action</p>
-</li>
-<li>
-<p>user parameter is invalid</p>
-</li>
-<li>
-<p>can not parse the JSON body</p>
-</li>
-<li>
-<p>Json query object contains unsupported operator, fieldName</p>
-</li>
-<li>
-<p>Json query object values violate parsing rules</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p>404: User not found</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type
-<code>deleted-messages-restore</code> and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "successfulRestoreCount": 47,
- "errorRestoreCount": 0,
- "user": "userToRestore@domain.ext"
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>while:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>successfulRestoreCount: number of restored messages</p>
-</li>
-<li>
-<p>errorRestoreCount: number of messages that failed to restore</p>
-</li>
-<li>
-<p>user: owner of deleted messages need to restore</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_export_deleted_messages"><a class="anchor" href="#_export_deleted_messages"></a>Export Deleted Messages</h3>
-<div class="paragraph">
-<p>Retrieve deleted messages matched with requested query from an user then
-share the content to a targeted mail address (exportTo)</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST 'http://ip:port/deletedMessages/users/userExportFrom@domain.ext?action=export&exportTo=userReceiving@domain.ext'
-
-BODY: is the json query has the same structure with Restore Deleted Messages section</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>Note</strong>: Json query passing into the body follows the same rules &
-restrictions like in <a href="#_restore_deleted_messages">Restore Deleted
-Messages</a></p>
-</div>
-<div class="paragraph">
-<p>Response code:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Task for exporting has been created</p>
-</li>
-<li>
-<p>400: Bad request:</p>
-<div class="ulist">
-<ul>
-<li>
-<p>exportTo query param is not present</p>
-</li>
-<li>
-<p>exportTo query param is not a valid mail address</p>
-</li>
-<li>
-<p>action query param is not present</p>
-</li>
-<li>
-<p>action query param is not a valid action</p>
-</li>
-<li>
-<p>user parameter is invalid</p>
-</li>
-<li>
-<p>can not parse the JSON body</p>
-</li>
-<li>
-<p>Json query object contains unsupported operator, fieldName</p>
-</li>
-<li>
-<p>Json query object values violate parsing rules</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p>404: User not found</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type
-<code>deleted-messages-export</code> and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "userExportFrom": "userToRestore@domain.ext",
- "exportTo": "userReceiving@domain.ext",
- "totalExportedMessages": 1432
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>while:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>userExportFrom: export deleted messages from this user</p>
-</li>
-<li>
-<p>exportTo: content of deleted messages have been shared to this mail
-address</p>
-</li>
-<li>
-<p>totalExportedMessages: number of deleted messages match with
-json query, then being shared to sharee.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_purge_deleted_messages"><a class="anchor" href="#_purge_deleted_messages"></a>Purge Deleted Messages</h3>
-<div class="paragraph">
-<p>You can overwrite `retentionPeriod' configuration in
-`deletedMessageVault' configuration file or use the default value of 1
-year.</p>
-</div>
-<div class="paragraph">
-<p>Purge all deleted messages older than the configured `retentionPeriod'</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/deletedMessages?scope=expired</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response code:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Task for purging has been created</p>
-</li>
-<li>
-<p>400: Bad request:</p>
-<div class="ulist">
-<ul>
-<li>
-<p>action query param is not present</p>
-</li>
-<li>
-<p>action query param is not a valid action</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>You may want to call this endpoint on a regular basis.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_permanently_remove_deleted_message"><a class="anchor" href="#_permanently_remove_deleted_message"></a>Permanently Remove Deleted Message</h3>
-<div class="paragraph">
-<p>Delete a Deleted Message with <code>MessageId</code></p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/deletedMessages/users/user@domain.ext/messages/3294a976-ce63-491e-bd52-1b6f465ed7a2</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response code:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Task for deleting message has been created</p>
-</li>
-<li>
-<p>400: Bad request:</p>
-<div class="ulist">
-<ul>
-<li>
-<p>user parameter is invalid</p>
-</li>
-<li>
-<p>messageId parameter is invalid</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p>404: User not found</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type
-<code>deleted-messages-delete</code> and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> {
- "userName": "user@domain.ext",
- "messageId": "3294a976-ce63-491e-bd52-1b6f465ed7a2"
- }</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>while: - user: delete deleted messages from this user - deleteMessageId:
-messageId of deleted messages will be delete</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_administrating_dlp_configuration"><a class="anchor" href="#_administrating_dlp_configuration"></a>Administrating DLP Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>DLP (stands for Data Leak Prevention) is supported by James. A DLP
-matcher will, on incoming emails, execute regular expressions on email
-sender, recipients or content, in order to report suspicious emails to
-an administrator. WebAdmin can be used to manage these DLP rules on a
-per <code>senderDomain</code> basis.</p>
-</div>
-<div class="paragraph">
-<p><code>senderDomain</code> is domain of the sender of incoming emails, for example:
-<code>apache.org</code>, <code>james.org</code>,… Each <code>senderDomain</code> correspond to a distinct
-DLP configuration.</p>
-</div>
-<div class="sect2">
-<h3 id="_list_dlp_configuration_by_sender_domain"><a class="anchor" href="#_list_dlp_configuration_by_sender_domain"></a>List DLP configuration by sender domain</h3>
-<div class="paragraph">
-<p>Retrieve a DLP configuration for corresponding <code>senderDomain</code>, a
-configuration contains list of configuration items</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/dlp/rules/{senderDomain}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: A list of dlp configuration items is returned</p>
-</li>
-<li>
-<p>400: Invalid <code>senderDomain</code> or payload in request</p>
-</li>
-<li>
-<p>404: The domain does not exist.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This is an example of returned body. The rules field is a list of rules
-as described below.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"rules : [
- {
- "id": "1",
- "expression": "james.org",
- "explanation": "Find senders or recipients containing james[any char]org",
- "targetsSender": true,
- "targetsRecipients": true,
- "targetsContent": false
- },
- {
- "id": "2",
- "expression": "Find senders containing apache[any char]org",
- "explanation": "apache.org",
- "targetsSender": true,
- "targetsRecipients": false,
- "targetsContent": false
- }
-]}</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_store_dlp_configuration_by_sender_domain"><a class="anchor" href="#_store_dlp_configuration_by_sender_domain"></a>Store DLP configuration by sender domain</h3>
-<div class="paragraph">
-<p>Store a DLP configuration for corresponding <code>senderDomain</code>, if any item
-of DLP configuration in the request is stored before, it will not be
-stored anymore</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/dlp/rules/{senderDomain}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The body can contain a list of DLP configuration items formed by those
-fields: - <code>id</code>(String) is mandatory, unique identifier of the
-configuration item - <code>expression</code>(String) is mandatory, regular
-expression to match contents of targets - <code>explanation</code>(String) is
-optional, description of the configuration item -
-<code>targetsSender</code>(boolean) is optional and defaults to false. If true,
-<code>expression</code> will be applied to Sender and to From headers of the mail -
-<code>targetsContent</code>(boolean) is optional and defaults to false. If true,
-<code>expression</code> will be applied to Subject headers and textual bodies
-(text/plain and text/html) of the mail - <code>targetsRecipients</code>(boolean) is
-optional and defaults to false. If true, <code>expression</code> will be applied to
-recipients of the mail</p>
-</div>
-<div class="paragraph">
-<p>This is an example of returned body. The rules field is a list of rules
-as described below.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"rules": [
- {
- "id": "1",
- "expression": "james.org",
- "explanation": "Find senders or recipients containing james[any char]org",
- "targetsSender": true,
- "targetsRecipients": true,
- "targetsContent": false
- },
- {
- "id": "2",
- "expression": "Find senders containing apache[any char]org",
- "explanation": "apache.org",
- "targetsSender": true,
- "targetsRecipients": false,
- "targetsContent": false
- }
-]}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: List of dlp configuration items is stored</p>
-</li>
-<li>
-<p>400: Invalid <code>senderDomain</code> or payload in request</p>
-</li>
-<li>
-<p>404: The domain does not exist.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_remove_dlp_configuration_by_sender_domain"><a class="anchor" href="#_remove_dlp_configuration_by_sender_domain"></a>Remove DLP configuration by sender domain</h3>
-<div class="paragraph">
-<p>Remove a DLP configuration for corresponding <code>senderDomain</code></p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/dlp/rules/{senderDomain}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: DLP configuration is removed</p>
-</li>
-<li>
-<p>400: Invalid <code>senderDomain</code> or payload in request</p>
-</li>
-<li>
-<p>404: The domain does not exist.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_fetch_a_dlp_configuration_item_by_sender_domain_and_rule_id"><a class="anchor" href="#_fetch_a_dlp_configuration_item_by_sender_domain_and_rule_id"></a>Fetch a DLP configuration item by sender domain and rule id</h3>
-<div class="paragraph">
-<p>Retrieve a DLP configuration rule for corresponding <code>senderDomain</code> and a
-<code>ruleId</code></p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/dlp/rules/{senderDomain}/rules/{ruleId}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: A dlp configuration item is returned</p>
-</li>
-<li>
-<p>400: Invalid <code>senderDomain</code> or payload in request</p>
-</li>
-<li>
-<p>404: The domain and/or the rule does not exist.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This is an example of returned body.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "id": "1",
- "expression": "james.org",
- "explanation": "Find senders or recipients containing james[any char]org",
- "targetsSender": true,
- "targetsRecipients": true,
- "targetsContent": false
-}</pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_reloading_server_certificates"><a class="anchor" href="#_reloading_server_certificates"></a>Reloading server certificates</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Certificates for TCP based protocols (IMAP, SMTP, POP3, LMTP and ManageSieve) can be updated at
-runtime, without service interuption and without closing existing connections.</p>
-</div>
-<div class="paragraph">
-<p>In order to do so:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Generate / retrieve your cryptographic materials and replace the ones specified in James configuration.</p>
-</li>
-<li>
-<p>Then call the following endpoint:</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/servers?reload-certificate</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Optional query parameters:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>port</code>: positive integer (valid port number). Only reload certificates for the specific port.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Return code:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: the certificate is reloaded</p>
-</li>
-<li>
-<p>400: Invalid request.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/run/index.html b/james-distributed-app/3.8.1/run/index.html
deleted file mode 100644
index 9869761..0000000
--- a/james-distributed-app/3.8.1/run/index.html
+++ /dev/null
@@ -1,436 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Run :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item is-current-page" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Run</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/run/index.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Run</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This sections presents guidance to all current deployment types of Distributed James Server.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_run_with_java"><a class="anchor" href="#_run_with_java"></a>Run with Java</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Build your own Apache James Distributed artifacts and start <a href="run-java.html" class="xref page">Running it directly on a Java Virtual Machine</a>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_run_with_docker"><a class="anchor" href="#_run_with_docker"></a>Run with Docker</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>We have prepared a docker-compose for Apache James to run with Cassandra & OpenSearch.</p>
-</div>
-<div class="paragraph">
-<p>You can start <a href="run-docker.html" class="xref page">Running James with few simple Docker commands</a>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_run_with_kubernetes"><a class="anchor" href="#_run_with_kubernetes"></a>Run with Kubernetes</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>A more complete - production ready deployment type.</p>
-</div>
-<div class="paragraph">
-<p>We have packed <a href="run-kubernetes.html" class="xref page">Apache James in a Helm chart</a>, parameterized most of the application resources. With it you can easily deploy and test different set of configuration on a Kubernetes Cluster.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/run/k8s-checklist.html b/james-distributed-app/3.8.1/run/k8s-checklist.html
deleted file mode 100644
index c2e55a7..0000000
--- a/james-distributed-app/3.8.1/run/k8s-checklist.html
+++ /dev/null
@@ -1,515 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Checklist :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Run</a></li>
- <li><a href="run-kubernetes.html">Run with Kubernetes</a></li>
- <li><a href="k8s-checklist.html">Deployment Checklist</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/run/k8s-checklist.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Checklist</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>There is some things that you must have before being able to run James on your Kubernetes Cluster.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_must_have"><a class="anchor" href="#_must_have"></a>MUST have</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Those are absolutely necessary if you want at least James to start without crashing.</p>
-</div>
-<div class="ulist checklist">
-<ul class="checklist">
-<li>
-<p><i class="fa fa-square-o"></i> Setup RabbitMQ and create James user in it.</p>
-</li>
-<li>
-<p><i class="fa fa-square-o"></i> Create a Kubernetes namespace for James deployment.</p>
-</li>
-<li>
-<p><i class="fa fa-square-o"></i> A <code>distributed</code> version of James image.</p>
-</li>
-<li>
-<p><i class="fa fa-square-o"></i> An ObjectStorage compatible with S3 APIs.</p>
-</li>
-<li>
-<p><i class="fa fa-square-o"></i> Configure JWT keys, keystores.</p>
-</li>
-<li>
-<p><i class="fa fa-square-o"></i> Adding the proper <code>mailetcontainer.xml</code> file with other conf files in James Helm package</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>With those you should be able to startup James for first tests without having it crashing. However it’s still not enough to have it fully functional.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_should_have"><a class="anchor" href="#_should_have"></a>Should have</h2>
-<div class="sectionbody">
-<div class="ulist checklist">
-<ul class="checklist">
-<li>
-<p><i class="fa fa-square-o"></i> Cassandra nodes deployed.</p>
-</li>
-<li>
-<p><i class="fa fa-square-o"></i> Put valid Cassandra keyspaces in the configuration.</p>
-</li>
-<li>
-<p><i class="fa fa-square-o"></i> Have an appropriate email domain (Contact your Domain Service Provider)</p>
-</li>
-<li>
-<p><i class="fa fa-square-o"></i> Create your Domain SPF and DKIM Record. See document [here](<a href="https://james.apache.org/howTo/" class="bare">https://james.apache.org/howTo/</a>)</p>
-</li>
-<li>
-<p><i class="fa fa-square-o"></i> OpenSearch nodes deployed.</p>
-</li>
-<li>
-<p><i class="fa fa-square-o"></i> DNS registered entries for JMAP, IMAP, SMTP, Webadmin.</p>
-</li>
-<li>
-<p><i class="fa fa-square-o"></i> Enable Ingress and create the secret for TLS certificate used by Ingress.</p>
-<div class="ulist">
-<ul>
-<li>
-<p>Preproduction: Usually, we use <a href="https://github.com/jetstack/cert-manager">cert-manager</a> to request a Let’s Encrypt Certificate. Remember to use the full chain certificate. You can verify that your certificate works well with <code>openssl</code> before adding
-the name of that secret to your James values.</p>
-</li>
-<li>
-<p>Production: Some certificates belonging to the client should exist already. See that with the team.</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p><i class="fa fa-square-o"></i> Change IMAP ports to NodePort if your Cloud Provider Load Balancer has short idle timeout and we need longer connections for performance reasons (and the RFC for IMAP states also we need 30 minutes for the timeout).</p>
-</li>
-<li>
-<p><i class="fa fa-square-o"></i> Use an external LB (ie. HA Proxy) to redirect traffic towards James IMAP service NodePort IPs and ports.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_after_setup_operations"><a class="anchor" href="#_after_setup_operations"></a>After setup operations</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>When all of this is working, normally your chain mail should be able to work. To check it you can:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Use a mail client (ThunderBird, Outlook, …​) to test James IMAP.</p>
-</li>
-<li>
-<p>Send a mail internally from one test account to an other.</p>
-</li>
-<li>
-<p>Send a mail from James to an external mail provider (your Gmail, Yahoo account for example).</p>
-</li>
-<li>
-<p>Send a mail from an external provider to James.</p>
-</li>
-<li>
-<p>Use services like <a href="https://www.mail-tester.com/">mail-tester</a> to check your score.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/run/k8s-logsMetrics.html b/james-distributed-app/3.8.1/run/k8s-logsMetrics.html
deleted file mode 100644
index 50a23f1..0000000
--- a/james-distributed-app/3.8.1/run/k8s-logsMetrics.html
+++ /dev/null
@@ -1,442 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Untitled :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Run</a></li>
- <li><a href="run-kubernetes.html">Run with Kubernetes</a></li>
- <li><a href="k8s-logsMetrics.html">Logs & Metrics</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/run/k8s-logsMetrics.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<div class="sect1">
-<h2 id="_logs_and_metrics"><a class="anchor" href="#_logs_and_metrics"></a>Logs and Metrics</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_logs"><a class="anchor" href="#_logs"></a>Logs</h3>
-<div class="paragraph">
-<p>James exposes its logs on the console. Then a fluent bit instance scraps
-and collects them, before being indexed and used by Kibana, with nice
-search possibilities.</p>
-</div>
-<div class="paragraph">
-<p>The way James exposes its logs on the console is defined in the
-<code>logback.xml</code> configuration file. James currently exposes logs in JSON
-format using Jackson Json formatter.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_metrics"><a class="anchor" href="#_metrics"></a>Metrics</h3>
-<div class="paragraph">
-<p>James exposes its metrics over an HTTP Webadmin endpoint, something like
-<code><a href="https://james-web-admin/metrics" class="bare">https://james-web-admin/metrics</a></code>. Those metrics can be scraped by
-Prometheus before being visualized on Grafana.</p>
-</div>
-<div class="paragraph">
-<p>This Helm chart exposes James metrics through Prometheus
-<a href="https://github.com/prometheus-operator/prometheus-operator/blob/master/Documentation/user-guides/getting-started.md#include-servicemonitors">ServiceMonitor</a>.</p>
-</div>
-<div class="paragraph">
-<p>You can import the dashboards for James metrics in Grafana defined
-<a href="https://github.com/apache/james-project/tree/master/server/grafana-reporting/prometheus-datasource">here</a>.</p>
-</div>
-<div class="paragraph">
-<p>Be aware that those dashboards still need more work, as we used to
-export metrics to Elasticsearch not long ago, which required to redo all
-dashboards. Some enhancements are highly possible and encouraged.</p>
-</div>
-<div class="paragraph">
-<p>Read more about <a href="../operate/metrics.html" class="xref page">Metrics in James</a>.</p>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/run/k8s-secrets.html b/james-distributed-app/3.8.1/run/k8s-secrets.html
deleted file mode 100644
index e298a88..0000000
--- a/james-distributed-app/3.8.1/run/k8s-secrets.html
+++ /dev/null
@@ -1,524 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Untitled :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Run</a></li>
- <li><a href="run-kubernetes.html">Run with Kubernetes</a></li>
- <li><a href="k8s-secrets.html">secrets.yaml</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/run/k8s-secrets.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<div class="sect1">
-<h2 id="_secrets_for_james_helm_template"><a class="anchor" href="#_secrets_for_james_helm_template"></a>Secrets for James Helm template</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Helm James has many secret values to configure before being able to use
-it correctly. Those secrets are linked to the template through their
-declaration in <code>james-secrets.yaml</code>. A sample with dumb secrets can be
-found in the <code>secrets.sample.yaml</code> file.</p>
-</div>
-<div class="paragraph">
-<p>This document presents a quick description of each secret field.</p>
-</div>
-<div class="paragraph">
-<p>For more information about encrypt/descrypt secret with Helm, see:
-<a href="https://github.com/jkroepke/helm-secrets" class="bare">https://github.com/jkroepke/helm-secrets</a></p>
-</div>
-<div class="sect2">
-<h3 id="_james_secret_values"><a class="anchor" href="#_james_secret_values"></a>James secret values</h3>
-<table class="tableblock frame-all grid-all stretch">
-<colgroup>
-<col style="width: 33.3333%;">
-<col style="width: 33.3333%;">
-<col style="width: 33.3334%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Field</th>
-<th class="tableblock halign-left valign-top">Mandatory or optional</th>
-<th class="tableblock halign-left valign-top">Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jwtPublicKey</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Mandatory</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The JWT public key used for JWT tokens.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jwtPrivateKey</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Mandatory</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The JWT private key used for JWT tokens.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandraUser</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Mandatory</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The user for Cassandra access</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandraPassword</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Mandatory</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The password fort Cassandra access</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">esUser</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The user for OpenSearch access</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">esPassword</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The password for OpenSearch access</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">dkimPrivateKey</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The private key for the generated DKIM</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">s3.endpoint</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Mandatory</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The S3 endpoint. ie:
-<a href="http://s3-us-east-1.amazonaws.com" class="bare">http://s3-us-east-1.amazonaws.com</a></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">s3.region</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Mandatory</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The region of the S3 object storage.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">s3.accessKeyId</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Mandatory</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The access key to the S3 object storage</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">s3.secretKey</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Mandatory</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The secret key to the S3 object storage</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">s3.bucketNameSuffix</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Mandatory</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">All buckets in S3 related to james
-storage start by ``james-''. This allows to have a suffix for each
-tenant</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="sect2">
-<h3 id="_jwtpublickey"><a class="anchor" href="#_jwtpublickey"></a>jwtPublicKey</h3>
-<div class="paragraph">
-<p>Use <code>openssl</code> to generate self-signed certificate and convert to Java
-Key Store JKS. You can find an example
-<a href="https://loneidealist.medium.com/generating-signing-certificates-with-openssl-and-converting-to-java-key-store-jks-3c8185dbf8fe">here</a></p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_dkim"><a class="anchor" href="#_dkim"></a>DKIM</h3>
-<div class="paragraph">
-<p>To generate DKIM, you can follow our guide:
-<a href="https://james.apache.org/howTo/dkim.html">howTo Dkim</a></p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_external_secrets"><a class="anchor" href="#_external_secrets"></a>External secrets</h3>
-<div class="paragraph">
-<p>Some declared secrets in <code>james-deployment.yaml</code> are external to the
-James configuration. They are often being created by other components
-like RabbitMQ or Cassandra. You need to have those setup before
-installing the Helm James package.</p>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/run/k8s-values.html b/james-distributed-app/3.8.1/run/k8s-values.html
deleted file mode 100644
index b7d403c..0000000
--- a/james-distributed-app/3.8.1/run/k8s-values.html
+++ /dev/null
@@ -1,817 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Untitled :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Run</a></li>
- <li><a href="run-kubernetes.html">Run with Kubernetes</a></li>
- <li><a href="k8s-values.html">values.yaml</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/run/k8s-values.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<div class="sect1">
-<h2 id="_values_for_helm_james_template"><a class="anchor" href="#_values_for_helm_james_template"></a>Values for Helm James template</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Helm James has many visible values to configure before being able to use
-it correctly. Values are injected into the deployment template as
-environment variables. An example with default values can be found in
-the <code>values.yaml</code> file.</p>
-</div>
-<div class="paragraph">
-<p>This document presents a quick description of each value field.</p>
-</div>
-<div class="sect2">
-<h3 id="_dns_values"><a class="anchor" href="#_dns_values"></a>DNS values</h3>
-<table class="tableblock frame-all grid-all stretch">
-<colgroup>
-<col style="width: 33.3333%;">
-<col style="width: 33.3333%;">
-<col style="width: 33.3334%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Field</th>
-<th class="tableblock halign-left valign-top">Default value</th>
-<th class="tableblock halign-left valign-top">Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">emailDomain</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mail.example.com</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The domain name for your tenant’s email
-addresses</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jmapUrl</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jmap.example.com</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The url for the ingress jmap endpoint</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">adminUrl</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">admin.example.com</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The url for the ingress admin endpoint</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">smtpHostname</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">smtp.example.com</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The SMTP Ehlo hostname</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="sect2">
-<h3 id="_james_values"><a class="anchor" href="#_james_values"></a>James values</h3>
-<table class="tableblock frame-all grid-all stretch">
-<colgroup>
-<col style="width: 33.3333%;">
-<col style="width: 33.3333%;">
-<col style="width: 33.3334%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Field</th>
-<th class="tableblock halign-left valign-top">Default value</th>
-<th class="tableblock halign-left valign-top">Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">replicaJmapInstanceCount</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">1</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The number of pods we deploy for James
-JMAP instance in the cluster</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">replicaImapSmtpInstanceCount</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">1</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The number of pods we deploy for James
-IMAP/SMTP instance in the cluster</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">image</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">apache/james:distributed-3.8.1</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The James image used for
-deployment (Cassandra - RabbitMQ - LDAP distributed James flavor)</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="sect2">
-<h3 id="_james_environment_values"><a class="anchor" href="#_james_environment_values"></a>James environment values</h3>
-<table class="tableblock frame-all grid-all stretch">
-<colgroup>
-<col style="width: 33.3333%;">
-<col style="width: 33.3333%;">
-<col style="width: 33.3334%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Field</th>
-<th class="tableblock halign-left valign-top">Default value</th>
-<th class="tableblock halign-left valign-top">Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jamesCassandraKeyspace</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">sandbox_james</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The keyspace used for Cassandra
-James data</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jamesCassandraCacheKeyspace</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">sandbox_james_cache</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The keyspace used for
-the Cassandra cache</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jamesEsMailboxIndex</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailbox_v1</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The index used for mailbox in
-OpenSearch. The default value should be enough, but in case you had
-issues and needed to create a new index, this will allow you to point
-James to it</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jamesEsClusterName</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">change-me</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Name of the cluster</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jamesEsHostScheme</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">http</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Only http or https are accepted</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jamesEsSslValidationStrategy</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ignore</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Choosing the SSL check strategy
-when using https scheme: <code>default</code> (use the default SSL TrustStore of
-the system), <code>ignore</code> (Ignore SSL Validation check (not recommended)),
-<code>override</code> (override the SSL Context to use a custom TrustStore
-containing ES server’s certificate)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jamesEsHostNameVerifier</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">default</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure OpenSearch rest client
-to use host name verifier during SSL handshake: <code>default</code> (using the
-default hostname verifier provided by apache http client),
-<code>accept_any_hostname</code> (accept any host (not recommended))</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jamesRabbitHost</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">change-me</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The host url for RabbitMQ used by James for
-mail processing</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jamesMessageSize</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">25M</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The default maximum size for each email is 25MB,
-Must be a positive integer, optionally with a unit: B, K, M, G.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jamesDkimSignSmtp</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">dkimselector</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">SMTP signature for DKIM, also called
-DKIM Selector</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jamesDkimSignDomain</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mail.example.com</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Domain signature for DKIM</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandraReplicationFactor</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">3</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The replication factor for Cassandra
-configuration</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jamesHELOMessage</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">change-me</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The SMTP Ehlo message</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jvmOpts</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">-Xms4g -Xmx4g</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Add the JVM_OPTIONS flag for the JVM resource
-allocation when starting James</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jamesResources.limits.cpu</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">2000m</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Limit of cpu allowed to James pod</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jamesResources.limits.memory</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">6Gi</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Limit of memory allowed to James pod</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jamesResources.requests.cpu</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">1000m</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Request of cpu allowed to James pod</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jamesResources.requests.memory</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">3Gi</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Request of memory allowed to James
-pod</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">glowroot.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Enabling or disabling Glowroot usage with
-James. It’s better to disable it for prod environments</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ingress.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Enabling or disabling Ingress. We are
-using it to expose JMAP and attach our SSL certificates for
-SMTP/IMAP/JMAP. Default is false</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ingress.ingressClassName</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">change-me</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">kubernetes.io/ingress.class is
-deprecated from Kubernetes v1.22+. Use ingressClassName instead for
-Kubernetes v1.18+</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">adminIngress.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Enabling or disabling Ingress for Web Admin.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">adminIngress.ingressClassName</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">change-me</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">kubernetes.io/ingress.class is
-deprecated from Kubernetes v1.22+. Use ingressClassName instead for
-Kubernetes v1.18+</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">james.tls.secretName</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">the-name-of-a-secret</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The name of the secret
-created separately contenting the SSL certificate for JMAP, IMAPS and
-SMTPS</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="sect2">
-<h3 id="_cassandra_values"><a class="anchor" href="#_cassandra_values"></a>Cassandra values</h3>
-<div class="paragraph">
-<p>There is two ways to deploy Cassandra in our Helm packages, defined by
-the <code>deploy</code> field.</p>
-</div>
-<div class="sect3">
-<h4 id="_as_pod"><a class="anchor" href="#_as_pod"></a>as-pod</h4>
-<div class="paragraph">
-<p>Cassandra can be deployed as pods in the cluster. Parameters for this
-mode are:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<colgroup>
-<col style="width: 33.3333%;">
-<col style="width: 33.3333%;">
-<col style="width: 33.3334%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Field</th>
-<th class="tableblock halign-left valign-top">Default value</th>
-<th class="tableblock halign-left valign-top">Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">replicaCount</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">1</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The number of Cassandra pods</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">change-me</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Namespace of Cassandra deployment</p></td>
-</tr>
-</tbody>
-</table>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-note" title="Note"></i>
-</td>
-<td class="content">
-Pod name must match template format: <code>cassandra-01.namespace:9042,cassandra-02.namespace:9042</code>
-</td>
-</tr>
-</table>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_as_ref"><a class="anchor" href="#_as_ref"></a>as-ref</h4>
-<div class="paragraph">
-<p>Cassandra has been deployed in VMs and the nodes can be accessed through
-their IP addresses. Parameters for this mode are:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<colgroup>
-<col style="width: 33.3333%;">
-<col style="width: 33.3333%;">
-<col style="width: 33.3334%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Field</th>
-<th class="tableblock halign-left valign-top">Default value</th>
-<th class="tableblock halign-left valign-top">Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ips</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">1.2.3.4, 5.6.7.8, 9.10.11.12</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The list of Cassandra IP nodes.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_opensearch_values"><a class="anchor" href="#_opensearch_values"></a>OpenSearch values</h3>
-<div class="paragraph">
-<p>There is two ways to deploy OpenSearch in our Helm packages, defined
-by the <code>deploy</code> field.</p>
-</div>
-<div class="sect3">
-<h4 id="_as_pod_2"><a class="anchor" href="#_as_pod_2"></a>as-pod</h4>
-<div class="paragraph">
-<p>OpenSearch has been deployed as pods in the cluster. Parameters for
-this mode are:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<colgroup>
-<col style="width: 33.3333%;">
-<col style="width: 33.3333%;">
-<col style="width: 33.3334%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Field</th>
-<th class="tableblock halign-left valign-top">Default value</th>
-<th class="tableblock halign-left valign-top">Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">replicaCount</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">1</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The number of OpenSearch pods</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">change-me</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Namespace of OpenSearch deployment</p></td>
-</tr>
-</tbody>
-</table>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-note" title="Note"></i>
-</td>
-<td class="content">
-Pod name must match template format: <code>opensearch-01.namespace:9200,opensearch-02.namespace:9200</code>
-</td>
-</tr>
-</table>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_as_ref_2"><a class="anchor" href="#_as_ref_2"></a>as-ref</h4>
-<div class="paragraph">
-<p>OpenSearch has been deployed in VMs and the nodes can be accessed
-through their IP addresses. Parameters for this mode are:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<colgroup>
-<col style="width: 33.3333%;">
-<col style="width: 33.3333%;">
-<col style="width: 33.3334%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Field</th>
-<th class="tableblock halign-left valign-top">Default value</th>
-<th class="tableblock halign-left valign-top">Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ips</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">1.2.3.4, 5.6.7.8, 9.10.11.12</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The list of OpenSearch IP nodes.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/run/run-docker.html b/james-distributed-app/3.8.1/run/run-docker.html
deleted file mode 100644
index 201aae9..0000000
--- a/james-distributed-app/3.8.1/run/run-docker.html
+++ /dev/null
@@ -1,619 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Run with docker :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run-java.html">Run with Java</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Run</a></li>
- <li><a href="run-docker.html">Run with Docker</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/run/run-docker.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Run with docker</h1>
-<div class="sect1">
-<h2 id="_running_via_docker_compose"><a class="anchor" href="#_running_via_docker_compose"></a>Running via docker-compose</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Requirements: docker & docker-compose installed.</p>
-</div>
-<div class="paragraph">
-<p>When you try James this way, you will use the most current state of James.
-It will be configured to run with Cassandra & OpenSearch.
-All those three components will be started with a single command.</p>
-</div>
-<div class="paragraph">
-<p>You can retrieve the docker-compose file : ( docker-compose file and james image name should be changed)</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ wget https://raw.githubusercontent.com/apache/james-project/master/server/apps/distributed-app/docker-compose.yml</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Then, you just have to start the services:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ docker-compose up -d</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Wait a few seconds in order to have all those services start up. You will see the following log when James is available:
-james | Started : true</p>
-</div>
-<div class="paragraph">
-<p>A default domain, james.local, has been created. You can see this by running:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ docker exec james james-cli -h 127.0.0.1 -p 9999 listdomains</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>James will respond to IMAP port 143 and SMTP port 25.
-You have to create users before playing with james. You may also want to create other domains.
-Follow the 'Useful commands' section for more information about James CLI.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_run_with_docker"><a class="anchor" href="#_run_with_docker"></a>Run with docker</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_requirements"><a class="anchor" href="#_requirements"></a>Requirements</h3>
-<div class="paragraph">
-<p>Compile the whole project:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>mvn clean install -DskipTests -T 4</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Then load the distributed server docker image:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>docker load -i server/apps/distributed-app/target/jib-image.tar</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Alternatively we provide convenience distribution for the latest release:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>docker pull apache/james:distributed-3.8.1</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_running"><a class="anchor" href="#_running"></a>Running</h3>
-<div class="paragraph">
-<p>Firstly, create your own user network on Docker for the James environment:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ docker network create --driver bridge james</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You need a running <strong>cassandra</strong> in docker which connects to <strong>james</strong> network. To achieve this run:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ docker run -d --network james --name=cassandra cassandra:4.1.3</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You need a running <strong>rabbitmq</strong> in docker which connects to <strong>james</strong> network. To achieve this run:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ docker run -d --network james --name=rabbitmq rabbitmq:3.12.1-management</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You need a running <strong>Zenko Cloudserver</strong> objectstorage in docker which connects to <strong>james</strong> network. To achieve this run:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ docker run -d --network james --env 'REMOTE_MANAGEMENT_DISABLE=1' --env 'SCALITY_ACCESS_KEY_ID=accessKey1' --env 'SCALITY_SECRET_ACCESS_KEY=secretKey1' --name=s3 registry.scality.com/cloudserver/cloudserver:8.7.25</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You need a running <strong>OpenSearch</strong> in docker which connects to <strong>james</strong> network. To achieve this run:</p>
-</div>
-<div class="paragraph">
-<p>$ docker run -d --network james -p 9200:9200 --name=opensearch --env 'discovery.type=single-node' opensearchproject/opensearch:2.1.0</p>
-</div>
-<div class="paragraph">
-<p>If you want to use all the JMAP search capabilities, you may also need to start Tika container which connects to <strong>james</strong> network:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ docker run -d --network james --name=tika apache/tika:2.8.0.0</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can find more explanation on the need of Tika in this <a href="../configure/tika.html" class="xref page">page</a>.</p>
-</div>
-<div class="paragraph">
-<p>To run this container :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ docker run --network james --hostname HOSTNAME -p "25:25" -p 80:80 -p "110:110" -p "143:143" -p "465:465" -p "587:587" -p "993:993" -p "127.0.0.1:8000:8000" --name james_run
- -v $PWD/keystore:/root/conf/keystore -t apache/james:distributed-3.8.1 --generate-keystore</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Where :</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>HOSTNAME: is the hostname you want to give to your James container. This DNS entry will be used to send mail to your James server.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Webadmin port binding is restricted to loopback as users are not authenticated by default on webadmin server. Thus you should avoid exposing it in production.
-Note that the above example assumes <code>127.0.0.1</code> is your loopback interface for convenience but you should change it if this is not the case on your machine.</p>
-</div>
-<div class="paragraph">
-<p>If you want to pass additional options to the underlying java command, you can configure a <em>JAVA_TOOL_OPTIONS</em> env variable, for example add:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>--env "JAVA_TOOL_OPTIONS=-Xms256m -Xmx2048m"</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>To have log file accessible on a volume, add <strong>-v $PWD/logs:/logs</strong> option to the above command line, where <strong>$PWD/logs</strong> is your local directory to put files in.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_specific_keystore"><a class="anchor" href="#_specific_keystore"></a>Specific keystore</h3>
-<div class="paragraph">
-<p>Alternatively, you can also generate a keystore in your conf folder with the
-following command, and drop <code>--generate-keystore</code> option:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ keytool -genkey -alias james -keyalg RSA -keystore conf/keystore</code></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_instrumentation"><a class="anchor" href="#_instrumentation"></a>Instrumentation</h3>
-<div class="paragraph">
-<p>You can use <a href="https://glowroot.org/">Glowroot</a> to instrumentalize James. It is packaged as part of the docker distribution to easily enable valuable performances insights.
-Disabled by default, its java agent can easily be enabled:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>--env "JAVA_TOOL_OPTIONS=-javaagent:/root/glowroot.jar" -p "4000:4000"</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>By default, the Glowroot UI is accessible from every machines in the network as defined in the <em>destination/admin.json</em>.
-Which you could configure before building the image, if you want to restrict its accessibility to localhost for example.
-See the <a href="https://github.com/glowroot/glowroot/wiki/Agent-Installation-(with-Embedded-Collector)#user-content-optional-post-installation-steps">Glowroot post installation steps</a> for more details.</p>
-</div>
-<div class="paragraph">
-<p>Or by mapping the 4000 port to the IP of the desired network interface, for example <code>-p 127.0.0.1:4000:4000</code>.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_handling_attachment_indexing"><a class="anchor" href="#_handling_attachment_indexing"></a>Handling attachment indexing</h3>
-<div class="paragraph">
-<p>You can handle attachment text extraction before indexing in OpenSearch. This makes attachments searchable. To enable this:</p>
-</div>
-<div class="paragraph">
-<p>Run tika connect to <strong>james</strong> network:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ docker run -d --network james --name tika apache/tika:2.8.0.0</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Run James:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ docker run --network james --hostname HOSTNAME -p "25:25" -p 80:80 -p "110:110" -p "143:143" -p "465:465" -p "587:587" -p "993:993" -p "127.0.0.1:8000:8000"
- --name james_run -v $PWD/keystore:/root/conf/keystore -t apache/james:distributed-latest</pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/run/run-java.html b/james-distributed-app/3.8.1/run/run-java.html
deleted file mode 100644
index f2f1c9d..0000000
--- a/james-distributed-app/3.8.1/run/run-java.html
+++ /dev/null
@@ -1,531 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Run :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Run</a></li>
- <li><a href="run-java.html">Run with Java</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/run/run-java.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Run</h1>
-<div class="sect1">
-<h2 id="_building"><a class="anchor" href="#_building"></a>Building</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_requirements"><a class="anchor" href="#_requirements"></a>Requirements</h3>
-<div class="ulist">
-<ul>
-<li>
-<p>Java 11 SDK</p>
-</li>
-<li>
-<p>Docker ∕ OpenSearch 2.1.0, RabbitMQ Management 3.8.18, S3 compatible
-ObjectStorage and Cassandra 4.0</p>
-</li>
-<li>
-<p>Maven 3</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_building_the_artifacts"><a class="anchor" href="#_building_the_artifacts"></a>Building the artifacts</h3>
-<div class="paragraph">
-<p>An usual compilation using maven will produce two artifacts into
-server/apps/distributed-app/target directory:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>james-server-distributed-app.jar</p>
-</li>
-<li>
-<p>james-server-distributed-app.lib</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>You can for example run in the base of
-<a href="https://github.com/apache/james-project">this git repository</a>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>mvn clean install</pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_running"><a class="anchor" href="#_running"></a>Running</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_requirements_2"><a class="anchor" href="#_requirements_2"></a>Requirements</h3>
-<div class="ulist">
-<ul>
-<li>
-<p>Cassandra 4.0</p>
-</li>
-<li>
-<p>OpenSearch 2.1.0</p>
-</li>
-<li>
-<p>RabbitMQ-Management 3.8.17</p>
-</li>
-<li>
-<p>Swift ObjectStorage 2.15.1 or Zenko Cloudserver or AWS S3</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_james_launch"><a class="anchor" href="#_james_launch"></a>James Launch</h3>
-<div class="paragraph">
-<p>To run james, you have to create a directory containing required
-configuration files.</p>
-</div>
-<div class="paragraph">
-<p>James requires the configuration to be in a subfolder of working
-directory that is called <strong>conf</strong>. You can get a sample directory for
-configuration from
-<a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/">server/apps/distributed-app/sample-configuration/</a>.
-You might need to adapt it to your needs.</p>
-</div>
-<div class="paragraph">
-<p>You need to have a Cassandra, OpenSearch, S3 and RabbitMQ instance
-running. You can either install the servers or launch them via docker:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ docker run -d -p 9042:9042 --name=cassandra cassandra:4.1.3
-$ docker run -d --network james -p 9200:9200 --name=opensearch --env 'discovery.type=single-node' opensearchproject/opensearch:2.1.0
-$ docker run -d -p 5672:5672 -p 15672:15672 --name=rabbitmq rabbitmq:3.12.1-management
-$ docker run -d --env 'REMOTE_MANAGEMENT_DISABLE=1' --env 'SCALITY_ACCESS_KEY_ID=accessKey1' --env 'SCALITY_SECRET_ACCESS_KEY=secretKey1' --name=s3 registry.scality.com/cloudserver/cloudserver:8.7.25</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Once everything is set up, you just have to run the jar with:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ java -Dworking.directory=. -jar target/james-server-distributed-app.jar --generate-keystore</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Alternatively, you can also generate a keystore in your conf folder with the
-following command, and drop <code>--generate-keystore</code> option:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ keytool -genkey -alias james -keyalg RSA -keystore conf/keystore</code></pre>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_using_aws_s3_of_zenko_cloudserver"><a class="anchor" href="#_using_aws_s3_of_zenko_cloudserver"></a>Using AWS S3 of Zenko Cloudserver</h4>
-<div class="paragraph">
-<p>By default, James is configured with [Zenko Cloudserver](<a href="https://hub.docker.com/r/zenko/cloudserver" class="bare">https://hub.docker.com/r/zenko/cloudserver</a>) which is compatible with AWS S3, in <code>blobstore.propeties</code> as such:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">implementation=s3
-objectstorage.namespace=james
-objectstorage.s3.endPoint=http://s3.docker.test:8000/
-objectstorage.s3.region=eu-west-1
-objectstorage.s3.accessKeyId=accessKey1
-objectstorage.s3.secretKey=secretKey1</code></pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-distributed-app/3.8.1/run/run-kubernetes.html b/james-distributed-app/3.8.1/run/run-kubernetes.html
deleted file mode 100644
index fb431e5..0000000
--- a/james-distributed-app/3.8.1/run/run-kubernetes.html
+++ /dev/null
@@ -1,778 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Run with Kubernetes :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-distributed-app" data-version="3.8.1">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Distributed Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Distributed James Application</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/implemented-standards.html">Implemented standards</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Run</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run-java.html">Run with Java</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run-docker.html">Run with Docker</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="run-kubernetes.html">Run with Kubernetes</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-checklist.html">Deployment Checklist</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-logsMetrics.html">Logs & Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-values.html">values.yaml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="k8s-secrets.html">secrets.yaml</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/sieve.html">Sieve & ManageSieve</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/opensearch.html">opensearch.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/redis.html">redis.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/search.html">search.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/performanceChecklist.html">Performance checklist</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../operate/security.html">Security checklist</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../extending/imap.html">Custom IMAP processing</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../benchmark/index.html">Performance benchmark</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/db-benchmark.html">Database benchmarks</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../benchmark/james-benchmark.html">James benchmarks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Distributed Server</span>
- <span class="version">3.8.1 SNAPSHOT</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <div class="title"><a href="../index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-project/3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version">
- <a href="../../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Distributed Server</a></li>
- <li><a href="../index.html">Distributed James Application</a></li>
- <li><a href="index.html">Run</a></li>
- <li><a href="run-kubernetes.html">Run with Kubernetes</a></li>
- </ul>
-</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/docs/modules/ROOT/pages/run/run-kubernetes.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Run with Kubernetes</h1>
-<div class="sect1">
-<h2 id="_deploy_apache_james_on_kubernetes_with_helm_chart"><a class="anchor" href="#_deploy_apache_james_on_kubernetes_with_helm_chart"></a>Deploy Apache James on Kubernetes with Helm chart.</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This chart bootstraps a James mail server on a <a href="http://kubernetes.io">Kubernetes</a>
-cluster using the <a href="https://helm.sh">Helm</a> package manager.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_before_starting"><a class="anchor" href="#_before_starting"></a>Before Starting</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Before running the Helm chart, James should have particularly accessed to the following external products:</p>
-</div>
-<div class="dlist">
-<dl>
-<dt class="hdlist1">Apache Cassandra</dt>
-<dd>
-<div class="ulist">
-<ul>
-<li>
-<p>You can deploy Cassandra on Kubernetes with a <a href="https://github.com/bitnami/charts/tree/master/bitnami/cassandra">Cassandra chart</a> for testing purpose. However we would recommend running Cassandra on VirtualMachine for better stablilty.</p>
-</li>
-</ul>
-</div>
-</dd>
-<dt class="hdlist1">OpenSearch</dt>
-<dd>
-<div class="ulist">
-<ul>
-<li>
-<p>OpenSearch community maintains <a href="https://github.com/opensearch-project/helm-charts">Helm charts</a></p>
-</li>
-</ul>
-</div>
-</dd>
-<dt class="hdlist1">RabbitMQ</dt>
-<dd>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://github.com/rabbitmq/cluster-operator">RabbitMQ Cluster Operator</a> is a custom Kubernetes resource designed for the lifecycle (creation, upgrade, graceful shutdown) of a RabbitMQ cluster. Using Quickstart setup is enough for James deployment.</p>
-</li>
-</ul>
-</div>
-</dd>
-</dl>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_configuration"><a class="anchor" href="#_configuration"></a>Configuration</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_helm_configuration"><a class="anchor" href="#_helm_configuration"></a>Helm Configuration</h3>
-<div class="paragraph">
-<p>The James helm package take parameters that will configure and determine the behavior of James.
-There are 2 configuration files:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>One contains global, non-confidential, configuration: <code>values.yaml</code></p>
-</li>
-<li>
-<p>The other one contains secrets: <code>secrets.yaml</code>. Values are encrypted with a key stored generated by <a href="https://github.com/mozilla/sops">sops</a>.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>You need to pass these 2 files as parameters to the James Helm package.
-To verify the coherence and avoid errors, the packages can validate the input.</p>
-</div>
-<div class="paragraph">
-<p>This package contains a default <code>values.yaml</code> file, but that you should override with proper configuration for your deployment (<code>conf.yaml</code>).
-The file <code>secrets.sample.yaml</code> will show you the possible values of the secrets file. To generate the <code>secrets.yaml</code> file,
-you will need a plugin for Helm called <a href="https://github.com/jkroepke/helm-secrets">helm-secrets</a>.</p>
-</div>
-<div class="paragraph">
-<p>Usually, you will save those configurations in different repositories, per deployment.</p>
-</div>
-<div class="paragraph">
-<p>Have a look at <code>values.md</code> and <code>secrets.md</code> in our Chart <a href="https://github.com/apache/james-project/tree/master/server/apps/distributed-app/helm-chart/james/doc/">documents</a> to have more information on the configuration James is using.</p>
-</div>
-<div class="paragraph">
-<p>You can find our Helm chart for James in <a href="https://github.com/apache/james-project/tree/master/server/apps/distributed-app/helm-chart">here</a></p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_james_configuration"><a class="anchor" href="#_james_configuration"></a>James Configuration</h3>
-<div class="paragraph">
-<p>The configuration files proper to James are stored in the Chart <code>james/configs</code> folder. They are being stored in a <code>ConfigMap</code> and then being mounted in the James pod at /root/conf path.</p>
-</div>
-<div class="paragraph">
-<p>If you need to change a conf in James, this is where you need to look at.</p>
-</div>
-<div class="paragraph">
-<p>For now all configuration files are the same for every deployment, except for <code>mailetcontainer.xml</code> that has been excluded (see section below).</p>
-</div>
-<div class="paragraph">
-<p>You can get the template <code>mailetcontainer.xml</code> in our <a href="https://github.com/apache/james-project/blob/master/server/apps/distributed-app/sample-configuration/">sample-configuration</a> folder.</p>
-</div>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-note" title="Note"></i>
-</td>
-<td class="content">
-<div class="paragraph">
-<p>The <code>mailetcontainer.xml</code> is the configuration file in James responsible of mail processing and delivery. It can differ greatly from one deployment to another. For that reason, we have excluded it from <code>james/configs</code> folder for the moment. You need to draft your own version of <code>mailetcontainer.xml</code> and add it to <code>james/configs</code> before start deploying Helm chart, as we can’t actually mount a separate file into the same mounting point as the one sued by the <code>ConfigMap</code> on <code>/root/conf</code> path.</p>
-</div>
-<div class="paragraph">
-<p>However, the next release of Helm should allow to do something about that (hopefully). The helm package will be updated then.</p>
-</div>
-</td>
-</tr>
-</table>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_deploy_james_helm_chart"><a class="anchor" href="#_deploy_james_helm_chart"></a>Deploy James Helm chart</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_verify_the_configuration"><a class="anchor" href="#_verify_the_configuration"></a>Verify the configuration</h3>
-<div class="paragraph">
-<p>We recommend to verify the configuration against the James Helm packages before deploying it. Usually it is best to have to position yourself in the repository having your deployment’s values and secrets, and linking this helm package to it, like this:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ helm lint -f james/conf.yaml -f james/secrets.yaml /path/to/helm/james</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can also generate the whole templates with values (can be useful for debugging sometimes), by typing:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ helm secrets templates -f james/conf.yaml -f james/secrets.yaml james /path/to/helm/james</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>From there, you should be able to interact with the Kubernetes cluster with <code>kubectl</code> command.</p>
-</div>
-<div class="paragraph">
-<p>A few useful commands:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>kubectl get namespace # show namespaces on your cluster
-
-kubectl get pod -n mail-server # list pods running in mail-server namespace
-
-kubectl config set-context --current --namespace=mail-server # set the namespace mail-server as default one for next commands
-
-kubectl get configmaps # list configmaps depoyed on the namespace
-
-kubectl get secrets # list secrets deployed on the namespace
-
-kubectl get service # list services deployed in the namespace
-
-kubectl get nodes -o wide # list nodes related to the namespace
-
-kubectl describe pod my-pod # get a detailed description of my-pod (similar for other objects)
-
-kubectl scale --replicas=4 deployment james # scale up (or down) james to 4 pods
-
-kubectl rollout restart deployment james # force a rollout restart of your pods related to james
-
-kubectl logs my-pod -f --tail 100 # show and follow logs of a pod from the last 100 lines
-
-kubectl logs -f -l app=james --tail 100 # show and follow the combined logs of all james pods from the last 100 lines
-
-kubectl port-forward pod/my-pod 3000:3000 # allow you to access and interact with internal port 3000 of my-pod from localhost</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Usually you have a namespace per deployment. Always target your deployments on the corresponding namespace, by either adding the flag -n mail-server on your kubectl and helm commands, or by setting your namespace by default (see in the above commands).</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_deploy_james_chart"><a class="anchor" href="#_deploy_james_chart"></a>Deploy James Chart</h3>
-<div class="paragraph">
-<p>Before doing a real deployment, you need to check that you have at least all necessary values for James to start and run smoothly on your environment. You can check the <code>checklist.md</code> in our document folder for this.</p>
-</div>
-<div class="paragraph">
-<p>Run the command when you think you are good to go:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ helm secrets install james james/ -f james/values.yaml -f james/secrets.yaml</pre>
-</div>
-</div>
-<div class="imageblock">
-<div class="content">
-<img src="../_images/apache-james-lens.png" alt="Distributed Apache James in Kubernetes">
-</div>
-</div>
-<div class="paragraph">
-<p>You can also wait for the deployment to be complete by adding a --wait flag, that is based on the readiness probe located inside the James pod.</p>
-</div>
-<div class="paragraph">
-<p>However sometimes things might not always go well at the start of James. Usually it is good to look at the logs. If it goes without issues until you start to see some successful health check logs, then you are likely good.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_upgrade_chart_version"><a class="anchor" href="#_upgrade_chart_version"></a>Upgrade Chart version</h3>
-<div class="paragraph">
-<p>If you want to deploy a new version of a installed package, use helm secrets upgrade:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ helm secrets upgrade -f james/conf.yaml -f james/secrets.yaml james /path/to/helm/james</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>What Helm does is that it compares all the generated YAML files with those on the server.
-And it updates only those that changed. There are however some limitations:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>pods in errors are not recreated during an upgrade. It allows to check the logs first. However, if you delete the pod by hand, it will be recreated from the last definition.</p>
-</li>
-<li>
-<p>Some artifacts, such as jobs and stateful sets, have immutable properties. So, some upgrades may fail. Deleting by hand the element is sometimes a solution before doing the upgrade.</p>
-</li>
-</ul>
-</div>
-<div class="admonitionblock tip">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-tip" title="Tip"></i>
-</td>
-<td class="content">
-Install <a href="https://github.com/databus23/helm-diff">helm-diff</a> plugin to display the changed configurations before run upgrade.
-</td>
-</tr>
-</table>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ helm secrets diff upgrade -f james/conf.yaml -f james/secrets.yaml james /path/to/helm/james</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_rollback_to_previous_chart_version"><a class="anchor" href="#_rollback_to_previous_chart_version"></a>Rollback to previous Chart version</h3>
-<div class="paragraph">
-<p>Show chart revision history:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ helm history james -n <name space></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Rollback to a previous version:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ helm rollbaack james <revision></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_uninstalling"><a class="anchor" href="#_uninstalling"></a>Uninstalling</h3>
-<div class="paragraph">
-<p>To uninstall the helm package:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ helm uninstall james -n <name space></pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_references"><a class="anchor" href="#_references"></a>References</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>A summary of different resources that could be interesting to have in hand.</p>
-</div>
-<div class="sect2">
-<h3 id="_this_package"><a class="anchor" href="#_this_package"></a>This package</h3>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="k8s-values.html" class="xref page">Values</a></p>
-</li>
-<li>
-<p><a href="k8s-secrets.html" class="xref page">Secrets</a></p>
-</li>
-<li>
-<p><a href="k8s-checklist.html" class="xref page">Check List</a></p>
-</li>
-<li>
-<p><a href="k8s-logsMetrics.html" class="xref page">Logs and Metrics</a></p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_james_documentation"><a class="anchor" href="#_james_documentation"></a>James documentation</h3>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://james.apache.org/">James Official Website</a></p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project">James GitHub Project</a></p>
-</li>
-<li>
-<p><a href="../operate/webadmin.html" class="xref page">WebAdmin</a></p>
-</li>
-<li>
-<p><a href="../operate/cli.html" class="xref page">James CLI</a></p>
-</li>
-<li>
-<p><a href="https://james.apache.org/server/manage-guice-distributed-james.html">Manage Guice Distributed James</a></p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_kubernetes"><a class="anchor" href="#_kubernetes"></a>Kubernetes</h3>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://kubernetes.io/docs/concepts/overview/components/">Kubernetes Components Overview</a></p>
-</li>
-<li>
-<p><a href="https://kubernetes.io/docs/concepts/workloads/pods/">Pods</a></p>
-</li>
-<li>
-<p><a href="https://kubernetes.io/docs/concepts/services-networking/service/">Services</a></p>
-</li>
-<li>
-<p><a href="https://kubernetes.io/docs/concepts/services-networking/ingress/">Ingress</a></p>
-</li>
-<li>
-<p><a href="https://kubernetes.io/docs/concepts/configuration/configmap/">Configmaps</a></p>
-</li>
-<li>
-<p><a href="https://kubernetes.io/docs/concepts/configuration/secret/">Secrets</a></p>
-</li>
-<li>
-<p><a href="https://kubernetes.io/docs/concepts/workloads/controllers/deployment/">Deployments</a></p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_helm"><a class="anchor" href="#_helm"></a>Helm</h3>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://helm.sh/docs/topics/architecture/">Helm Architecture</a></p>
-</li>
-<li>
-<p><a href="https://helm.sh/docs/topics/charts/">Charts</a></p>
-</li>
-<li>
-<p><a href="https://helm.sh/docs/intro/using_helm/">Using Helm</a></p>
-</li>
-<li>
-<p><a href="https://helm.sh/docs/chart_template_guide/getting_started/">Helm templates</a></p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/community/_images/linagora.png b/james-project/3.6.0/community/_images/linagora.png
deleted file mode 100644
index de0a185..0000000
--- a/james-project/3.6.0/community/_images/linagora.png
+++ /dev/null
Binary files differ
diff --git a/james-project/3.6.0/community/contributing.html b/james-project/3.6.0/community/contributing.html
deleted file mode 100644
index ffbd766..0000000
--- a/james-project/3.6.0/community/contributing.html
+++ /dev/null
@@ -1,873 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Contributing :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../servers/extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../servers/test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item is-current-page" data-depth="2">
- <a class="nav-link" href="contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Server</a></li>
- <li><a href="index.html">Community</a></li>
- <li><a href="contributing.html">Contributing</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../3.8.1/community/contributing.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="contributing.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/community/pages/contributing.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Contributing</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This document defines the different ways available for contributing to the Apache James project.</p>
-</div>
-<div class="paragraph">
-<p>To keep you informed on James issues, subscribe to the relevant <a href="mailing-lists.html" class="xref page">mailing lists</a>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_be_involved_in_the_community"><a class="anchor" href="#_be_involved_in_the_community"></a>Be involved in the community</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>An easy start is to be involved in the community.</p>
-</div>
-<div class="paragraph">
-<p>Share your experiences with James, your needs, your enhancements proposition via the
-<a href="mailing-lists.html" class="xref page">mailing lists</a>, on <a href="https://gitter.im/apache/james-project">Gitter</a>, or on our
-<a href="https://issues.apache.org/jira/projects/JAMES/issues">Bug Tracker</a>.</p>
-</div>
-<div class="paragraph">
-<p>Don’t hesitate to write articles and blog posts. Use your preferred media to spread the love!</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_reporting_bugs"><a class="anchor" href="#_reporting_bugs"></a>Reporting bugs</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Many improvements come as a direct result of bug reports.</p>
-</div>
-<div class="paragraph">
-<p>To report a bug, please use the appropriate Bug Tracker JIRA link according to the project you want to address:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://issues.apache.org/jira/browse/JAMES">Server</a></p>
-</li>
-<li>
-<p><a href="https://issues.apache.org/jira/browse/MAILET">Mailet</a></p>
-</li>
-<li>
-<p><a href="https://issues.apache.org/jira/browse/MAILBOX">Mailbox</a></p>
-</li>
-<li>
-<p><a href="https://issues.apache.org/jira/browse/PROTOCOLS">Protocols</a></p>
-</li>
-<li>
-<p><a href="https://issues.apache.org/jira/browse/MPT">MPT</a></p>
-</li>
-<li>
-<p><a href="https://issues.apache.org/jira/browse/MIME4J">Mime4j</a></p>
-</li>
-<li>
-<p><a href="https://issues.apache.org/jira/browse/JSIEVE">jSieve</a></p>
-</li>
-<li>
-<p><a href="https://issues.apache.org/jira/browse/JSPF">jSPF</a></p>
-</li>
-<li>
-<p><a href="https://issues.apache.org/jira/browse/JDKIM">jDKIM</a></p>
-</li>
-<li>
-<p><a href="https://issues.apache.org/jira/browse/HUPA">Hupa</a></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Once you are logged on the appropriate JIRA page, click on the red Create button, then complete the different fields
-as accurately as possible, so that any user can reproduce the reported bug. Also note that all your information must be
-readable (use markdown).</p>
-</div>
-<div class="paragraph">
-<p>Then, you have to click on Create to submit your bug.</p>
-</div>
-<div class="sect2">
-<h3 id="_reporting_security_vulnerabilities"><a class="anchor" href="#_reporting_security_vulnerabilities"></a>Reporting security vulnerabilities</h3>
-<div class="paragraph">
-<p><a href="http://www.apache.org/security/">Security vulnerabilities</a> should be announced to the Apache Security team.
-PMCs will be notified about them, and will work hard to propose fixes as fast as possible.</p>
-</div>
-<div class="paragraph">
-<p>Specific details about security in James can be found here.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_documentation"><a class="anchor" href="#_documentation"></a>Documentation</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Documentation is an easy way to get on board! Check out the
-<a href="https://issues.apache.org/jira/issues/?jql=project%20%3D%20JAMES%20AND%20resolution%20%3D%20Unresolved%20AND%20labels%20%3D%20documentation%20ORDER%20BY%20priority%20DESC%2C%20updated%20DESC">~documentation</a>
-label on JIRA to get some ideas.
-Report on JIRA the typos you spot, the information you miss, and any improvement you can think of.
-The next step is to contribute the documentation changes via <a href="https://github.com/apache/james-project/tree/master/docs/modules">Git</a>.</p>
-</div>
-<div class="paragraph">
-<p>To edit an existing document try to edit the adoc version in <code>docs/modules</code> (check it out from Git) and if you can, submit a
-patch as for <a href="#_code_patches">Code Patches</a>.</p>
-</div>
-<div class="paragraph">
-<p>If you want to contribute new files please try to use the AsciiDoc format as shown in <code>docs/modules</code>.</p>
-</div>
-<div class="paragraph">
-<p>If all this seems like unnecessary nonsense, send us whatever you like, we’d still be happy to receive good documentation.</p>
-</div>
-<div class="paragraph">
-<p>Each of the Apache James projects has its own documentation maintained with the automated build. Once a build is done,
-the documentation can be further committed in the <a href="https://git-wip-us.apache.org/repos/asf/james-site.git">site module</a>
-which will be automatically published via gitpubsub to <a href="http://james.apache.org">Apache James web site</a>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_how_to_contribute_some_code"><a class="anchor" href="#_how_to_contribute_some_code"></a>How to contribute some code?</h2>
-<div class="sectionbody">
-<div class="ulist">
-<ul>
-<li>
-<p>Clone the source code of the project from its <a href="git://git.apache.org/james-project.git">apache git repository</a> or its
-<a href="https://github.com/apache/james-project">Github</a></p>
-</li>
-<li>
-<p>Create your branch and name it with the JIRA ticket number.</p>
-</li>
-<li>
-<p>Create a Pull Request with your branch name and prefix its different commits with the same name.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Alternatively you can create a patch as <a href="#_code_patches">outlined below</a>, and attach it to the JIRA ticket.</p>
-</div>
-<div class="paragraph">
-<p>A valid commit comment might be:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">JAMES-2285 My awesome commit title
-
-Here is some more details about what my commit does, and the rationals of the choice I took.</code></pre>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_licenses"><a class="anchor" href="#_licenses"></a>Licenses</h3>
-<div class="paragraph">
-<p>All contributions to the James project are made under the <a href="https://www.apache.org/licenses">Apache license 2.0</a></p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_contributions_proposals"><a class="anchor" href="#_contributions_proposals"></a>Contributions proposals</h3>
-<div class="ulist">
-<ul>
-<li>
-<p>We reference some easy tasks to start with:
-<a href="https://issues.apache.org/jira/issues/?jql=project%20%3D%20JAMES%20AND%20resolution%20%3D%20Unresolved%20AND%20labels%20%3D%20newbie%20ORDER%20BY%20priority%20DESC%2C%20updated%20DESC">~newbie</a></p>
-</li>
-<li>
-<p>We have a collection of minor fixes awaiting contributions:
-<a href="https://issues.apache.org/jira/issues/?jql=project%20%3D%20JAMES%20AND%20resolution%20%3D%20Unresolved%20AND%20labels%20%3D%20easyfix%20ORDER%20BY%20priority%20DESC%2C%20updated%20DESC">~easyfix</a></p>
-</li>
-<li>
-<p>Challenge yourself with some cool features we thought to:
-<a href="https://issues.apache.org/jira/issues/?jql=project%20%3D%20JAMES%20AND%20resolution%20%3D%20Unresolved%20AND%20labels%20%3D%20feature%20ORDER%20BY%20priority%20DESC%2C%20updated%20DESC">~feature</a></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Additional ideas are more than welcome. Don’t hesitate to discuss that with us!</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_coding_standards"><a class="anchor" href="#_coding_standards"></a>Coding standards</h3>
-<div class="paragraph">
-<p>While we are glad to accept contributions to documentation from anyone, in almost any format, because its much better
-than none, please consider these guidelines to help us to assimilate your contribution.</p>
-</div>
-<div class="paragraph">
-<p>Submissions to the James project must follow the coding conventions outlined in this document. James developers are
-asked to follow coding conventions already present in the code. (For example, if the existing code has the bracket on
-the same line as the if statement, then all subsequent code should also follow that convention.) Anything not explicitly
-mentioned in this document should adhere to the official
-<a href="https://www.oracle.com/java/technologies/javase/codeconventions-contents.html">Java Coding Conventions</a>.</p>
-</div>
-<div class="paragraph">
-<p><strong>Developers who commit code that does not follow the coding conventions outlined in this document will be responsible
-for fixing their own code.</strong></p>
-</div>
-<div class="olist arabic">
-<ol class="arabic">
-<li>
-<p>Your code should pass our <a href="https://github.com/apache/james-project/blob/master/checkstyle.xml">checkstyle</a> which runs
-upon <code>mvn compile</code> and all phases which depend on <code>compile</code>.</p>
-</li>
-<li>
-<p>Extra spaces between parentheses are not allowed:</p>
-</li>
-</ol>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs"> if (foo) > Good
-
- or
-
- if ( foo ) > Bad</code></pre>
-</div>
-</div>
-<div class="olist arabic">
-<ol class="arabic" start="3">
-<li>
-<p>Four spaces. <strong>No tabs.</strong> Period.
-The James mailing list receives commit messages that are almost impossible to read if tabs are used.</p>
-</li>
-<li>
-<p>Use Unix linefeeds for all .java source code files. Only platform-specific files (e.g. .bat files for Windows) should
-contain non-Unix linefeeds.</p>
-</li>
-<li>
-<p>Javadoc <strong>MUST</strong> exist on all API methods. Contributing a missing javadoc for any method, class, variable, etc., will be
-GREATLY appreciated as this will help to improve the James project.</p>
-</li>
-<li>
-<p>The standard Apache license header <strong>MUST</strong> be placed at the top of every file.</p>
-</li>
-<li>
-<p>Your change set <strong>MUST</strong> be covered by tests. We also strongly appreciate integration tests.</p>
-</li>
-<li>
-<p>We also require the following best practice regarding maven and the <strong>pom.xml</strong>:</p>
-<div class="ulist">
-<ul>
-<li>
-<p>Define your dependency versions in james-project pom.xml. This structurally ensures all projects get the same v
-ersion, and that there is no version clashes.</p>
-</li>
-<li>
-<p>Don’t use <em>org.apache.james</em> groupId for internal dependencies. Use <em>${james.groupId}</em>. If not, you break the policies
-for automatic sorting, as well as make it more ambiguous. One exception is apache-mime4j-* artifacts which share the
-james groupId despite living in a different repository.</p>
-</li>
-<li>
-<p>You should be ordering your dependencies. The sort order of tags and dependencies in the pom is automatically enforced at build time. By default the build
-will fail if violations are detected.</p>
-</li>
-</ul>
-</div>
-</li>
-</ol>
-</div>
-<div class="paragraph">
-<p>The pom file ordering can be quickly checked using :</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">mvn validate</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If you get an error and want the tool to fix it for you, you can use :</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">mvn validate -PsortPom</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The <code>sortPom</code> profile can be used on all maven phases. Make sure to review the changes made by the tool, it is known to
-sometimes remove whitespaces which may not be desirable.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_code_patches"><a class="anchor" href="#_code_patches"></a>Code patches</h3>
-<div class="paragraph">
-<p>Patches should be attached to the corresponding JIRA issue.</p>
-</div>
-<div class="paragraph">
-<p>Always use diff -u to generate patches, so we can apply them using 'patch'.</p>
-</div>
-<div class="paragraph">
-<p>Make sure the patch only contains what is intended, your checkout could be outdated.</p>
-</div>
-<div class="paragraph">
-<p>Make sure it conforms to the code standards, otherwise it may be ignored. It is OK to make a single patch covering
-several files, but please only one issue at a time.</p>
-</div>
-<div class="paragraph">
-<p>Briefly outline the reason for your patch, the solution your patch implements, why a patch is needed and why your code
-will solve the problem. Note any bug numbers your patch addresses.</p>
-</div>
-<div class="paragraph">
-<p>The reason for these rules is so that committers can easily see what you are trying to achieve, it is their
-responsibility to manage the code and review submissions, if you make it easy for them to see what you are doing your
-patch is more likely to be committed quickly.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_idea_or_design_proposals"><a class="anchor" href="#_idea_or_design_proposals"></a>Idea or design proposals</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>People can submit ideas, features or design changes proposals by discussing it through the
-<a href="mailing-lists.html" class="xref page">mailing lists</a> and/or submitting an ADR (Architecture Decision Record). A discussion
-on the mailing list getting a consensus of the community can be the object of the writing of an ADR to confirm the
-change agreed upon.</p>
-</div>
-<div class="paragraph">
-<p>ADRs <strong>MUST</strong> be submitted under the folder <code>src/adr</code> via a pull request. The standards used for writing an ADR are
-described in the <a href="https://github.com/apache/james-project/blob/master/src/adr/0001-record-architecture-decisions.md">first ADR</a>
-written for the Apache James project.</p>
-</div>
-<div class="paragraph">
-<p>The number of the ADR should be incremental. If an other ADR gets merged concurrently, the committer is responsible for
-updating its number accordingly.</p>
-</div>
-<div class="paragraph">
-<p>When the ADR reaches a consensus within the community and is accepted, it can be merged and goes into effect.</p>
-</div>
-<div class="paragraph">
-<p>An ADR can’t be removed after being accepted and merged. However, a new ADR can supersede a previous one. This is so
-we are able to keep track on all the decisions being made regarding the project.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/community/download.html b/james-project/3.6.0/community/download.html
deleted file mode 100644
index 706e98e..0000000
--- a/james-project/3.6.0/community/download.html
+++ /dev/null
@@ -1,548 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Download Apache James releases :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../servers/extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../servers/test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item is-current-page" data-depth="2">
- <a class="nav-link" href="download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Server</a></li>
- <li><a href="index.html">Community</a></li>
- <li><a href="download.html">Download releases</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../3.8.1/community/download.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="download.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/community/pages/download.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Download Apache James releases</h1>
-<div class="paragraph">
-<p>(TODO)</p>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/community/guidelines.html b/james-project/3.6.0/community/guidelines.html
deleted file mode 100644
index 20fd005..0000000
--- a/james-project/3.6.0/community/guidelines.html
+++ /dev/null
@@ -1,739 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Apache James Project guidelines :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../servers/extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../servers/test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="contributing.html">Contributing</a>
- </li>
- <li class="nav-item is-current-page" data-depth="2">
- <a class="nav-link" href="guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Server</a></li>
- <li><a href="index.html">Community</a></li>
- <li><a href="guidelines.html">Guidelines</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../3.8.1/community/guidelines.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="guidelines.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/community/pages/guidelines.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Apache James Project guidelines</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This document defines the guidelines for the Apache James Project. It includes definitions of how conflict is being
-resolved by voting and who is able to vote.</p>
-</div>
-<div class="paragraph">
-<p>The objective here is to avoid unnecessary conflicts over changes and continue to produce a quality system in a timely
-manner. Not all conflict can be avoided, but at least we can agree on the procedures for conflicts to be resolved.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_people_places_and_things"><a class="anchor" href="#_people_places_and_things"></a>People, Places, and Things</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_apache_james_project_management_committee"><a class="anchor" href="#_apache_james_project_management_committee"></a>Apache James Project Management Committee</h3>
-<div class="paragraph">
-<p>The group of volunteers who are responsible for managing the Apache James Project. This includes deciding what is
-distributed as products of the Apache James Project, maintaining the Project’s shared resources, speaking on behalf of
-the Project, resolving license disputes regarding Apache James products, nominating new PMC members or committers,
-and establishing these guidelines.</p>
-</div>
-<div class="paragraph">
-<p>Membership in the Apache James PMC is by invitation only and must be approved by consensus of the active Apache James
-PMC members. A PMC member is considered inactive by their own declaration or by not contributing in any form to the
-project for over six months. An inactive member can become active again by reversing whichever condition made them
-inactive (i.e., by reversing their earlier declaration or by once again contributing toward the project’s work).
-Membership can be revoked by a unanimous vote of all the active PMC members other than the member in question.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_apache_james_committers"><a class="anchor" href="#_apache_james_committers"></a>Apache James Committers</h3>
-<div class="paragraph">
-<p>The group of volunteers who are responsible for the technical aspects of the Apache James Project. This group has write
-access to the appropriate source repositories and these volunteers may cast non-binding votes on any technical discussion.</p>
-</div>
-<div class="paragraph">
-<p>Membership as a Committer is by invitation only and must be approved by consensus of the active Apache James PMC members.
-A Committer is considered inactive by their own declaration or by not contributing in any form to the project for over
-six months. An inactive member can become active again by reversing whichever condition made them inactive (i.e., by
-reversing their earlier declaration or by once again contributing toward the project’s work). Membership can be revoked
-by a unanimous vote of all the active PMC members (except the member in question if they are a PMC member).</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_mailing_list"><a class="anchor" href="#_mailing_list"></a>Mailing list</h3>
-<div class="paragraph">
-<p>The Apache committers' primary mailing list for discussion of issues and changes related to the project
-(<a href="mailing-lists.html#_server_developer_list" class="xref page"><a href="mailto:server-dev@james.apache.org">server-dev@james.apache.org</a></a>). Subscription to the list is open, but
-only subscribers can post directly to the list.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_private_list"><a class="anchor" href="#_private_list"></a>Private list</h3>
-<div class="paragraph">
-<p>The Apache James Project’s private mailing list for discussion of issues that are inappropriate for public discussion,
-such as legal, personal, or security issues prior to a published fix. Subscription to the list is only opened to Apache
-James PMC members and Apache Software Foundation Members.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_git"><a class="anchor" href="#_git"></a>GIT</h3>
-<div class="paragraph">
-<p>All of the Apache James products are maintained in shared information repositories using GIT on git-wip-us.apache.org.
-The Apache committers have write access to these repositories; everyone has read access via anonymous GIT.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_voting"><a class="anchor" href="#_voting"></a>Voting</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Any of the Apache James Committers may vote on any issue or action item. However, the only binding votes are those cast
-by active members of the Apache James PMC; if the vote is about a change to source code or documentation, the primary
-author of what is being changed may also cast a binding vote on that issue. All other votes are non-binding. All
-committers are encouraged to participate in decisions, but the decision itself is made by those who have been long-time
-contributors to the project. In other words, the Apache Project is a minimum-threshold meritocracy.</p>
-</div>
-<div class="paragraph">
-<p>The act of voting carries certain obligations — voting members are not only stating their opinion, they are agreeing
-to help do the work of the Apache Project. Since we are all volunteers, members often become inactive for periods of
-time in order to take care of their "real jobs" or devote more time to other projects. It is therefore unlikely that the
-entire group membership will vote on every issue. To account for this, all voting decisions are based on a minimum quorum.</p>
-</div>
-<div class="paragraph">
-<p>Each vote can be made in one of three flavors:</p>
-</div>
-<div class="paragraph">
-<p><strong>+1</strong>
-Yes, agree, or the action should be performed. On some issues, this vote is only binding if the voter has tested the
-action on their own system(s).</p>
-</div>
-<div class="paragraph">
-<p><strong>+-0</strong>
-Abstain, no opinion, or I am happy to let the other group members decide this issue. An abstention may have detrimental
-effects if too many people abstain.</p>
-</div>
-<div class="paragraph">
-<p><strong>-1</strong>
-No. On issues where consensus is required, this vote counts as a veto. All vetos must include an explanation of why the
-veto is appropriate. A veto with no explanation is void. No veto can be overruled. If you disagree with the veto, you
-should lobby the person who casts the veto. Voters intending to veto an action item should make their opinions known to
-the group immediately, so that the problem can be remedied as early as possible.</p>
-</div>
-<div class="paragraph">
-<p>An action item requiring consensus approval must receive at least 3 binding +1 votes and no vetos. An action item
-requiring majority approval must receive at least 3 binding +1 votes and more +1 votes than -1 votes (i.e., a majority
-with a minimum quorum of three positive votes). All other action items are considered to have lazy approval until
-someone votes -1, after which point they are decided by either consensus or a majority vote, depending upon the type
-of action item.</p>
-</div>
-<div class="paragraph">
-<p>All votes must be either sent to the mailing list for that action item.</p>
-</div>
-<div class="paragraph">
-<p>Votes are to remain open for 72 hours after which the developer who put forth the vote should tabulate the result and
-send this to the mailing list. A developer should be sensitive to holidays that could dampen participation in the vote.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_types_of_action_items"><a class="anchor" href="#_types_of_action_items"></a>Types of Action Items</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_long_term_plans"><a class="anchor" href="#_long_term_plans"></a>Long Term Plans</h3>
-<div class="paragraph">
-<p>Long term plans are simply announcements that group members are working on particular issues related to the Apache
-software. These are not voted on, but group members who do not agree with a particular plan, or think an alternate plan
-would be better, are obligated to inform the group of their feelings. In general, it is always better to hear about
-alternate plans prior to spending time on less adequate solutions.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_short_term_plans"><a class="anchor" href="#_short_term_plans"></a>Short Term Plans</h3>
-<div class="paragraph">
-<p>Short term plans are announcements that a developer is working on a particular set of documentation or code files, with
-the implication that other committers should avoid them or try to coordinate their changes. This is a good way to
-proactively avoid conflict and possible duplication of work.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_release_plan"><a class="anchor" href="#_release_plan"></a>Release Plan</h3>
-<div class="paragraph">
-<p>A release plan is used to keep all the committers aware of when a release is desired, who will be the release manager,
-when the repository will be frozen in order to create the release, and assorted other trivia to keep us from tripping
-over ourselves during the final moments. Lazy majority decides each issue in the release plan.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_release_testing"><a class="anchor" href="#_release_testing"></a>Release Testing</h3>
-<div class="paragraph">
-<p>After a new release is built, colloquially termed a tarball, it must be tested before being released to the public.
-Majority approval is required before the tarball can be publically released.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_showstoppers"><a class="anchor" href="#_showstoppers"></a>Showstoppers</h3>
-<div class="paragraph">
-<p>Showstoppers are issues that require a fix be in place before the next public release.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_product_changes"><a class="anchor" href="#_product_changes"></a>Product Changes</h3>
-<div class="paragraph">
-<p>Changes to the Apache James products, including code and documentation, will appear as action items under several
-categories corresponding to the change status:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>Concept/Plan</strong>
-An idea or plan for a change. These are represented as ADRs (Architectural Decision Records), stored under the <code>src/adr</code>
-folder. Votes are being requested early so as to uncover conflicts before too much work is done. You can find more
-information about this <a href="contributing.html#_idea_or_design_proposals" class="xref page">here</a>.</p>
-</li>
-<li>
-<p><strong>Proposed Patch</strong>
-A specific set of changes to the current product in the form of input to the patch command (a diff output).</p>
-</li>
-<li>
-<p><strong>Committed Change</strong>
-A one-line summary of a change that has been committed to the repository since the last public release.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>All product changes to the currently active repository are subject to lazy consensus. All product changes to a
-prior-branch (old version) repository require consensus before the change is committed.</p>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/community/index.html b/james-project/3.6.0/community/index.html
deleted file mode 100644
index 3273b9c..0000000
--- a/james-project/3.6.0/community/index.html
+++ /dev/null
@@ -1,655 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Apache James Community :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../servers/extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../servers/test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Server</a></li>
- <li><a href="index.html">Community</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../3.8.1/community/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="index.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/community/pages/index.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Apache James Community</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>Apache James Project is an Open Source all-volunteer project obtaining its strength from its Community made of
-developers and users. All are welcome to the Community!</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_join_the_community"><a class="anchor" href="#_join_the_community"></a>Join the community</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>There are many ways for Users, Developers, Curious and Fans to join and be part of the James Community:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://james.apache.org/">Apache James Website</a></p>
-</li>
-<li>
-<p><a href="mailing-lists.html" class="xref page">Mailing lists</a>: Subscribe to the appropriate Mailing Lists according to your interests and profile.</p>
-</li>
-<li>
-<p><a href="https://gitter.im/apache/james-project">Gitter chat room</a>: Chat in live with the community on Gitter.</p>
-</li>
-<li>
-<p><a href="https://twitter.com/ApacheJames">Twitter</a>: Express yourself and follow us @ApacheJames.</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project">Github</a>: Read and contribute to the source code of the project.</p>
-</li>
-<li>
-<p><a href="https://issues.apache.org/jira/projects/JAMES">JIRA</a>: Report issues or make suggestions for the project on our bug tracker.</p>
-</li>
-<li>
-<p><a href="https://builds.apache.org/job/ApacheJames/">CI</a>: Check the status of James builds on our Jenkins CI.</p>
-</li>
-<li>
-<p><a href="download.html" class="xref page">Download releases</a>: Download artifacts and sources your need for the James Server and James libraries.</p>
-</li>
-<li>
-<p><a href="support.html" class="xref page">Professional support</a>: Find a list of companies which can provide you some support on James.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_contribute"><a class="anchor" href="#_contribute"></a>Contribute</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>James is a project that lives from the contributions of its community. <strong>Anyone can contribute!</strong></p>
-</div>
-<div class="paragraph">
-<p>That’s right, we always want to hear from people with contributions to the code, the documentation, the website,
-and bug reports. We more than welcome non-coding contributions.</p>
-</div>
-<div class="paragraph">
-<p>You can find more information on how to contribute to the James project on the <a href="contributing.html" class="xref page">contributing</a> section.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_articles_for_contributors"><a class="anchor" href="#_articles_for_contributors"></a>Articles for contributors</h2>
-<div class="sectionbody">
-<div class="ulist">
-<ul>
-<li>
-<p><a href="website.html" class="xref page">Building and publishing the website</a></p>
-</li>
-<li>
-<p><a href="release.html" class="xref page">Creating an official Apache James release</a></p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_the_apache_software_foundation"><a class="anchor" href="#_the_apache_software_foundation"></a>The Apache Software Foundation</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>James is a project belonging to the <a href="https://www.apache.org/">Apache Software Foundation [ASF]</a>. Thus, the Apache Jame project
-is governed by a number of <a href="guidelines.html" class="xref page">guidelines</a> directly depending on the <strong>ASF</strong>.</p>
-</div>
-<div class="paragraph">
-<p>If you wish to get more involved with the <strong>ASF</strong> community in general, those links might interest you as well:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://www.apache.org/foundation/getinvolved.html">Get involved with the ASF</a></p>
-</li>
-<li>
-<p><a href="https://www.apache.org/foundation/faq.html">Apache FAQ</a></p>
-</li>
-<li>
-<p><a href="https://www.apache.org/licenses/">Apache Licenses</a></p>
-</li>
-<li>
-<p><a href="https://www.apache.org/security/">The Apache security team</a></p>
-</li>
-<li>
-<p><a href="https://www.apache.org/foundation/sponsorship.html">Sponsorship program</a></p>
-</li>
-<li>
-<p><a href="https://www.apache.org/foundation/thanks.html">Sponsors list</a></p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/community/mailing-lists.html b/james-project/3.6.0/community/mailing-lists.html
deleted file mode 100644
index 9a44c4f..0000000
--- a/james-project/3.6.0/community/mailing-lists.html
+++ /dev/null
@@ -1,773 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Mailing lists :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../servers/extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../servers/test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="2">
- <a class="nav-link" href="mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Server</a></li>
- <li><a href="index.html">Community</a></li>
- <li><a href="mailing-lists.html">Mailing lists</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../3.8.1/community/mailing-lists.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="mailing-lists.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/community/pages/mailing-lists.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Mailing lists</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>Please read the <a href="#_guidelines">Guidelines</a> below before subscribing to our lists and join our community.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_james_mailing_lists"><a class="anchor" href="#_james_mailing_lists"></a>James mailing lists</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Most James mailing lists are open and also archived and available online.
-You can read them even if you are not subscribed.
-You can post only if you are subscribed.</p>
-</div>
-<div class="sect2">
-<h3 id="_mailing_list_archives_and_web_browsing"><a class="anchor" href="#_mailing_list_archives_and_web_browsing"></a>Mailing list archives and web browsing</h3>
-<div class="paragraph">
-<p>You can browse the mailing list archives online using the <a href="https://lists.apache.org/list.html?james.apache.org">Pony Mail</a> instance.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_server_user_list"><a class="anchor" href="#_server_user_list"></a>Server user list</h3>
-<div class="paragraph">
-<p><strong>Low traffic</strong>
-<a href="mailto:server-user-subscribe@james.apache.org">Subscribe</a>
-<a href="mailto:server-user-unsubscribe@james.apache.org">Unsubscribe</a>
-<a href="https://lists.apache.org/list.html?server-user@james.apache.org">Archive</a></p>
-</div>
-<div class="paragraph">
-<p>This is the list where users of the Apache James (Server) meet and discuss issues. Developers are also expected to be
-subscribed to this list to offer support to users of Apache James (Server).</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_server_developer_list"><a class="anchor" href="#_server_developer_list"></a>Server developer list</h3>
-<div class="paragraph">
-<p><strong>Medium traffic</strong>
-<a href="mailto:server-dev-subscribe@james.apache.org">Subscribe</a>
-<a href="mailto:server-dev-unsubscribe@james.apache.org">Unsubscribe</a>
-<a href="https://lists.apache.org/list.html?server-dev@james.apache.org">Archive</a></p>
-</div>
-<div class="paragraph">
-<p>This is the list where participating developers of the Apache James Project meet and discuss issues, code changes/additions,
-etc. Do not send mail to this list with usage questions or configuration problems — that’s what server-user@james is for.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_mime4j"><a class="anchor" href="#_mime4j"></a>Mime4j</h3>
-<div class="paragraph">
-<p><strong>Medium traffic</strong>
-<a href="mailto:mime4j-dev-subscribe@james.apache.org">Subscribe</a>
-<a href="mailto:mime4j-dev-unsubscribe@james.apache.org">Unsubscribe</a>
-<a href="https://lists.apache.org/list.html?mime4j-dev@james.apache.org">Archive</a></p>
-</div>
-<div class="paragraph">
-<p>Discussions on the <a href="http://james.apache.org/mime4j">Mime4j</a> parser library.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_james_general_list"><a class="anchor" href="#_james_general_list"></a>James general list</h3>
-<div class="paragraph">
-<p><strong>Low traffic</strong>
-<a href="mailto:general-subscribe@james.apache.org">Subscribe</a>
-<a href="mailto:general-unsubscribe@james.apache.org">Unsubscribe</a>
-<a href="https://lists.apache.org/list.html?general@james.apache.org">Archive</a></p>
-</div>
-<div class="paragraph">
-<p>This is the list for general discussions related to the running of the project, it is the public list of the
-James project management committee (PMC) and is a public list opened to all. Do not send mail to this list with James
-software problems — that’s what server-user@james is for.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_notifications_mailing_list"><a class="anchor" href="#_notifications_mailing_list"></a>Notifications mailing list</h3>
-<div class="paragraph">
-<p><strong>High traffic</strong>
-<a href="mailto:notifications-subscribe@james.apache.org">Subscribe</a>
-<a href="mailto:notifications-unsubscribe@james.apache.org">Unsubscribe</a>
-<a href="https://lists.apache.org/list.html?notifications@james.apache.org">Archive</a></p>
-</div>
-<div class="paragraph">
-<p>Subscribers to this list get notices of each and every code change, build results, testing notices, etc. This list is
-not for asking help, raising issues or starting discussions on the james product — other mailing lists are specifically
-dedicated to that already.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_how_to_unsubscribe_your_old_email_address"><a class="anchor" href="#_how_to_unsubscribe_your_old_email_address"></a>How to unsubscribe your old email address</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>First, find out the particular email adress to which ezmlm is sending. The email headers are visible in Microsoft Outlook
-via the messages menu "View | Options".</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>Microsoft Mail Internet Headers Version 2.0
-...
-List-Unsubscribe: <mailto:server-user-unsubscribe@james.apache.org>
-List-Help: <mailto:server-user-help@james.apache.org>
-List-Post: <mailto:server-user@james.apache.org>
-List-Id: "James Server Users List" <server-user.james.apache.org>
-Reply-To: "James Server Users List" <server-user@james.apache.org>
-Delivered-To: mailing list server-user@james.apache.org
-...
-Return-Path: server-user-return-12345-john=host.domain@james.apache.org
-...</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The <em>Return-Path</em> header contains the email address which is subscribed.</p>
-</div>
-<div class="paragraph">
-<p>To stop subscription for the address <em>john@host.domain</em>, send an email to</p>
-</div>
-<div class="paragraph">
-<p><code>server-dev-unsubscribe-john=host.domain@james.apache.org</code></p>
-</div>
-<div class="paragraph">
-<p>or to</p>
-</div>
-<div class="paragraph">
-<p><code>server-user-unsubscribe-john=host.domain@james.apache.org</code></p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_guidelines"><a class="anchor" href="#_guidelines"></a>Guidelines</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>A mailing list is an electronic discussion forum that anyone can subscribe to. When someone sends an email message to
-the mailing list, a copy of that message is broadcasted to everyone who is subscribed to that mailing list.
-Mailing lists provide a simple and effective communication mechanism for discussion and decision making.</p>
-</div>
-<div class="paragraph">
-<p>The <strong>Apache Software Foundation</strong> has well established reasons for using email and not other types of forum.
-You may use a mail-news gateway, gmail or anything else you like but email is, and will remain, the official medium.</p>
-</div>
-<div class="paragraph">
-<p>With potentially thousands of subscribers, there is a common etiquette that you should observe. Please keep on reading.</p>
-</div>
-<div class="paragraph">
-<p><strong>Respect the mailing list type</strong></p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>"User" lists are lists where you can send questions and comments about configuration, setup, usage and other "user"
-types of questions.</p>
-</li>
-<li>
-<p>"Developer" lists are lists where you can send questions, comments and contributions about the project’s software
-source code and general "development" types of questions.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Some questions are appropriate for posting on both the "user" and the "developer" lists. In this case, pick one and
-only one. Do not cross post.</p>
-</div>
-<div class="paragraph">
-<p>Asking a configuration question on the developers list is frowned upon because developers' time is as precious as yours.
-By contacting them directly instead of the users list you are abusing resources. It is unlikely that you will get a
-quicker answer this way, those developers who have time to devote to providing support are also subscribed to the users
-list. If you contact individuals directly, or post your user issues to the developer list you may get no answer at all.</p>
-</div>
-<div class="paragraph">
-<p><strong>Join the lists that are appropriate for your discussion</strong></p>
-</div>
-<div class="paragraph">
-<p>Please make sure that you are joining the list that is appropriated for the topic that you would like to discuss.
-The general list is for discussions about the management and direction of the James project, not for "general support".</p>
-</div>
-<div class="paragraph">
-<p><strong>Ask smart questions</strong></p>
-</div>
-<div class="paragraph">
-<p>Every volunteer project obtains its strength from the people involved in it. You are welcome to join any of our mailing
-lists. You can choose to lurk, or actively participate; it’s up to you. The level of community responsiveness to
-specific questions is generally directly proportional to the amount of effort you spend formulating your question.
-Eric Raymond and Rick Moen have even written an essay entitled "Asking Smart Questions" precisely on this topic.
-Although somewhat militant, it is definitely worth reading.</p>
-</div>
-<div class="paragraph">
-<p><strong>Note</strong>: Please do NOT send your Java problems to the two authors. They welcome feedback on the FAQ’s contents, but are
-simply not a Java help resource. Follow the essay’s advice and choose your forum carefully.</p>
-</div>
-<div class="paragraph">
-<p><strong>Keep your email short and to the point</strong></p>
-</div>
-<div class="paragraph">
-<p>If your email is more than about a page of text, chances are that it won’t get read by very many people. It is much
-better to try to pack a lot of informative information (see above about asking smart questions) into as small of an
-email as possible. If you are replying to a previous email only quote the parts that you are replying to and to remove
-the unnecessary bits. This makes it easier for people to follow a thread as well as making the email archives easier
-to search and read.</p>
-</div>
-<div class="paragraph">
-<p><strong>Do your best to ensure that you are not sending HTML or "Stylelized" email to the list</strong></p>
-</div>
-<div class="paragraph">
-<p>If you are using Outlook or Outlook Express or Eudora, chances are that you are sending HTML email by default. There is
-usually a setting that will allow you to send "Plain Text" email. If you are using Microsoft products to send email,
-there are several bugs in the software that prevent you from turning off the sending of HTML email.</p>
-</div>
-<div class="paragraph">
-<p><strong>Watch where you are sending email</strong></p>
-</div>
-<div class="paragraph">
-<p>The majority of our mailing lists have set the Reply-To to go back to the list. That means that when you Reply to a
-message, it will go to the list and not to the original author directly. The reason is because it helps facilitate
-discussion on the list for everyone to benefit from. Be careful of this as sometimes you may intend to reply to a
-message directly to someone instead of the entire list. The appropriate contents of the Reply-To header is an age-old
-debate that should not be brought up on the mailing lists. You can examine opposing points of view condemning our
-convention and condoning it. Bringing this up for debate on a mailing list will add nothing new and is considered off-topic.</p>
-</div>
-<div class="paragraph">
-<p><strong>Do not cross post messages</strong></p>
-</div>
-<div class="paragraph">
-<p>In other words, pick one mailing list and send your messages to that mailing list only. Do not send your messages to
-multiple mailing lists. The reason is that people may be subscribed to one list and not to the other. Therefore, some
-people will only see part of the conversation.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/community/release.html b/james-project/3.6.0/community/release.html
deleted file mode 100644
index 20ac8ae..0000000
--- a/james-project/3.6.0/community/release.html
+++ /dev/null
@@ -1,582 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Creating an official Apache James release :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../servers/extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../servers/test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item is-current-page" data-depth="2">
- <a class="nav-link" href="release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Server</a></li>
- <li><a href="index.html">Community</a></li>
- <li><a href="release.html">Creating an official Apache James release</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../3.8.1/community/release.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="release.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/community/pages/release.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Creating an official Apache James release</h1>
-<div class="paragraph">
-<p>Read details about <a href="http://www.apache.org/dev/publishing-maven-artifacts.html">Publishing Maven releases to Maven Central Repository</a></p>
-</div>
-<div class="paragraph">
-<p>In short, just follow the 'standard' process:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>prepare pom for release</p>
-</li>
-<li>
-<p>publish snapshot</p>
-</li>
-<li>
-<p>prepare release</p>
-</li>
-<li>
-<p>stage the release for a vote (don’t forget to close the staging repository)</p>
-</li>
-<li>
-<p>vote</p>
-</li>
-<li>
-<p>release</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Don’t forget to add your key to <a href="https://downloads.apache.org/james/KEYS" class="bare">https://downloads.apache.org/james/KEYS</a></p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ ssh people.apache.org
-$ cd /www/www.apache.org/dist/james</pre>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/community/support.html b/james-project/3.6.0/community/support.html
deleted file mode 100644
index e85b586..0000000
--- a/james-project/3.6.0/community/support.html
+++ /dev/null
@@ -1,575 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Professional support :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../servers/extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../servers/test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item is-current-page" data-depth="2">
- <a class="nav-link" href="support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Server</a></li>
- <li><a href="index.html">Community</a></li>
- <li><a href="support.html">Professional support</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../3.8.1/community/support.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="support.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/community/pages/support.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Professional support</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>Here is a list of companies which can provide you some support on James.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_linagora"><a class="anchor" href="#_linagora"></a>Linagora</h2>
-<div class="sectionbody">
-<div class="imageblock">
-<div class="content">
-<a class="image" href="https://linagora.com"><img src="_images/linagora.png" alt="linagora"></a>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>Linagora</strong> is an Open Source Software Company.</p>
-</div>
-<div class="paragraph">
-<p>Their mission is to bring digital independency to their customers.</p>
-</div>
-<div class="paragraph">
-<p>They are focused on large organizations both from private and public sector. They have set themselves the goal of
-helping Governments to achieve their digital sovereignty.</p>
-</div>
-<div class="paragraph">
-<p><strong>Linagora</strong> can offer professional services related to James: support, feature development or project integration.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/community/website.html b/james-project/3.6.0/community/website.html
deleted file mode 100644
index 0bee4ab..0000000
--- a/james-project/3.6.0/community/website.html
+++ /dev/null
@@ -1,637 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Building and publishing the website :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../servers/extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../servers/test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="download.html">Download releases</a>
- </li>
- <li class="nav-item is-current-page" data-depth="2">
- <a class="nav-link" href="website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Server</a></li>
- <li><a href="index.html">Community</a></li>
- <li><a href="website.html">Building and publishing the website</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../3.8.1/community/website.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="website.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/community/pages/website.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Building and publishing the website</h1>
-<div class="paragraph">
-<p>The source code of website <a href="https://james.apache.org">james.apache.org</a> is located in src/homepage.
-Here are the instructions how to publish new changes to the website.</p>
-</div>
-<div class="olist arabic">
-<ol class="arabic">
-<li>
-<p>Install Apache Maven 3.0.2+ and make its binary 'mvn' available on your PATH.
-See <a href="http://maven.apache.org/download.html#Installation" class="bare">http://maven.apache.org/download.html#Installation</a>.</p>
-</li>
-<li>
-<p>run "mvn clean site"</p>
-</li>
-<li>
-<p>Test the built site in your browser from the {path}/target/site folder</p>
-</li>
-<li>
-<p>If everything looks OK, deploy the site using "mvn clean site-deploy".</p>
-</li>
-<li>
-<p>Wait for the changes to replicate to the Apache web server or setup 140.211.11.10:80 as
-a proxy to review the changes (described here: <a href="http://www.apache.org/dev/project-site.html" class="bare">http://www.apache.org/dev/project-site.html</a>)</p>
-</li>
-</ol>
-</div>
-<div class="paragraph">
-<p>To deploy the technical reports use the "-Psite-reports" profile.</p>
-</div>
-<div class="paragraph">
-<p>For wagon-ssh-external configuration see
-<a href="http://maven.apache.org/plugins/maven-deploy-plugin/examples/deploy-ssh-external.html" class="bare">http://maven.apache.org/plugins/maven-deploy-plugin/examples/deploy-ssh-external.html</a></p>
-</div>
-<div class="paragraph">
-<p>You can alternatively use a docker container to build the website :</p>
-</div>
-<div class="paragraph">
-<p>You need to build the homepage by:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ docker build -t james/homepage dockerfiles/site/homepage
-$ docker run -v $PWD:/origin -v $PWD/site:/destination james/homepage master</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>In order to test the homepage, you can use this command:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ docker run --rm -v $PWD/site:/srv/jekyll -p 4000:4000 -it jekyll/minimal:3.8.3 jekyll serve</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>the site will be available at <a href="http://localhost:4000/" class="bare">http://localhost:4000/</a></p>
-</div>
-<div class="paragraph">
-<p>Then you build the other pages by:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ docker build -t james/site dockerfiles/site/website
-$ docker run -v $PWD/.m2:/root/.m2 -v $PWD:/origin -v $PWD/site:/destination james/site master</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If you need to update the current site, checkout the branch asf-site from Apache git:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ git clone https://git-wip-us.apache.org/repos/asf/james-site.git
-$ cd james-site
-$ git checkout origin/asf-site -b asf-site</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>And replace in the previous commands <code>$PWD/site</code> by <code><james-site-clone-directory>/content</code>, for example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ docker run -v $PWD:/origin -v $PWD/../james-site/content:/destination james/homepage master
-$ docker run -v $PWD/.m2:/root/.m2 -v $PWD/../james-site/content:/origin -v $PWD/site:/destination james/site master</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Then just push the new site:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ cd ../james-site
-$ git push origin asf-site</pre>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/concepts/configuration.html b/james-project/3.6.0/concepts/configuration.html
deleted file mode 100644
index 6e9ded8..0000000
--- a/james-project/3.6.0/concepts/configuration.html
+++ /dev/null
@@ -1,584 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Configuration :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="processing/index.html">Processing</a>
- </li>
- <li class="nav-item is-current-page" data-depth="2">
- <a class="nav-link" href="configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../servers/extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../servers/test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Server</a></li>
- <li><a href="index.html">Concepts</a></li>
- <li><a href="configuration.html">Configuration</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../3.8.1/concepts/configuration.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="configuration.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/concepts/pages/configuration.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Configuration</h1>
-<div class="sect1">
-<h2 id="_overview"><a class="anchor" href="#_overview"></a>Overview</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>An important aspect to understand about James is the idea of "configuration".
-Sometimes "configuration" means different things to different people, so we
-wanted to ensure that what we mean by the concept is clear and precise,
-because in order operate a James server, you will necessarily need to
-configure it.</p>
-</div>
-<div class="paragraph">
-<p>A "<strong>Configuration</strong>" is a <a href="https://martinfowler.com/bliki/ValueObject.html">value object</a>
-that communicates to a James server how the <a href="user/index.html#_operator" class="xref page">Operator</a> wishes the
-server to behave. It is very similar to an interface, but yet it is not quite an interface
-(which is why we call it something different).</p>
-</div>
-<div class="paragraph">
-<p>An "interface" provides a means for an Operator to interact with a server as part of the
-normal course of ongoing operations. Interfacing with the system essentially means either
-reading the server’s current state, or updating the server’s current state. A typical example
-would be adding a new mailbox via the <a href="#concepts:???.adoc" class="xref unresolved">Useradmin API</a>. Each time the Operator
-interacts with the system via an interface, although the <strong>state</strong> of the system may change,
-the <strong>behavior</strong> of the system is not expected to change.</p>
-</div>
-<div class="paragraph">
-<p>By contrast, "configuration" of a system (also a noun, but yet not the same as the
-"Configuration" we mention above) is more like a switching mechanism that instructs the server
-how to behave given some kind of interaction via an interface. For example, if a James server
-is configured to allow multiple domains, then if an Operator adds "<a href="mailto:user@domain1.com">user@domain1.com</a>" and
-"<a href="mailto:user@domain2.com">user@domain2.com</a>", the server will happily accept the command. If only a single domain is
-permitted via configuration, then only one of those mailboxes will be allowed. In other words,
-given the same interaction by the Operator, given different configurations the behavior of
-the system is different.</p>
-</div>
-<div class="paragraph">
-<p>Some systems call these "settings", so as a user of a system you would "configure your settings".</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/concepts/glossary.html b/james-project/3.6.0/concepts/glossary.html
deleted file mode 100644
index a0a2975..0000000
--- a/james-project/3.6.0/concepts/glossary.html
+++ /dev/null
@@ -1,625 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Glossary :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="configuration.html">Configuration</a>
- </li>
- <li class="nav-item is-current-page" data-depth="2">
- <a class="nav-link" href="glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../servers/extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../servers/test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Server</a></li>
- <li><a href="index.html">Concepts</a></li>
- <li><a href="glossary.html">Glossary</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../3.8.1/concepts/glossary.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="glossary.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/concepts/pages/glossary.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Glossary</h1>
-<div id="email_client" class="dlist">
-<dl>
-<dt class="hdlist1">Email Client</dt>
-<dd>
-<p>Any software application that acts as a POP Client or an IMAP Client.</p>
-</dd>
-<dt class="hdlist1"><a href="messages/imf.html" class="xref page">IMF</a></dt>
-<dd>
-<p><strong>Internet Message Format</strong> (IMF) is the base specification that defines the
-syntax of an email message.</p>
-</dd>
-</dl>
-</div>
-<div id="email_server" class="dlist">
-<dl>
-<dt class="hdlist1">Email Server (or Mail Server)</dt>
-<dd>
-<p>Any host that contains a sofware application that acts as a POP Server, an
-IMAP Server, or an MTA.</p>
-</dd>
-<dt class="hdlist1">IMAP</dt>
-<dt class="hdlist1">IMAP Client</dt>
-<dd>
-<p>One of the main actors in an email system that implements the IMAP protocol. The client
-acts as a slave, in that it mirrors the state of the IMAP Server.</p>
-</dd>
-<dt class="hdlist1">IMAP Server</dt>
-<dd>
-<p>One of the main actors in an email system that implements the IMAP protocol. The server
-acts as the master, in that it dictates the state that will be seen on each of the
-IMAP Clients.</p>
-</dd>
-<dt class="hdlist1">JMAP</dt>
-<dt class="hdlist1"><a href="messages/mime.html" class="xref page">MIME</a></dt>
-<dd>
-<p><strong>Multipurpose Internet Mail Extension</strong> (MIME) is a specification that extends
-IMF, defining most of the "advanced" features of email.</p>
-</dd>
-</dl>
-</div>
-<div id="mta" class="dlist">
-<dl>
-<dt class="hdlist1">MTA</dt>
-<dd>
-<p>A <strong>Mail Transfer Agent</strong> (MTA) is a host that is capable of providing a mail
-transport service compliant with the SMTP protocol.</p>
-</dd>
-<dt class="hdlist1">MUA</dt>
-<dd>
-<p>A <strong>Mail User Agent</strong> (MUA) is either an agent that hands over a message to an initial
-MTA on the originating side of a transmission, or receives the message from the
-final MTA on the terminating side of a transmission. It is in some respects similar to
-an MTA, but is local in scope and does not necessarily follow a known specification.</p>
-</dd>
-<dt class="hdlist1"><a href="protocols/smtp.html" class="xref page">SMTP</a></dt>
-<dd>
-<p><strong>Simple Mail Transfer Protocol</strong> (SMTP) is a protocol that specifies how to transmit
-a valid email message from one MTA to another.</p>
-</dd>
-</dl>
-</div>
-<div id="open_relay" class="dlist">
-<dl>
-<dt class="hdlist1">Open Relay</dt>
-<dt class="hdlist1">POP</dt>
-<dt class="hdlist1">POP Client</dt>
-<dd>
-<p>One of the main actors in an email system that implements the POP protocol. The client
-is on the host that is closest to the user from a logical perspective, and is the host
-to which messages are delivered from the POP Server.</p>
-</dd>
-<dt class="hdlist1">POP Server</dt>
-<dd>
-<p>One of the main actors in an email system that implements the POP protocol. The server
-is part of the host that is logically farthest from the user. It is the host on which
-the messages are initially delivered, and where they temporarily await collection by
-the POP Client.</p>
-</dd>
-</dl>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/concepts/index.html b/james-project/3.6.0/concepts/index.html
deleted file mode 100644
index 26f482b..0000000
--- a/james-project/3.6.0/concepts/index.html
+++ /dev/null
@@ -1,623 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Apache James Core Concepts :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../servers/extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../servers/test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Server</a></li>
- <li><a href="index.html">Concepts</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../3.8.1/concepts/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="index.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/concepts/pages/index.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Apache James Core Concepts</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>The core domain of Apache James is intimitely related to email communications.
-Therefore this section is divided into topics that deal with the various
-aspect of email systems.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="#emails">Email Messages</a></p>
-</li>
-<li>
-<p><a href="#protocols">Transmission Protocols</a></p>
-</li>
-<li>
-<p><a href="#mailbox">Mailbox and Email Storage</a></p>
-</li>
-<li>
-<p><a href="#processing">Email Processing</a></p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="emails"><a class="anchor" href="#emails"></a>Email Messages</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Electronic Mail (often written as "e-mail" or "email") is a means of
-exchanging messages over a data network. In our context, it is obvious
-that we mean "electronic mail" and not "postal mail", so we usually just
-write "mail".</p>
-</div>
-<div class="paragraph">
-<p><a href="mail/index.html" class="xref page">Email messages</a> are based on a few specifications
-that are not easy to digest, so we make an effort to provide a simplified
-model.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="protocols"><a class="anchor" href="#protocols"></a>Transmission Protocols</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Emails are only useful because people can communicate with each other.
-To allow for this, obviously there must be a means of transmitting messages
-from one user to another. A number of different protocols have emerged to
-handle the various different requirements of using email in a practical
-manner. The most common <a href="protocols/index.html" class="xref page">transmission protocols</a>
-are SMTP, POP, and IMAP. More recently JMAP is an interesting protocol
-that merits attention.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="mailbox"><a class="anchor" href="#mailbox"></a>Mailbox and Email Storage</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Email would not be very useful if, like in <a href="https://www.youtube.com/watch?v=0TiqXFssKMY">Mission Impossible</a>,
-a message would self-destruct immediately after being read.
-For those of us who are not secret agents, we generally prefer to keep
-a record of those messages that we receive. For this reason we need a means
-of <a href="storage/index.html" class="xref page">storing messages</a>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="processing"><a class="anchor" href="#processing"></a>Email Processing</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>There are many ways to peel a potato. James has its own particular
-<a href="processing/index.html" class="xref page">model for processing mail</a>,
-based mostly on the concept of a "Mailet". The idea of Mailet-based
-processing was heavily inspired by the <a href="https://en.wikipedia.org/wiki/Java_servlet">Servlet</a>
-concept.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/concepts/mail/index.html b/james-project/3.6.0/concepts/mail/index.html
deleted file mode 100644
index c95fb0c..0000000
--- a/james-project/3.6.0/concepts/mail/index.html
+++ /dev/null
@@ -1,568 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>All About Emails :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../user/index.html">User Model</a>
- </li>
- <li class="nav-item is-current-page" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../servers/extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../servers/test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../index.html">Apache James Server</a></li>
- <li><a href="../index.html">Concepts</a></li>
- <li><a href="index.html">Emails</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../../3.8.1/concepts/mail/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="index.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/concepts/pages/mail/index.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">All About Emails</h1>
-<div class="paragraph">
-<p>The <a href="https://en.wikipedia.org/wiki/History_of_email">history of email</a> has resulted
-in a convoluted patchwork of standards and practices, which can be very difficult
-to understand and decipher. Fortunately, James has your back.</p>
-</div>
-<div class="paragraph">
-<p>We have built up our own view of emails that allows us to process messages in a
-consistent and comprehensible way.</p>
-</div>
-<div class="paragraph">
-<p>To help you understand how James approaches emails, we have divided this section
-up into the following parts:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="../messages/index.html" class="xref page">Email Messages</a></p>
-</li>
-<li>
-<p><a href="../protocols/index.html" class="xref page">Transmission Protocols</a></p>
-</li>
-</ul>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../_/js/site.js" data-ui-root-path="../../../../_"></script>
-<script async src="../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/concepts/messages/imf.html b/james-project/3.6.0/concepts/messages/imf.html
deleted file mode 100644
index 42dd2b8..0000000
--- a/james-project/3.6.0/concepts/messages/imf.html
+++ /dev/null
@@ -1,640 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Internet Message Format :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../servers/extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../servers/test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../index.html">Apache James Server</a></li>
- <li><a href="imf.html">Internet Message Format</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../../3.8.1/concepts/messages/imf.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="imf.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/concepts/pages/messages/imf.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Internet Message Format</h1>
-<div class="sect1">
-<h2 id="_overview"><a class="anchor" href="#_overview"></a>Overview</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>What people casually call "email" actually refers more specifically to a
-text message written in a specified format called
-<a href="https://en.wikipedia.org/wiki/Email">"Internet Message Format"</a> or "IMF".
-After the first IMF specification was published in 1982 there was no looking back.
-Email took the world by storm. Today it is arguably the most prevalent means of
-communicating with a distant party.</p>
-</div>
-<div class="paragraph">
-<p>IMF is very basic, and is limited to only specifying a syntax for text messages.
-For the transmission of images, audio, or other types of data we need to make
-use of the <a href="#mail/messages/mime.adoc" class="xref unresolved">MIME</a> specification.
-Although IMF forms the base standard upon which
-email is based, email today is rarely used without MIME. We therefore consider
-for practical purposes that an email message is essentially the equivalent of
-a MIME message.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_specifications"><a class="anchor" href="#_specifications"></a>Specifications</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The specifications for Internet Message Format (IMF) form the basis of what we commonly
-call "email".</p>
-</div>
-<div class="sect2">
-<h3 id="_rfc822"><a class="anchor" href="#_rfc822"></a>RFC822</h3>
-<div class="paragraph">
-<p><a href="https://tools.ietf.org/html/rfc822">RFC822</a> ("Standard for the Format of ARPA Internet Text Messages")
-was the original standard that defined the format of an email. It was obsoleted by
-<a href="#_rfc2822">RFC2822</a>. The definition of an email under this standard was an attempt to take the lessons
-learned from the ARPANET and extend the use of text messaging to a broader context.</p>
-</div>
-<div class="paragraph">
-<p>Electronic mail messages are defined as having contents and an envelope. The contents
-consist of header fields and, optionally, a body. The body is nothing more than
-a (potentially empty) sequence of lines of text.</p>
-</div>
-<div class="paragraph">
-<p>Although this sounds like a an extremely simple concept, to get two completely separate systems
-to agree and understand each other is a surprisingly complex problem that most people
-today take for granted. Most of RFC822 deals with the nitty-gritty of formatting and parsing
-this type of text message.</p>
-</div>
-<div class="paragraph">
-<p>This specification deals with the headers, additionally relating them to the sending and
-forwarding of messages. The body content is dealt with in <a href="#RFC2045">[RFC2045]</a></p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_rfc2822"><a class="anchor" href="#_rfc2822"></a>RFC2822</h3>
-<div class="paragraph">
-<p><a href="https://tools.ietf.org/html/rfc2822">RFC2822</a> ("Internet Message Format")
-obsoletes <a href="#_rfc822">RFC822</a>, and was obsoleted by <a href="#_rfc5322">RFC5322</a>.</p>
-</div>
-<div class="paragraph">
-<p>The standard builds on RFC822, but limits its scope to only the sytax of the
-message, and obsoletes much of what was defined by RFC822. The envelope was
-split into a separate specification, <a href="#RFC2821">[RFC2821]</a>.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_rfc5322"><a class="anchor" href="#_rfc5322"></a>RFC5322</h3>
-<div class="paragraph">
-<p><a href="https://tools.ietf.org/html/rfc5322">RFC5322</a> ("Internet Message Format")
-was published in 2008.
-It obsoletes <a href="#_rfc2822">RFC2822</a> and is currently the specification still actually in use.</p>
-</div>
-<div class="paragraph">
-<p>It builds on RFC2822, updating it to the then-current context and obsoleting
-outdated parts of RFC2822.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_james_model"><a class="anchor" href="#_james_model"></a>James Model</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>While the general description of IMF is not sufficient for building a complex
-system like James, the technical specifications are unfortunately
-very messy and overly-complex due to their history and the context in which
-they were developed.</p>
-</div>
-<div class="paragraph">
-<p>Since modern-day messaging almost always requires MIME, and since the
-separation between IMF and MIME is not really useful from a usage perspective,
-James considers an "email" to be both IMF- an MIME-compliant. For all intents
-and purposes, James does not consider the concept of IMF in its domain model.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../_/js/site.js" data-ui-root-path="../../../../_"></script>
-<script async src="../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/concepts/messages/index.html b/james-project/3.6.0/concepts/messages/index.html
deleted file mode 100644
index 5fde4e8..0000000
--- a/james-project/3.6.0/concepts/messages/index.html
+++ /dev/null
@@ -1,565 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Email Messages :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../servers/extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../servers/test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../index.html">Apache James Server</a></li>
- <li><a href="index.html">Email Messages</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../../3.8.1/concepts/messages/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="index.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/concepts/pages/messages/index.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Email Messages</h1>
-<div class="paragraph">
-<p>An email message is essentially a simple text message that is communicated
-from one party to another. It is no miracle that two unknown parties are
-able to communicate; rather rather we can thank a set of standards that
-allow any two unrelated systems to process an email even if the system owners
-do not know each other.</p>
-</div>
-<div class="paragraph">
-<p>The two most important standards upon which today’s emails are based
-are:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="imf.html" class="xref page">Internet Mail Format</a> (IMF)</p>
-</li>
-<li>
-<p><a href="mime.html" class="xref page">Multipurpose Internet Mail Extensions</a> (MIME)</p>
-</li>
-</ul>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../_/js/site.js" data-ui-root-path="../../../../_"></script>
-<script async src="../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/concepts/messages/mime.html b/james-project/3.6.0/concepts/messages/mime.html
deleted file mode 100644
index 87da964..0000000
--- a/james-project/3.6.0/concepts/messages/mime.html
+++ /dev/null
@@ -1,651 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Multipurpose Internet Mail Extensions :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../servers/extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../servers/test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../index.html">Apache James Server</a></li>
- <li><a href="mime.html">Multipurpose Internet Mail Extensions</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../../3.8.1/concepts/messages/mime.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="mime.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/concepts/pages/messages/mime.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Multipurpose Internet Mail Extensions</h1>
-<div class="sect1">
-<h2 id="_overview"><a class="anchor" href="#_overview"></a>Overview</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The base format of an email message is <a href="imf.html" class="xref page">Internet Message Format"</a>,
-but most contemporary messages use a format called
-<a href="https://en.wikipedia.org/wiki/MIME">"Multipurpose Internet Mail Extensions"</a>.
-MIME specifies how to extend a valid IMF message, dealing with character encodings,
-various file formats, and many other odds and ends that make email what it is today.</p>
-</div>
-<div class="paragraph">
-<p>A user of email rarely has to be concerned with the MIME specifications. Usually the
-communications system should take care of all the nitty gritty, and even then MIME
-processing is usually at a very low level. For this reason, the blissfully simple
-conception of a simple "email" is usually just fine from the perspective of a user
-and even in most cases for a developer.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_specifications"><a class="anchor" href="#_specifications"></a>Specifications</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Multipurpose Internet Mail Extensions, or just MIME, functions much like an extension
-to IMF in order to:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Add different character sets for internationalization</p>
-</li>
-<li>
-<p>Allow for processing of media types other than plain text</p>
-</li>
-</ul>
-</div>
-<div class="sect2">
-<h3 id="_rfc2045"><a class="anchor" href="#_rfc2045"></a>RFC2045</h3>
-<div class="paragraph">
-<p><a href="https://tools.ietf.org/html/rfc2045">RFC2045</a> ("Multipurpose Internet Mail Extensions
-Part One: Format of Internet Message Bodies")
-describes the message body format of an email. It is part of a serious of MIME
-specifications including <a href="#_rfc2046">RFC2046</a>, <a href="#_rfc2047">RFC2047</a>, <a href="#_rfc2048">RFC2048</a>, and <a href="#_rfc2049">RFC2049</a>.
-This particular document in the series specifies the various headers that
-are used to describe the structure of a MIME message.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_rfc2046"><a class="anchor" href="#_rfc2046"></a>RFC2046</h3>
-<div class="paragraph">
-<p><a href="https://tools.ietf.org/html/rfc2046">RFC2046</a> ("Multipurpose Internet Mail Extensions
-Part Two: Media Types") describes the various MIME media types, such as
-plain text, images, videos, etc. It is part of the serious of MIME specifications
-that includes <a href="#_rfc2045">RFC2045</a>, <a href="#_rfc2047">RFC2047</a>, <a href="#_rfc2048">RFC2048</a>, and <a href="#_rfc2049">RFC2049</a>.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_rfc2047"><a class="anchor" href="#_rfc2047"></a>RFC2047</h3>
-<div class="paragraph">
-<p><a href="https://tools.ietf.org/html/rfc2047">RFC2047</a> ("MIME Part Three:
-Message Header Extensions for Non-ASCII Text") describes, as the
-title indicates, header extensions for non-ASCII text. It is part
-of the series of MIME specifications that includes
-<a href="#_rfc2045">RFC2045</a>, <a href="#_rfc2046">RFC2046</a>, <a href="#_rfc2048">RFC2048</a>, and <a href="#_rfc2049">RFC2049</a>.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_rfc2048"><a class="anchor" href="#_rfc2048"></a>RFC2048</h3>
-<div class="paragraph">
-<p><a href="https://tools.ietf.org/html/rfc2048">RFC2048</a> ("Multipurpose Internet Mail Extensions
-Part Four: Registration Procedures") describes the procedure for registering a MIME
-type. It is not directly relevant to James, but is part of the MIME series that includes
-<a href="#_rfc2045">RFC2045</a>, <a href="#_rfc2046">RFC2046</a>, <a href="#_rfc2047">RFC2047</a>, and <a href="#_rfc2049">RFC2049</a>.</p>
-</div>
-<div class="paragraph">
-<p>This specification was obsoleted by <a href="https://tools.ietf.org/html/rfc4288">RFC4288</a>
-(which itself was obsoleted by <a href="https://tools.ietf.org/html/rfc6838">RFC6838</a>) and
-<a href="https://tools.ietf.org/html/rfc4289">RFC4289</a>.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_rfc2049"><a class="anchor" href="#_rfc2049"></a>RFC2049</h3>
-<div class="paragraph">
-<p><a href="https://tools.ietf.org/html/rfc2049">RFC2049</a> ("Multipurpose Internet Mail Extensions
-Part Five: Conformance Criteria and Examples") mainly describes what portions of MIME
-must be supported by a conformant MIME implementation. It is part of the series that includes
-<a href="#_rfc2045">RFC2045</a>, <a href="#_rfc2046">RFC2046</a>, <a href="#_rfc2047">RFC2047</a>, and <a href="#_rfc2049">RFC2049</a>.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_james_model"><a class="anchor" href="#_james_model"></a>James Model</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>While a general, non-technical description of MIME is useful for most users
-and developers, it is not sufficient for building a complex system like James. Meanwhile,
-the technical specifications are unfortunately very messy and overly-complex due to
-their history and the context in which they were developed. To make dealing with
-emails possible and practical, James has defined its own version of what it means
-to be an email.</p>
-</div>
-<div class="paragraph">
-<p>(TODO need a reference, please!)</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../_/js/site.js" data-ui-root-path="../../../../_"></script>
-<script async src="../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/concepts/processing/index.html b/james-project/3.6.0/concepts/processing/index.html
deleted file mode 100644
index 1f4e0ae..0000000
--- a/james-project/3.6.0/concepts/processing/index.html
+++ /dev/null
@@ -1,548 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Mail Processing Domain Model :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item is-current-page" data-depth="2">
- <a class="nav-link" href="index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../servers/extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../servers/test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../index.html">Apache James Server</a></li>
- <li><a href="../index.html">Concepts</a></li>
- <li><a href="index.html">Processing</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../../3.8.1/concepts/processing/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="index.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/concepts/pages/processing/index.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Mail Processing Domain Model</h1>
-<div class="paragraph">
-<p>(TODO)</p>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../_/js/site.js" data-ui-root-path="../../../../_"></script>
-<script async src="../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/concepts/protocols/esmtp.html b/james-project/3.6.0/concepts/protocols/esmtp.html
deleted file mode 100644
index 5ac88eb..0000000
--- a/james-project/3.6.0/concepts/protocols/esmtp.html
+++ /dev/null
@@ -1,612 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>SMTP Service Extensions (ESMTP) :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="jmap.html">JMAP</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../servers/extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../servers/test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../index.html">Apache James Server</a></li>
- <li><a href="../index.html">Concepts</a></li>
- <li><a href="index.html">Protocols</a></li>
- <li><a href="esmtp.html">ESMTP</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../../3.8.1/concepts/protocols/esmtp.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="esmtp.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/concepts/pages/protocols/esmtp.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">SMTP Service Extensions (ESMTP)</h1>
-<div class="sect1">
-<h2 id="_overview"><a class="anchor" href="#_overview"></a>Overview</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p><a href="https://en.wikipedia.org/wiki/Extended_SMTP">SMTP Service Extensions</a>, written as "ESMTP"
-and characterized in the literature as "Extended SMTP" (and sometimes "Enhanced SMTP")
-is a framework for extending SMTP. Extensions are expected to be registered with
-IANA and negotiated between the client and server.</p>
-</div>
-<div class="paragraph">
-<p>Whereas SMTP mandates that a session begins with the "HELO" command, ESMTP requires
-the "EHLO" (extended hello) command. Note that nowadays even "standard" SMTP uses
-EHLO as its initial greeting, and only falls back to HELO, so in a sense every
-SMTP server has effectively become an ESMTP server.</p>
-</div>
-<div class="paragraph">
-<p>The ESMTP specification itself no longer actually exists independently of SMTP.
-We mention it here mostly for completion, historical purposes, and as a reference
-to a concept that is still very much in use, albeit now as a concept internal to
-SMTP.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_specifications"><a class="anchor" href="#_specifications"></a>Specifications</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_rfc1425"><a class="anchor" href="#_rfc1425"></a>RFC1425</h3>
-<div class="paragraph">
-<p><a href="https://tools.ietf.org/html/rfc1425">RFC1425</a> ("SMTP Service Extensions") is the originally
-published ESMTP specification. It was obsoleted by <a href="#_rfc1651">RFC1651</a>.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_rfc1651"><a class="anchor" href="#_rfc1651"></a>RFC1651</h3>
-<div class="paragraph">
-<p><a href="https://tools.ietf.org/html/rfc1651">RFC1651</a> ("SMTP Service Extensions") obsoletes <a href="#_rfc1425">RFC1425</a>
-and was itself obsoleted by <a href="#_rfc1869">RFC1869</a>.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_rfc1869"><a class="anchor" href="#_rfc1869"></a>RFC1869</h3>
-<div class="paragraph">
-<p><a href="https://tools.ietf.org/html/rfc1869">RFC1869</a> ("SMTP Service Extensions") obsoletes <a href="#_rfc1651">RFC1651</a>, and
-is essentially the final specification in which ESMTP was defined separately from SMTP. When this
-spec was obsoleted by <a href="smtp.html#RFC2821" class="xref page">RFC2821</a>, it was incorporated into the
-SMTP specification.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_related_concepts"><a class="anchor" href="#_related_concepts"></a>Related Concepts</h2>
-<div class="sectionbody">
-<div class="ulist">
-<ul>
-<li>
-<p><strong><a href="smtp.html" class="xref page">SMTP</a></strong>, because ESMTP defines an extension framework for SMTP</p>
-</li>
-<li>
-<p><strong><a href="lmtp.html" class="xref page">LMTP</a></strong>, as LMTP is defined by the ESMTP framework</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../_/js/site.js" data-ui-root-path="../../../../_"></script>
-<script async src="../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/concepts/protocols/imap.html b/james-project/3.6.0/concepts/protocols/imap.html
deleted file mode 100644
index 4b5cfd8..0000000
--- a/james-project/3.6.0/concepts/protocols/imap.html
+++ /dev/null
@@ -1,828 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Internet Message Access Protocol (IMAP) :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="pop.html">POP</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../servers/extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../servers/test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../index.html">Apache James Server</a></li>
- <li><a href="../index.html">Concepts</a></li>
- <li><a href="index.html">Protocols</a></li>
- <li><a href="imap.html">IMAP</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../../3.8.1/concepts/protocols/imap.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="imap.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/concepts/pages/protocols/imap.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Internet Message Access Protocol (IMAP)</h1>
-<div class="sect1">
-<h2 id="_overview"><a class="anchor" href="#_overview"></a>Overview</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p><a href="https://en.wikipedia.org/wiki/Internet_Message_Access_Protocol">Internet Message Access Protocol</a>,
-or IMAP, is a protocol used by email clients to retrieve
-<a href="../messages/index.html" class="xref page">email messages</a> from a <a href="../glossary.html#email_server" class="xref page">mail server</a>.
-One could say that it is effectively in competition with <a href="pop.html" class="xref page">POP</a>
-because it accomplishes a function similar in nature, and most clients will force you
-to choose one or the other..
-These days, the natural choice of protocol tends to be IMAP rather than POP.</p>
-</div>
-<div class="paragraph">
-<p>The main difference between IMAP and POP is that messages are kept on the server, which
-keeps a kind of master reference. Instead of transferring the message to the client,
-only an image, or copy of the message is kept locally. When the client synchronises with
-the state of the server, it will tend to mimic that state. So if a new message is stored
-in a mailbox, it will appear on the client, or if a message is deleted from the server,
-it will also be deleted from the client.</p>
-</div>
-<div class="paragraph">
-<p>The user can control the state of server from the client by adding, deleting, or moving
-messages between folders. The user can also add folders from the client, the state of which
-will be stored on the server.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_specifications"><a class="anchor" href="#_specifications"></a>Specifications</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_imap"><a class="anchor" href="#_imap"></a>IMAP</h3>
-<div class="paragraph">
-<p>Apparently, no official specification exists for the original IMAP.
-It became a specification with the publication of <a href="#_imap2">IMAP2</a></p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_imap2"><a class="anchor" href="#_imap2"></a>IMAP2</h3>
-<div class="sect3">
-<h4 id="_rfc1064"><a class="anchor" href="#_rfc1064"></a>RFC1064</h4>
-<div class="paragraph">
-<p><a href="https://tools.ietf.org/html/rfc1064">RFC1064</a> ("Interactive Mail Access Protocol - Version 2")
-was the original IMAP2 specification, published in 1988. The specification was obsoleted
-by <a href="#_rfc1176">RFC1176</a>.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_rfc1176"><a class="anchor" href="#_rfc1176"></a>RFC1176</h4>
-<div class="paragraph">
-<p><a href="https://tools.ietf.org/html/rfc1176">RFC1176</a> ("Interactive Mail Access Protocol - Version 2")
-provides various, somewhat minor updates to <a href="#_rfc1064">RFC1064</a>. This specification was supseded by
-the first IMAP3 specification, <a href="#_rfc1203">RFC1203</a>.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_imap3"><a class="anchor" href="#_imap3"></a>IMAP3</h3>
-<div class="sect3">
-<h4 id="_rfc1203"><a class="anchor" href="#_rfc1203"></a>RFC1203</h4>
-<div class="paragraph">
-<p><a href="https://tools.ietf.org/html/rfc1203">RFC1203</a> ("Interactive Mail Access Protocol - Version 3")
-obsoletes <a href="#_rfc1064">RFC1064</a>, and presumedly also <a href="#_rfc1176">RFC1176</a>.
-It appears to be the only version of IMAP3 that was published. Apparently, IMAP3 is a rare
-version, and was never really adopted by the marketplace.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_imap4"><a class="anchor" href="#_imap4"></a>IMAP4</h3>
-<div class="sect3">
-<h4 id="_rfc1730"><a class="anchor" href="#_rfc1730"></a>RFC1730</h4>
-<div class="paragraph">
-<p><a href="https://tools.ietf.org/html/rfc1730">RFC1730</a> ("Interactive Message Access Protocol - Version 4")
-was the first version of IMAP4, published in 1994. Note that the "M" in the name was changed
-from "Mail" to "Message".
-It was obsoleted two years later by <a href="#_rfc2060">RFC2060</a>.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_rfc2060"><a class="anchor" href="#_rfc2060"></a>RFC2060</h4>
-<div class="paragraph">
-<p><a href="https://tools.ietf.org/html/rfc2060">RFC2060</a> ("Interactive Message Access Protocol - Version 4rev1")
-was the first revision of the original IMAP4 specification. It was obsoleted by <a href="#_rfc3501">RFC3501</a>.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_rfc3501"><a class="anchor" href="#_rfc3501"></a>RFC3501</h4>
-<div class="paragraph">
-<p><a href="https://tools.ietf.org/html/rfc3501">RFC3501</a> ("Interactive Message Access Protocol - Version 4rev1")
-is the current IMAP4 standard in use. Though the name is confusing, is was the second revision since
-the publication of the original IMAP4 specification. This version was published in 2003. Likely,
-there has not been a need to update this specification as instead updates are published as extensions.
-Extensions to IMAP have been published as recently as in 2018.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_extensions_to_rfc3501"><a class="anchor" href="#_extensions_to_rfc3501"></a>Extensions to RFC3501</h4>
-<div class="paragraph">
-<p>For brevity, we simply refence a number of extentions to RFC3501:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://tools.ietf.org/html/rfc4466">RFC4466</a> ("Collected Extensions to IMAP4 ABNF")</p>
-</li>
-<li>
-<p><a href="https://tools.ietf.org/html/rfc4469">RFC4469</a> ("Internet Message Access Protocol (IMAP) CATENATE Extension")</p>
-</li>
-<li>
-<p><a href="https://tools.ietf.org/html/rfc4551">RFC4551</a> ("IMAP Extension for Conditional STORE Operation or Quick Flag Changes Resynchronization")</p>
-</li>
-<li>
-<p><a href="https://tools.ietf.org/html/rfc5032">RFC5032</a> ("WITHIN Search Extension to the IMAP Protocol")</p>
-</li>
-<li>
-<p><a href="https://tools.ietf.org/html/rfc5182">RFC5182</a> ("IMAP Extension for Referencing the Last SEARCH Result")</p>
-</li>
-<li>
-<p><a href="https://tools.ietf.org/html/rfc5738">RFC5738</a> ("IMAP Support for UTF-8")</p>
-</li>
-<li>
-<p><a href="https://tools.ietf.org/html/rfc6186">RFC6186</a> ("Use of SRV Records for Locating Email Submission/Access Services")</p>
-</li>
-<li>
-<p><a href="https://tools.ietf.org/html/rfc6858">RFC6858</a> ("Simplified POP and IMAP Downgrading for Internationalized Email")</p>
-</li>
-<li>
-<p><a href="https://tools.ietf.org/html/rfc7817">RFC7817</a> ("Updated Transport Layer Security (TLS) Server Identity Check Procedure for Email-Related Protocols")</p>
-</li>
-<li>
-<p><a href="https://tools.ietf.org/html/rfc8314">RFC8314</a> ("Cleartext Considered Obsolete: Use of Transport Layer Security (TLS) for Email Submission and Access")</p>
-</li>
-<li>
-<p><a href="https://tools.ietf.org/html/rfc8437">RFC8437</a> ("IMAP UNAUTHENTICATE Extension for Connection Reuse")</p>
-</li>
-<li>
-<p><a href="https://tools.ietf.org/html/rfc8474">RFC8474</a> ("IMAP Extension for Object Identifiers")</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_related_concepts"><a class="anchor" href="#_related_concepts"></a>Related Concepts</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>IMAP is related to…​</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong><a href="pop.html" class="xref page">POP</a></strong> as a "competing" protocol</p>
-</li>
-<li>
-<p><strong><a href="../glossary.html#email_client" class="xref page">Email clients</a></strong>, as the client will provide the functionality of
-an IMAP Client and connect to the IMAP Server</p>
-</li>
-<li>
-<p><strong><a href="smtp.html" class="xref page">SMTP</a></strong>, in that messages will normally be
-delivered to the IMAP Server via SMTP.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_try_it"><a class="anchor" href="#_try_it"></a>Try It!</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>You can connect manually to James using the IMAP protocol by opening a
-telnet session.</p>
-</div>
-<div class="paragraph">
-<p>Requirements:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Run the long demo (without stopping)</p>
-</li>
-<li>
-<p>Telnet</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Approximate duration: 5 minutes</p>
-</div>
-<div class="exampleblock">
-<div class="content">
-<div class="paragraph">
-<p>Note: extra lines are inserted below to help show you what you need to type.</p>
-</div>
-</div>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-telnet hljs" data-lang="telnet">$ telnet 127.0.0.1 143
-Trying 127.0.0.1...
-Connected to localhost.
-Escape character is '^]'.
-* OK JAMES IMAP4rev1 Server Server faef5a990fbb is ready.
-
-01 login user01@james.local 1234 <i class="conum" data-value="1"></i><b>(1)</b>
-
-01 OK LOGIN completed.
-
-l list "" "*" <i class="conum" data-value="2"></i><b>(2)</b>
-
-* LIST (\HasNoChildren) "." "INBOX"
-l OK LIST completed.
-
-s select INBOX <i class="conum" data-value="3"></i><b>(3)</b>
-
-* FLAGS (\Answered \Deleted \Draft \Flagged \Seen)
-* 1 EXISTS
-* 1 RECENT
-* OK [UIDVALIDITY 749313882] UIDs valid
-* OK [UNSEEN 1] MailboxMessage 2 is first unseen
-* OK [PERMANENTFLAGS (\Answered \Deleted \Draft \Flagged \Seen \*)] Limited
-* OK [HIGHESTMODSEQ 5] Highest
-* OK [UIDNEXT 2] Predicted next UID
-s OK [READ-WRITE] SELECT completed.
-
-f FETCH 1:* (FLAGS BODY.PEEK[HEADER.FIELDS (SUBJECT)]) <i class="conum" data-value="4"></i><b>(4)</b>
-
-* 1 FETCH (FLAGS (\Seen) BODY[HEADER.FIELDS (SUBJECT)] {75}
-Subject: Test Message
-
-)
-f OK FETCH completed.
-
-d store 1 +FLAGS (\Deleted) <i class="conum" data-value="5"></i><b>(5)</b>
-
-* 1 FETCH (FLAGS (\Deleted \Seen))
-d OK STORE completed.
-
-e expunge <i class="conum" data-value="6"></i><b>(6)</b>
-
-* 1 EXPUNGE
-e OK EXPUNGE completed.
-
-l logout <i class="conum" data-value="7"></i><b>(7)</b></code></pre>
-</div>
-</div>
-<div class="colist arabic">
-<table>
-<tr>
-<td><i class="conum" data-value="1"></i><b>1</b></td>
-<td>Login as user <code>user01@james.local</code></td>
-</tr>
-<tr>
-<td><i class="conum" data-value="2"></i><b>2</b></td>
-<td>List the contents of the Mailbox</td>
-</tr>
-<tr>
-<td><i class="conum" data-value="3"></i><b>3</b></td>
-<td>Select <code>INBOX</code> as the current folder</td>
-</tr>
-<tr>
-<td><i class="conum" data-value="4"></i><b>4</b></td>
-<td>Fetch the contents of the INBOX folder, showing only the subject</td>
-</tr>
-<tr>
-<td><i class="conum" data-value="5"></i><b>5</b></td>
-<td>Mark the message for deletion</td>
-</tr>
-<tr>
-<td><i class="conum" data-value="6"></i><b>6</b></td>
-<td>Epunge the INBOX by deleting mails marked for deletion</td>
-</tr>
-<tr>
-<td><i class="conum" data-value="7"></i><b>7</b></td>
-<td>Exit the session</td>
-</tr>
-</table>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../_/js/site.js" data-ui-root-path="../../../../_"></script>
-<script async src="../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/concepts/protocols/index.html b/james-project/3.6.0/concepts/protocols/index.html
deleted file mode 100644
index 2489cd3..0000000
--- a/james-project/3.6.0/concepts/protocols/index.html
+++ /dev/null
@@ -1,575 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Transmission Protocols :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item is-current-page" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../servers/extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../servers/test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../index.html">Apache James Server</a></li>
- <li><a href="../index.html">Concepts</a></li>
- <li><a href="index.html">Protocols</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../../3.8.1/concepts/protocols/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="index.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/concepts/pages/protocols/index.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Transmission Protocols</h1>
-<div class="paragraph">
-<p>The true value of email is that any one party can communicate with any
-other party located virtually anywhere. All they need are a common understanding
-of a <a href="../messages/index.html" class="xref page">message format</a>, and a means of
-transmitting the message.</p>
-</div>
-<div class="paragraph">
-<p>Transmitting email messages between parties requires a mutually-known protocol.
-It turns out that there are several standard protocols used for the
-transmission of email messages, each with a different purpose:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="smtp.html" class="xref page">Simple Mail Transfer</a></p>
-</li>
-<li>
-<p><a href="pop.html" class="xref page">Post Office</a></p>
-</li>
-<li>
-<p><a href="imap.html" class="xref page">Internet Message Access</a></p>
-</li>
-<li>
-<p><a href="jmap.html" class="xref page">JSON Meta Application</a></p>
-</li>
-<li>
-<p><a href="lmtp.html" class="xref page">Local Mail Transfer</a></p>
-</li>
-</ul>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../_/js/site.js" data-ui-root-path="../../../../_"></script>
-<script async src="../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/concepts/protocols/jmap.html b/james-project/3.6.0/concepts/protocols/jmap.html
deleted file mode 100644
index 6ea63c4..0000000
--- a/james-project/3.6.0/concepts/protocols/jmap.html
+++ /dev/null
@@ -1,549 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>JSON Meta Application Protocol (JMAP) :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="imap.html">IMAP</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../servers/extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../servers/test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../index.html">Apache James Server</a></li>
- <li><a href="../index.html">Concepts</a></li>
- <li><a href="index.html">Protocols</a></li>
- <li><a href="jmap.html">JMAP</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../../3.8.1/concepts/protocols/jmap.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="jmap.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/concepts/pages/protocols/jmap.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">JSON Meta Application Protocol (JMAP)</h1>
-<div class="paragraph">
-<p>(TODO)</p>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../_/js/site.js" data-ui-root-path="../../../../_"></script>
-<script async src="../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/concepts/protocols/lmtp.html b/james-project/3.6.0/concepts/protocols/lmtp.html
deleted file mode 100644
index 905ca70..0000000
--- a/james-project/3.6.0/concepts/protocols/lmtp.html
+++ /dev/null
@@ -1,595 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Local Mail Transfer Protocol (LMTP) :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../servers/extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../servers/test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../index.html">Apache James Server</a></li>
- <li><a href="../index.html">Concepts</a></li>
- <li><a href="index.html">Protocols</a></li>
- <li><a href="lmtp.html">LMTP</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../../3.8.1/concepts/protocols/lmtp.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="lmtp.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/concepts/pages/protocols/lmtp.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Local Mail Transfer Protocol (LMTP)</h1>
-<div class="sect1">
-<h2 id="_overview"><a class="anchor" href="#_overview"></a>Overview</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p><a href="https://en.wikipedia.org/wiki/Local_Mail_Transfer_Protocol">Local Mail Transfer Protocol</a> ("LMTP")
-is</p>
-</div>
-<div class="paragraph">
-<p>From <a href="#_rfc2033">RFC2033</a>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>Although LMTP is an alternative protocol to ESMTP, it uses (with a
-few changes) the syntax and semantics of ESMTP. This design permits
-LMTP to utilize the extensions defined for ESMTP. LMTP should be
-used only by specific prior arrangement and configuration, and it
-MUST NOT be used on TCP port 25.</pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_specifications"><a class="anchor" href="#_specifications"></a>Specifications</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_rfc2033"><a class="anchor" href="#_rfc2033"></a>RFC2033</h3>
-<div class="paragraph">
-<p><a href="https://tools.ietf.org/html/rfc2033">RFC2033</a> ("Local Mail Transfer Protocol") was published
-in 1996, and defines a simplified protocol for local mail delivery mainly inspired by
-<a href="esmtp.html" class="xref page">ESMTP</a>. It is the first, last, and only specification of its kind.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_related_concepts"><a class="anchor" href="#_related_concepts"></a>Related Concepts</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>LMTP relates to:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong><a href="esmtp.html" class="xref page">ESMTP</a></strong>, as it is a derivative thereof</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../_/js/site.js" data-ui-root-path="../../../../_"></script>
-<script async src="../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/concepts/protocols/pop.html b/james-project/3.6.0/concepts/protocols/pop.html
deleted file mode 100644
index c204a5f..0000000
--- a/james-project/3.6.0/concepts/protocols/pop.html
+++ /dev/null
@@ -1,717 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Post Office Protocol (POP) :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="smtp.html">SMTP</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../servers/extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../servers/test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../index.html">Apache James Server</a></li>
- <li><a href="../index.html">Concepts</a></li>
- <li><a href="index.html">Protocols</a></li>
- <li><a href="pop.html">POP</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../../3.8.1/concepts/protocols/pop.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="pop.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/concepts/pages/protocols/pop.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Post Office Protocol (POP)</h1>
-<div class="sect1">
-<h2 id="_overview"><a class="anchor" href="#_overview"></a>Overview</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The <a href="https://en.wikipedia.org/wiki/Post_Office_Protocol">Post Office Protocol</a>,
-or POP, is described in the original specification
-as being "a simple method for workstations to dynamically access mail from
-a <a href="../storage/index.html" class="xref page">mailbox server</a>" (though interestingly "mailbox server"
-is never actually defined in this specification nor in later specifications. 🤔)</p>
-</div>
-<div class="paragraph">
-<p>POP was proposed as the first non-<a href="smtp.html" class="xref page">SMTP</a> protocol aimed
-at users for the purpose of retrieving emails stored remotely for local consumption.
-POP was developed in pre-spam days, so was inherently a non-secure protocol.
-It has been updated several times to address several issues, including lack of
-security, so that POP3 is now the current specification.</p>
-</div>
-<div class="paragraph">
-<p>As the name suggests, the protocol is modeled after a post office. The analogy being:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>The various SMTP servers along the transmission chain are like post offices</p>
-</li>
-<li>
-<p>The user’s mail server is the local post office that will dispatch the mail to the recipient</p>
-</li>
-<li>
-<p>The postman is, ummm, well no analogy is perfect 😬</p>
-</li>
-<li>
-<p>The mail gets dropped into the user’s mailbox (though just to make the analogy even
-muddier there is an option to leave a copy on the server)</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Analogies aside, the protocol worked quite well for most users, and is still widely
-in use today.</p>
-</div>
-<div class="paragraph">
-<p>POP requires essentially two pieces, the POP Client and the POP Server. How the
-message gets initially delivered to the POP Server and how a message is managed
-once delivered to the POP Client is out of scope of the POP protocol.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_specifications"><a class="anchor" href="#_specifications"></a>Specifications</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_pop"><a class="anchor" href="#_pop"></a>POP</h3>
-<div class="paragraph">
-<p>POP has been around since the early days of email. The original specification
-<a href="#_rfc918">RFC918</a> was published in 1984.</p>
-</div>
-<div class="sect3">
-<h4 id="_rfc918"><a class="anchor" href="#_rfc918"></a>RFC918</h4>
-<div class="paragraph">
-<p><a href="https://tools.ietf.org/html/rfc918">RFC918</a> ("Post Office Protocol") was the original
-specification published in 1984. The RFC "suggests a simple method for workstations
-to dynamically access mail from a mailbox server."
-Like <a href="smtp.html" class="xref page">SMTP</a> that came before it, POP is a session-based
-protocol with a handful of defined commands.
-This RFC was obsoleted shortly after its publication by <a href="#_rfc937">RFC937</a>.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_pop2"><a class="anchor" href="#_pop2"></a>POP2</h3>
-<div class="sect3">
-<h4 id="_rfc937"><a class="anchor" href="#_rfc937"></a>RFC937</h4>
-<div class="paragraph">
-<p><a href="https://tools.ietf.org/html/rfc937">RFC937</a> ("Post Office Protocol - Version 2") or more
-commonly "POP2" was a revision of the original <a href="#_rfc918">RFC918</a> specification. POP2 specifies
-connection over port 109, and clarifies that "it is important for the mailbox to be on
-an 'always up' machine and that a workstation may be frequently powered down, or
-otherwise unavailable as an SMTP server." In other words, as the Internet continued to
-evolve, this specification was an attempt to evolve with it.</p>
-</div>
-<div class="paragraph">
-<p>POP2 was replaced by POP3, which was first published as <a href="#_rfc1081">RFC1081</a>.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_pop3"><a class="anchor" href="#_pop3"></a>POP3</h3>
-<div class="sect3">
-<h4 id="_rfc1081"><a class="anchor" href="#_rfc1081"></a>RFC1081</h4>
-<div class="paragraph">
-<p><a href="https://tools.ietf.org/html/rfc1081">RFC1081</a> ("Post Office Protocol - Version 3")
-was the first published version of POP3,
-made available in 1988. It adds additional functionality for managing mail, and
-perhaps most importantly, it adds an authentication mechanism. This version was
-obsoleted by <a href="#_rfc1225">RFC1225</a>.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_rfc1225"><a class="anchor" href="#_rfc1225"></a>RFC1225</h4>
-<div class="paragraph">
-<p><a href="https://tools.ietf.org/html/rfc1225">RFC1225</a> ("Post Office Protocol - Version 3")
-obsoleted <a href="#_rfc1081">RFC1081</a>. It is described as being a "republication" of <a href="#_rfc1081">RFC1081</a>,
-and does not appear to add anything significant. It was obsoleted by
-<a href="#_rfc1460">RFC1460</a>.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_rfc1460"><a class="anchor" href="#_rfc1460"></a>RFC1460</h4>
-<div class="paragraph">
-<p><a href="https://tools.ietf.org/html/rfc1460">RFC1460</a> ("Post Office Protocol - Version 3")
-provided some relatively minor updates to <a href="#_rfc1225">RFC1225</a>, and was itself obsoleted
-about one year later by <a href="#_rfc1725">RFC1725</a>.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_rfc1725"><a class="anchor" href="#_rfc1725"></a>RFC1725</h4>
-<div class="paragraph">
-<p><a href="https://tools.ietf.org/html/rfc1725">RFC1725</a> ("Post Office Protocol - Version 3")
-was again a relatively minor update of <a href="#_rfc1460">RFC1460</a>, and was itself obsoleted
-about two years later by <a href="#_rfc1939">RFC1939</a>.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_rfc1939"><a class="anchor" href="#_rfc1939"></a>RFC1939</h4>
-<div class="paragraph">
-<p><a href="https://tools.ietf.org/html/rfc1939">RFC1939</a> ("Post Office Protocol - Version 3")
-is the most recent specification of POP3, and is the version in use today.</p>
-</div>
-<div class="paragraph">
-<p>This specification seems to imply that POP3 is used for "simple" transactions,
-and for more "advanced" transactions <a href="imap.html" class="xref page">IMAP</a> is available.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_pop4"><a class="anchor" href="#_pop4"></a>POP4</h3>
-<div class="paragraph">
-<p>Although there was development on the <a href="http://www.pop4.org/">POP4</a> specification,
-development appears to have stalled for several years, making POP3 the
-still-current protocol.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_related_concepts"><a class="anchor" href="#_related_concepts"></a>Related Concepts</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>POP relates to…​</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong><a href="imap.html" class="xref page">IMAP</a></strong> as a "competing" protocol</p>
-</li>
-<li>
-<p><strong><a href="../glossary.html#email_client" class="xref page">Email clients</a></strong>, in that the client acts as a POP Client</p>
-</li>
-<li>
-<p><strong><a href="../storage/index.html" class="xref page">Storage</a></strong> in that messages are stored temporarily on
-a ???? while awaiting transfer to the client</p>
-</li>
-<li>
-<p><strong><a href="smtp.html" class="xref page">SMTP</a></strong>, in that messages will normally be
-delivered to the IMAP Server via SMTP.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../_/js/site.js" data-ui-root-path="../../../../_"></script>
-<script async src="../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/concepts/protocols/smtp.html b/james-project/3.6.0/concepts/protocols/smtp.html
deleted file mode 100644
index 81b4b38..0000000
--- a/james-project/3.6.0/concepts/protocols/smtp.html
+++ /dev/null
@@ -1,745 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Simple Mail Transfer Protocol (SMTP) :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../servers/extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../servers/test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../index.html">Apache James Server</a></li>
- <li><a href="../index.html">Concepts</a></li>
- <li><a href="index.html">Protocols</a></li>
- <li><a href="smtp.html">SMTP</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../../3.8.1/concepts/protocols/smtp.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="smtp.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/concepts/pages/protocols/smtp.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Simple Mail Transfer Protocol (SMTP)</h1>
-<div class="sect1">
-<h2 id="_overview"><a class="anchor" href="#_overview"></a>Overview</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>When the original specification for Simple Mail Transfer Protocol, or SMTP,
-was published almost 40 years ago together with
-<a href="../messages/imf.html" class="xref page">IMF</a>, email as we know it today was born.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_specifications"><a class="anchor" href="#_specifications"></a>Specifications</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_rfc821"><a class="anchor" href="#_rfc821"></a>RFC821</h3>
-<div class="paragraph">
-<p><a href="https://tools.ietf.org/html/rfc821">RFC821</a> ("Simple Mail Transfer Protocol")
-was the original SMTP specification published in 1982.
-It was obsoleted by <a href="#_rfc2821">RFC2821</a> in 2001.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_rfc2821"><a class="anchor" href="#_rfc2821"></a>RFC2821</h3>
-<div class="paragraph">
-<p><a href="https://tools.ietf.org/html/rfc2821">RFC2821</a> ("Simple Mail Transfer Protocol") replaced
-<a href="#_rfc821">RFC821</a>. It was itself replaced by <a href="#RFC5321">[RFC5321]</a> in 2008.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_rfc_5321"><a class="anchor" href="#_rfc_5321"></a>RFC 5321</h3>
-<div class="paragraph">
-<p><a href="https://tools.ietf.org/html/rfc5321">RFC5321</a> is the currently used standard for
-"Simple Mail Transfer Protocol", or "SMTP". Published in 2008, it is "a specification of the basic
-protocol for Internet electronic mail transport". If you are interested in all
-the gory details, we recommend that you read this document.</p>
-</div>
-<div class="paragraph">
-<p>This specification has many dependencies with <a href="../messages/imf.html" class="xref page">IMF</a>,
-<a href="../messages/mime.html" class="xref page">MIME</a>, and other technical concepts, which can quickly
-become utterly confusing.
-Here, we provide a very short and simplified description of those portions of the
-specification that we felt were interesting enough to repeat here.</p>
-</div>
-<div class="paragraph">
-<p>As the spec mentions, "SMTP transports a mail object", a mail object being described
-as an object that contains both an envelope and content. An SMTP client connects
-to a server and communicates via a session. Both client and server provide a
-mail transport service, and are therefore act as "Mail Transfer Agents", or
-"MTAs". A mail originates and terminates with a "Mail User Agent" ("MUA").
-On the originating side, a MUA may, for instance, collect mail to be transmitted
-by a user and hand it off to an MTA. On the terminating side, an MTA would
-hand a mail off to an MUA.</p>
-</div>
-<div class="paragraph">
-<p>"SMTP sessions are stateful, with both parties carefully maintaining a
-common view of the current state." The session is initiated by the client,
-which establishes a two-way channel to an SMTP server. The session must either
-close successful (or with a failure message), else delivery is considered to
-have failed.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_related_concepts"><a class="anchor" href="#_related_concepts"></a>Related Concepts</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>SMTP relates to:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong><a href="../messages/index.html" class="xref page">Email messages</a></strong>, in that the SMTP protocol exists to transfer
-messages from one host to another</p>
-</li>
-<li>
-<p><strong><a href="../glossary.html#mta" class="xref page">MTA</a></strong>, in that the very nature of SMTP is about specifying how a message
-gets transferred from one MTA to another</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_try_it"><a class="anchor" href="#_try_it"></a>Try It!</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>You can try speaking SMTP with your demo server by connecting to it using telnet. It would not work on a real world server as it would requires encrypted traffic. See "using openssl to talk to your server"</p>
-</div>
-<div class="paragraph">
-<p>Requirements:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Run the long demo (without stopping)</p>
-</li>
-<li>
-<p>Telnet</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Approximate duration: 5 minutes</p>
-</div>
-<div class="exampleblock">
-<div class="content">
-<div class="paragraph">
-<p>Note: extra lines are inserted below to help show you what you need to type.</p>
-</div>
-</div>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-telnet hljs" data-lang="telnet">$ telnet 127.0.0.1 25 <i class="conum" data-value="1"></i><b>(1)</b>
-
-Trying 127.0.0.1...
-Connected to localhost.
-Escape character is '^]'.
-220 JAMES Linagora's SMTP awesome Server
-
-ehlo test <i class="conum" data-value="2"></i><b>(2)</b>
-
-250-9a2fe463e592 Hello test [172.17.0.1])
-250-PIPELINING
-250-ENHANCEDSTATUSCODES
-250 8BITMIME
-
-mail from: <user02@james.local> <i class="conum" data-value="3"></i><b>(3)</b>
-
-250 2.1.0 Sender <user02@james.local> OK
-
-rcpt to: <user01@james.local> <i class="conum" data-value="4"></i><b>(4)</b>
-
-250 2.1.5 Recipient <user01@james.local> OK
-
-data <i class="conum" data-value="5"></i><b>(5)</b>
-
-354 Ok Send data ending with <CRLF>.<CRLF>
-
-Subject: Test Message <i class="conum" data-value="5"></i><b>(5)</b>
-<i class="conum" data-value="6"></i><b>(6)</b>
-This is just a test. <i class="conum" data-value="7"></i><b>(7)</b>
-. <i class="conum" data-value="8"></i><b>(8)</b>
-
-250 2.6.0 Message received
-
-quit <i class="conum" data-value="9"></i><b>(9)</b></code></pre>
-</div>
-</div>
-<div class="colist arabic">
-<table>
-<tr>
-<td><i class="conum" data-value="1"></i><b>1</b></td>
-<td>Connect to the James server using the SMTP protocol via telnet.</td>
-</tr>
-<tr>
-<td><i class="conum" data-value="2"></i><b>2</b></td>
-<td>Initiate the SMTP session.</td>
-</tr>
-<tr>
-<td><i class="conum" data-value="3"></i><b>3</b></td>
-<td>Indicate that you want to send a mail from <a href="mailto:user02@james.local">user02@james.local</a>.</td>
-</tr>
-<tr>
-<td><i class="conum" data-value="4"></i><b>4</b></td>
-<td>Indicate that the mail should be sent to <a href="mailto:user01@james.local">user01@james.local</a>.</td>
-</tr>
-<tr>
-<td><i class="conum" data-value="5"></i><b>5</b></td>
-<td>Enter the subject.</td>
-</tr>
-<tr>
-<td><i class="conum" data-value="6"></i><b>6</b></td>
-<td>Enter a blank line.</td>
-</tr>
-<tr>
-<td><i class="conum" data-value="7"></i><b>7</b></td>
-<td>Enter some text. You can enter multiples lines if you like.</td>
-</tr>
-<tr>
-<td><i class="conum" data-value="8"></i><b>8</b></td>
-<td>When you have completed the message, enter a line with only a "." and no other text.</td>
-</tr>
-<tr>
-<td><i class="conum" data-value="9"></i><b>9</b></td>
-<td>End the session.</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>If you set up Thunderbird to connect to the server, you can confirm that the mail
-has indeed arrived in the mailbox of <a href="mailto:user01@james.local">user01@james.local</a>.</p>
-</div>
-<div class="paragraph">
-<p>Pretty cool! Good thing we have James so we don’t have to always send emails manually.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../_/js/site.js" data-ui-root-path="../../../../_"></script>
-<script async src="../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/concepts/storage/index.html b/james-project/3.6.0/concepts/storage/index.html
deleted file mode 100644
index e080e5a..0000000
--- a/james-project/3.6.0/concepts/storage/index.html
+++ /dev/null
@@ -1,597 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Storage :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item is-current-page" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../servers/extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../servers/test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../index.html">Apache James Server</a></li>
- <li><a href="../index.html">Concepts</a></li>
- <li><a href="index.html">Storage</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../../3.8.1/concepts/storage/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="index.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/concepts/pages/storage/index.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Storage</h1>
-<div class="sect1">
-<h2 id="_overview"><a class="anchor" href="#_overview"></a>Overview</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Email is useful because any one person can send a message to any other person,
-anywhere in the world. The heart of email is the ability to transfer some message
-based on a commonly-understood message format between two different systems that
-may have been developed entirely independently of each other. The concept is relatively
-simple, but the fact that email is so ubiquitious is simply a miracle.</p>
-</div>
-<div class="paragraph">
-<p>However, there is more to email than just the transfer of messages.</p>
-</div>
-<div class="paragraph">
-<p>For starters, I want people I know to be able to send me a mail even when
-I happen to be out mountain climbing. I want to be able to receive the message
-when I’m not available, then review it afterward when I am back at my desk.
-For this reason, email is by design asynchromous. Time can pass between the moment
-a mail is sent and the moment it is read.
-In the meantime, it needs to be stored somewhere.</p>
-</div>
-<div class="paragraph">
-<p>Additionally, although it is possible to read a message, then discard it, never to be seen again,
-it is more common for people to archive a message. Some people even get creative and
-use their email for various other purposes, such as a kind of poor man’s information archive.
-Many corporations use email for business purposes, which requires administration of
-users within the organization.
-Even individuals with a self-hosted email server want to ensure that their system does
-not get abused as an <a href="../glossary.html#open_relay" class="xref page">open relay</a>.</p>
-</div>
-<div class="paragraph">
-<p>All of these types of concerns requires that the system maintain some kind of state,
-whether that be the messages themselves, information about the system’s users,
-and even in some cases user credentials. Keeping state requires a storage system.
-The system of storage must work intimately with the various
-<a href="../protocols/index.html" class="xref page">protocols</a>.</p>
-</div>
-<div class="paragraph">
-<p>In this section, we describe the two principle types of storage that James manages:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="mailbox.html" class="xref page">Mailboxes</a> for email storage, and</p>
-</li>
-<li>
-<p><a href="users.html" class="xref page">User Repository</a> for data about Mailbox users.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../_/js/site.js" data-ui-root-path="../../../../_"></script>
-<script async src="../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/concepts/storage/mailbox.html b/james-project/3.6.0/concepts/storage/mailbox.html
deleted file mode 100644
index e4b9a22..0000000
--- a/james-project/3.6.0/concepts/storage/mailbox.html
+++ /dev/null
@@ -1,754 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Mailboxes :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../servers/extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../servers/test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../index.html">Apache James Server</a></li>
- <li><a href="../index.html">Concepts</a></li>
- <li><a href="index.html">Storage</a></li>
- <li><a href="mailbox.html">Mailboxes</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../../3.8.1/concepts/storage/mailbox.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="mailbox.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/concepts/pages/storage/mailbox.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Mailboxes</h1>
-<div class="sect1">
-<h2 id="_overview"><a class="anchor" href="#_overview"></a>Overview</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>To (over)use the analogy once again of a postal system, we think of a mailbox
-as a place where a letter is placed to await pickup by its recipient. Although
-current methods have evolved considerably, the original idea used for the development
-of email was exactly that. The concept <a href="#_rfc196">has been around officially</a> since
-at least 1971. The image of a mailbox is so prevalent that, although current
-systems have evolved to do so much more than just hold messages for processing,
-the industry continues to apply the concept.</p>
-</div>
-<div class="paragraph">
-<p>The more general term is "Email Storage". It is necessary to store email for
-many reasons:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>As a mailbox system — part of a queue to await processing</p>
-</li>
-<li>
-<p>As a persistance mechanism — a place where you can go back and predictably
-locate a message that you may want to refer to again in the future</p>
-</li>
-<li>
-<p>As an archive — a place where you may want to store "deleted" emails so that
-you can potentially retrieve them if you wish to change your mind later</p>
-</li>
-<li>
-<p>As a temporary step in a process — perhaps you have a "todo" folder where
-you temporarily store an email that you intend to process soon</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>There are numerous ways to store emails, just as there are numerous reasons for
-storing them:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>A <a href="#_specifications">standardized</a> "mailbox" format</p>
-</li>
-<li>
-<p>A relational database</p>
-</li>
-<li>
-<p>A custom file-based mechanism</p>
-</li>
-<li>
-<p>Etc.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This section briefly describes how email storage is a core concept in an
-email system.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_specifications"><a class="anchor" href="#_specifications"></a>Specifications</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_electronic_mail_box"><a class="anchor" href="#_electronic_mail_box"></a>Electronic Mail Box</h3>
-<div class="sect3">
-<h4 id="_rfc196"><a class="anchor" href="#_rfc196"></a>RFC196</h4>
-<div class="paragraph">
-<p>The concept of an "electronic mail box" was
-<a href="https://tools.ietf.org/html/rfc196">initially specified</a> way back in 1971.
-It is amusing to read the retro concepts in the initial description of this
-document:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>The purpose of this protocol is to provide at each site a
-standard mechanism to receive sequential files for immediate or
-deferred printing or other uses. The files for deferred printing
-would probably be stored on intermediate disk files [...].
-It is also assumed that there would be a program at the sending
-site [...]. This program could probably be accessed as a subcommand
-of the Telnet program.</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>This specification was obsoleted by <a href="#_rfc221">RFC221</a>.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_rfc221"><a class="anchor" href="#_rfc221"></a>RFC221</h4>
-<div class="paragraph">
-<p><a href="https://tools.ietf.org/html/rfc221">RFC221</a> ("A Mail Box Protocol, Version-2") was
-published in 1971. It added the possibility of using FTP in addition to the
-"Data Transfer Protocol" used in <a href="#_rfc196">RFC196</a>. This version was obsoleted by
-<a href="#_rfc278">RFC278</a>.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_rfc278"><a class="anchor" href="#_rfc278"></a>RFC278</h4>
-<div class="paragraph">
-<p><a href="https://tools.ietf.org/html/rfc278">RFC278</a> ("Revision of the Mail Box Protocol")
-was published in 1971. It provided a number of updates to <a href="#_rfc221">RFC221</a>.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_maildir"><a class="anchor" href="#_maildir"></a>Maildir</h3>
-<div class="paragraph">
-<p><a href="https://en.wikipedia.org/wiki/Maildir">Maildir</a> is a file-based storage format invented
-by <a href="https://en.wikipedia.org/wiki/Daniel_J._Bernstein">Dan Bernstein</a>.
-A major design objective was apparently to delegate file locking to the operating system.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_mbox"><a class="anchor" href="#_mbox"></a>Mbox</h3>
-<div class="paragraph">
-<p>The <a href="https://en.wikipedia.org/wiki/Mbox">mbox</a> email storage format was formally defined
-by <a href="https://tools.ietf.org/html/rfc4155">RFC4155</a>. It is a formalization of a <em>de facto</em>
-format used by UNIX-like operating systems.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_mix"><a class="anchor" href="#_mix"></a>MIX</h3>
-<div class="paragraph">
-<p>The <a href="https://en.wikipedia.org/wiki/MIX_(email)">MIX</a> email storage format was developed by
-<a href="https://en.wikipedia.org/wiki/Mark_Crispin">Mark Crispin</a>, the original author of the
-<a href="../protocols/imap.html" class="xref page">IMAP specification</a>. Its
-<a href="https://www.mail-archive.com/imap-uw@u.washington.edu/msg00540.html">design goals</a> were:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>greater robustness against corruption caused by hardware or
-software failures. Many failures are "self-healing".</p>
-</li>
-<li>
-<p>far fewer risky random-access I/O operations; a single false
-pointer calculation in other formats will corrupt the mailbox.</p>
-</li>
-<li>
-<p>greater ease to repair damaged mailboxes.</p>
-</li>
-<li>
-<p>(much) greater performance.</p>
-</li>
-<li>
-<p>extensibility for new IMAP capabilities such as annotations,
-conditional store, or more aggressing caching.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_rfc5322"><a class="anchor" href="#_rfc5322"></a>RFC5322</h3>
-<div class="paragraph">
-<p><a href="https://tools.ietf.org/html/rfc5322">RFC5322</a> weighs in on how to describe a "mailbox":</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>A mailbox receives mail. It is a 'conceptual entity' that does not necessarily
-pertain to file storage. It further exemplifies that some sites may choose to
-print mail on a printer and deliver the output to the addressee's desk, much
-like a traditional fax transmission.</pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_indexing"><a class="anchor" href="#_indexing"></a>Indexing</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Once a system grows over time it will likely contain many messages
-stored in its <a href="#">Mailboxes</a>.
-Searching for the right email becomes increasingly difficult. At some point
-it becomes useful to use an <a href="https://en.wikipedia.org/wiki/Search_engine_indexing">indexing</a></p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_related_concepts"><a class="anchor" href="#_related_concepts"></a>Related Concepts</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Email Storage is related to…​</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong><a href="../protocols/pop.html" class="xref page">POP</a></strong>, as the POP protocol mandates interaction
-with a user’s "mailbox"</p>
-</li>
-<li>
-<p><strong><a href="../protocols/imap.html" class="xref page">IMAP</a></strong>, as the IMAP protocol is all about storing
-messages on an IMAP Server</p>
-</li>
-<li>
-<p><strong><a href="../glossary.html#email_client" class="xref page">Email clients</a></strong>, as the client will store mail locally, usually in the form
-of a "mailbox"</p>
-</li>
-<li>
-<p><strong><a href="../protocols/smtp.html" class="xref page">SMTP</a></strong> as the protocol is related to transmitting
-messages from one mailbox to another</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../_/js/site.js" data-ui-root-path="../../../../_"></script>
-<script async src="../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/concepts/storage/users.html b/james-project/3.6.0/concepts/storage/users.html
deleted file mode 100644
index b535f9c..0000000
--- a/james-project/3.6.0/concepts/storage/users.html
+++ /dev/null
@@ -1,654 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>User Repository :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../servers/extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../servers/test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../index.html">Apache James Server</a></li>
- <li><a href="../index.html">Concepts</a></li>
- <li><a href="index.html">Storage</a></li>
- <li><a href="users.html">Users</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../../3.8.1/concepts/storage/users.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="users.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/concepts/pages/storage/users.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">User Repository</h1>
-<div class="sect1">
-<h2 id="_overview"><a class="anchor" href="#_overview"></a>Overview</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Whereas <a href="mailbox.html" class="xref page">mailboxes</a> are clearly a core component of
-any email system, user management is a lighter shade of gray.</p>
-</div>
-<div class="paragraph">
-<p>On the one hand, mailboxes ought to match up with actual
-<a href="../user/index.html#_user" class="xref page">Users</a>, so there is
-a clear relationship between mailbox management and user management.
-Because of this relationship, it is not at all strange to include a user respository
-within an email system.</p>
-</div>
-<div class="paragraph">
-<p>However, on the other hand email is only one of many applications that require
-user management. It is therefore also completely reasonable to use some kind of
-centralized user directory, and ensure that mailboxes somehow synchronize with
-this external system.</p>
-</div>
-<div class="paragraph">
-<p>The former case is much simpler to manage, but requires duplicate and therefore
-unproductive work. The latter case can become quite complex from a technological
-perspective (and all the risks that are associated with it), but reduces the
-amount of unproductive work.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_common_operations"><a class="anchor" href="#_common_operations"></a>Common Operations</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Because the user repository is used in the context of managing mailboxes, there
-are some operations that are relatively common to any email system.</p>
-</div>
-<div class="sect2">
-<h3 id="_domain_management"><a class="anchor" href="#_domain_management"></a>Domain Management</h3>
-<div class="paragraph">
-<p>A mailbox belongs to a <a href="https://en.wikipedia.org/wiki/Domain_name">domain</a>. For a mail
-system that can process multiple domains, the system will usually have operations to:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>List available domains</p>
-</li>
-<li>
-<p>Add a domain</p>
-</li>
-<li>
-<p>Remove a domain</p>
-</li>
-<li>
-<p>Update a user’s password</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_user_management"><a class="anchor" href="#_user_management"></a>User Management</h3>
-<div class="paragraph">
-<p>A User has at least one mail box, and will usually have a canonical mailbox
-that matches the user’s identity in the system.
-For each domain that is managed by the system, it is common to be able to:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>List all users for the domain</p>
-</li>
-<li>
-<p>Add a user</p>
-</li>
-<li>
-<p>Remove user</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_other_common_operations"><a class="anchor" href="#_other_common_operations"></a>Other Common Operations</h3>
-<div class="ulist">
-<ul>
-<li>
-<p>Add or remove email <a href="https://en.wikipedia.org/wiki/Email_alias">aliases</a>
-for a given user</p>
-</li>
-<li>
-<p>Add or remove email <a href="https://en.wikipedia.org/wiki/Email_forwarding">forwards</a>
-for a given user</p>
-</li>
-<li>
-<p>Add or remove a user to a "group" mail address</p>
-</li>
-<li>
-<p>Filter messages using <a href="https://james.apache.org/jsieve/">Sieve</a></p>
-</li>
-<li>
-<p>Rewrite mail addresses</p>
-</li>
-<li>
-<p>Configure an <a href="https://en.wikipedia.org/wiki/Autoresponder">autoresponder</a></p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../_/js/site.js" data-ui-root-path="../../../../_"></script>
-<script async src="../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/concepts/user/index.html b/james-project/3.6.0/concepts/user/index.html
deleted file mode 100644
index 38680f1..0000000
--- a/james-project/3.6.0/concepts/user/index.html
+++ /dev/null
@@ -1,712 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>James User Model :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="2">
- <a class="nav-link" href="index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../servers/extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../servers/distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../servers/distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../servers/distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../servers/distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../servers/test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../index.html">Apache James Server</a></li>
- <li><a href="../index.html">Concepts</a></li>
- <li><a href="index.html">User Model</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../../3.8.1/concepts/user/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="index.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/concepts/pages/user/index.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">James User Model</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>For clarity, we have defined various roles for actors who interact
-with <a href="#servers/index.adoc" class="xref unresolved">James servers</a> in one way or another.
-The deliverables we make available are produced with these roles in mind.
-Note that any given person may play more than one role, even at the same
-time.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="#_user">User</a></p>
-</li>
-<li>
-<p><a href="#_operator">Operator</a></p>
-</li>
-<li>
-<p><a href="#_integrator">Integrator</a></p>
-</li>
-<li>
-<p><a href="#_developer">Developer</a></p>
-</li>
-<li>
-<p><a href="#_contributor">Contributor</a></p>
-</li>
-<li>
-<p><a href="#_committer">Committer</a></p>
-</li>
-<li>
-<p><a href="#_pmc_member">PMC Member</a></p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_user"><a class="anchor" href="#_user"></a>User</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>A <strong>User</strong> simply uses email without any notion of what server is providing the service.</p>
-</div>
-<div class="paragraph">
-<p>More precisely, in typical cases a User will have an email client for reading and writing email. The
-<a href="../glossary.html" class="xref page">email client</a> will connect to the James server via
-<a href="#mail/protocols/smtp.adoc" class="xref unresolved">SMTP</a>,
-<a href="#mail/protocols/pop.adoc" class="xref unresolved">POP</a>, or
-<a href="#mail/protocols/imap.adoc" class="xref unresolved">IMAP</a>.
-The User will have no indication anywhere that the server is a James server.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_operator"><a class="anchor" href="#_operator"></a>Operator</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>An <strong>Operator</strong> installs and runs James for the benefit of Users.</p>
-</div>
-<div class="paragraph">
-<p>The Operator does not compile any Java code, and does not require any software
-development environment.</p>
-</div>
-<div class="paragraph">
-<p>Apache James offers Operators a range of servers for various use cases, including:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>A <a href="#server/basic/index.adoc" class="xref unresolved">Basic Server</a> ideal for busy Operators who
-are interested in an easy-to-use self-hosting solution, but who may not have the
-time to gain deep expertise</p>
-</li>
-<li>
-<p>An <a href="#server/advanced/index.adoc" class="xref unresolved">Advanced Server</a> well-suited for Operators with
-advanced skills and resources who are not daunted by getting their hands dirty
-with configurations or using built-in extensions</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_integrator"><a class="anchor" href="#_integrator"></a>Integrator</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>An <strong>Integrator</strong> has some expertise with Java or a JVM-based language. Based
-on this expertise the Integrator can perform more advanced server configurations and may
-develop <a href="#xxx.adoc" class="xref unresolved">Extensions</a> to customize the behavior of a James server.</p>
-</div>
-<div class="paragraph">
-<p>An Integrator does <strong>not</strong> need to download the source code or compile James.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_developer"><a class="anchor" href="#_developer"></a>Developer</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>A <strong>Developer</strong> uses the James codebase, executes a build using the provided
-build system (Maven), may edit the source code and deploy the built artifacts.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_contributor"><a class="anchor" href="#_contributor"></a>Contributor</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>A <strong>Contributor</strong> refers to anyone involved with the Apache James community by:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Filing an issue on the <a href="https://issues.apache.org/jira/secure/Dashboard.jspa">issue tracking system</a></p>
-</li>
-<li>
-<p>Posting a question on the <a href="https://james.apache.org/mail.html">mailing list</a>
-or on the <a href="https://gitter.im/apache/james-project">gitter channel</a></p>
-</li>
-<li>
-<p>Submitting a <a href="https://github.com/apache/james-project/pulls">pull request</a> (PR)</p>
-</li>
-<li>
-<p>Fixes, refines and writes documentation</p>
-</li>
-<li>
-<p>Writes a tutorial or article about James</p>
-</li>
-<li>
-<p>Otherwise generally helps the James Community in any other way not listed here</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_committer"><a class="anchor" href="#_committer"></a>Committer</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>A <strong>Committer</strong> is granted special rights (according to
-<a href="https://www.apache.org/dev/committers.html">Apache practices</a>)
-to participate in the development of James by:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Accepting (being assigned) issues in the <a href="https://issues.apache.org/jira/secure/Dashboard.jspa">issue tracking system</a></p>
-</li>
-<li>
-<p>Merging code into the <a href="https://github.com/apache/james-project">git repository</a></p>
-</li>
-<li>
-<p>Being granted a voice when voting matters arise</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_pmc_member"><a class="anchor" href="#_pmc_member"></a>PMC Member</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>A <strong>PMC</strong> (Project Management Committee) Member
-is a Committer who is also a member of the PMC, as stipulated by
-<a href="https://www.apache.org/dev/pmc.html">Apache rules</a>.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../_/js/site.js" data-ui-root-path="../../../../_"></script>
-<script async src="../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/customization/index.html b/james-project/3.6.0/customization/index.html
deleted file mode 100644
index a79e72d..0000000
--- a/james-project/3.6.0/customization/index.html
+++ /dev/null
@@ -1,545 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Apache James Customization :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../servers/extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../servers/test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="1">
- <a class="nav-link" href="index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Server</a></li>
- <li><a href="index.html">Customization</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../3.8.1/customization/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="index.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/customization/pages/index.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Apache James Customization</h1>
-
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/development/index.html b/james-project/3.6.0/development/index.html
deleted file mode 100644
index 5e87e38..0000000
--- a/james-project/3.6.0/development/index.html
+++ /dev/null
@@ -1,547 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Apache James Developer Guide :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../servers/extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../servers/test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="1">
- <a class="nav-link" href="index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Server</a></li>
- <li><a href="index.html">Developer Guide</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../3.8.1/development/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="index.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/development/pages/index.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Apache James Developer Guide</h1>
-<div class="paragraph">
-<p>(TODO)</p>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/development/logging.html b/james-project/3.6.0/development/logging.html
deleted file mode 100644
index e217018..0000000
--- a/james-project/3.6.0/development/logging.html
+++ /dev/null
@@ -1,626 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Logging in Apache James :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../servers/extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../servers/distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../servers/distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../servers/distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../servers/distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../servers/test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Server</a></li>
- <li><a href="logging.html">Logging in Apache James</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../3.8.1/development/logging.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="logging.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/development/pages/logging.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Logging in Apache James</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-note" title="Note"></i>
-</td>
-<td class="content">
-This information targets developers.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>Logging is very important when running a software.
-Most of the time people use logs for debugging and troubleshooting issues in production.
-In Apache James we leverage a logging facade for logging <a href="http://www.slf4j.org/">Slf4j</a> .
-Please see the documentation for exact details.</p>
-</div>
-<div class="paragraph">
-<p>In a typical application logs are stored for a specific period.
-This can be 1 day, 1 week, etc.</p>
-</div>
-<div class="paragraph">
-<p>Some other typical scenarios include:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Rotating logs periodically.</p>
-</li>
-<li>
-<p>Shipping logs centrally.</p>
-</li>
-<li>
-<p>Saving some logging messages to other files / end devices</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>By leveraging a logging facade like Slf4j, the end user has the ability to use different logging back ends and achieve the above requirements.</p>
-</div>
-<div class="paragraph">
-<p>Logging is something we do to help the people running our code.
-We also help ourselves when they encounter bugs, and they need to share information with us for a fix.
-As developers, we should be mindful of the logging statements.
-We should also be mindful about the performance implications of logging and not abuse it.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_loggers_used_in_code"><a class="anchor" href="#_loggers_used_in_code"></a>Loggers used in code</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>You can define a logger using a string or a class.
-For common loggers it’s ok to use a string name.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java"> private static final Logger LOGGER = LoggerFactory.getLogger("org.apache.james.CONFIGURATION");
- private static final Logger LOGGER = LoggerFactory.getLogger(JamesServerMain.class);</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Loggers can be hierarchical.
-This helps when we build a logger from a class name, and we use package structure to drive the logger hierarchy.</p>
-</div>
-<div class="paragraph">
-<p>The most useful loggers should to be documented below.
-Please maintain this list of loggers.</p>
-</div>
-<div class="dlist">
-<dl>
-<dt class="hdlist1">org.apache.james.CONFIGURATION</dt>
-<dd>
-<p>It is used to log events related to configuration loading and updating.</p>
-</dd>
-</dl>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/index.html b/james-project/3.6.0/index.html
deleted file mode 100644
index d226efb..0000000
--- a/james-project/3.6.0/index.html
+++ /dev/null
@@ -1,621 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Welcome :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="servers/index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="servers/demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="servers/5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="servers/15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="servers/basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="servers/basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="servers/basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="servers/basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="servers/basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="servers/basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="servers/basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="servers/extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="servers/distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="servers/distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="servers/distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="servers/distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="servers/distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="servers/distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="servers/distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="servers/distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="servers/distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="servers/distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="servers/distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="servers/distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="servers/distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="servers/distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="servers/distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="servers/distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="servers/distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="servers/distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="servers/distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="servers/distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="servers/distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="servers/distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="servers/distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="servers/distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="servers/distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="servers/distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="servers/distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="servers/distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="servers/distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="servers/distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="servers/distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="servers/distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="servers/distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="servers/distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="servers/distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="servers/distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="servers/distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="servers/distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="servers/distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="servers/distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="servers/distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="servers/distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="servers/distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="servers/distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="servers/distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="servers/distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="servers/distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="servers/distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="servers/distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="servers/distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="servers/distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="servers/distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="servers/test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="index.html">Apache James Server</a></li>
- <li><a href="index.html">Welcome</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="index.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/ROOT/pages/index.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Welcome</h1>
-<div class="paragraph">
-<p>Welcome to the Apache James Reference Documentation! These documents are for version 3.6.0 of James.</p>
-</div>
-<div class="paragraph">
-<p>Apache James is a flexible email platform that provides out-of-the-box mail servers that you can start
-using in production immediately.
-James runs on the JVM and is highly customizable.</p>
-</div>
-<div class="paragraph">
-<p>This Reference Book is divided into the following Parts:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="../3.8.1/concepts/index.html" class="xref page">James Core Concepts</a></p>
-<div class="ulist">
-<ul>
-<li>
-<p>These are the core concepts that describe what James is all about.
-Start here if you want to learn more about what James can do
-and how it is designed.</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p><a href="../3.8.1/servers/index.html" class="xref page">James Servers</a></p>
-<div class="ulist">
-<ul>
-<li>
-<p>We provide a few out-of-the-box servers that you can
-choose from depending on your needs. Start here if you just
-want to get up and running quickly with a working production-grade mail server.</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p><a href="../3.8.1/customization/index.html" class="xref page">Customization</a></p>
-<div class="ulist">
-<ul>
-<li>
-<p>Shows how you can customize any James server with the
-functionalities that you need.
-Check out this section if you have special business or technical
-needs and are interested in a custom solution.</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p><a href="../3.8.1/development/index.html" class="xref page">James Developer Guide</a></p>
-<div class="ulist">
-<ul>
-<li>
-<p>A guide aimed at experienced developers, describing
-how you can assemble your own specialized server.</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p><a href="../3.8.1/community/index.html" class="xref page">James Community</a></p>
-<div class="ulist">
-<ul>
-<li>
-<p>All about the Apache James community, and how you can be
-part of this active and dynamic group, too!</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Please note that this Reference Documentation is a <strong>living document</strong>. It is subject to change. You are currently reading version 3.6.0. If you find anything that is unclear, unfinished, or confusing, please do not hestiate to <a href="../3.8.1/community/index.html" class="xref page">lend us a hand</a>.</p>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../_/js/site.js" data-ui-root-path="../../_"></script>
-<script async src="../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/15-minute-demo.html b/james-project/3.6.0/servers/15-minute-demo.html
deleted file mode 100644
index 34eb232..0000000
--- a/james-project/3.6.0/servers/15-minute-demo.html
+++ /dev/null
@@ -1,937 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Long Demo :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Server</a></li>
- <li><a href="index.html">Servers</a></li>
- <li><a href="demo.html">Demo</a></li>
- <li><a href="15-minute-demo.html">Long Demo</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../3.8.1/servers/15-minute-demo.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="15-minute-demo.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/15-minute-demo.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Long Demo</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>In this demo (~15 minutes), we will set up a runing James demo using a prepared Docker image.
-We will then test the server by connecting with an email client. Finally, we
-will connect to the server via the REST-based Admin API.</p>
-</div>
-<div class="paragraph">
-<p>Requirements:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Docker</p>
-</li>
-<li>
-<p>curl</p>
-</li>
-<li>
-<p>Thunderbird client (optional)</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_set_up_the_demo_server"><a class="anchor" href="#_set_up_the_demo_server"></a>Set up the demo server</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Before starting the server, because we will be connecting to the Admin API we need to set some configuration parameters.
-We will create a <code>webadmin.properties</code> file that James will use in order to allow us to connect to the API.</p>
-</div>
-<div class="paragraph">
-<p>Run this command to create the <code>webadmin.properties</code> file:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">printf 'enabled=true\nport=8000\nhost=localhost' >> webadmin.properties</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Explanation:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>enabled=true</code> instructs James to run the Admin API service</p>
-</li>
-<li>
-<p><code>port=8000</code> configures the Admin API to be made available via port 8000</p>
-</li>
-<li>
-<p><code>host=localhost</code> configures the Admin API to respond on localhost</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Now run the James demo server using this command:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">docker run -d -p "25:25" -p "143:143" -p "127.0.0.1:8000:8000" -v $(pwd)/webadmin.properties:/root/conf/webadmin.properties --name james linagora/james-jpa-sample:3.4.0</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Explanation:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>docker run</code> runs the provided image with the given parameters</p>
-</li>
-<li>
-<p>The <code>-d</code> parameter runs the container in "detached" mode</p>
-</li>
-<li>
-<p><code>-p "25:25" -p "143:143"</code> attaches the image ports to the ports 25 (SMTP) and 143 (IMAP) on the host machine</p>
-</li>
-<li>
-<p>`-p "127.0.0.1:8000:8000" attaches the port 8000 to localhost on the host machine to allow us to connect to the Admin API</p>
-</li>
-<li>
-<p><code>-v $(pwd)/webadmin.properties:/root/conf/webadmin.properties</code> mounts the webadmin.properties file to configure the Admin API</p>
-</li>
-<li>
-<p>The <code>--name james</code> parameter gives the running container a name to make it easier to manipulate</p>
-</li>
-<li>
-<p><code>linagora/james-jpa-sample:3.4.0</code> is the image that is used for this demo</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Docker will pull the image and start the container.</p>
-</div>
-<div class="sidebarblock">
-<div class="content">
-<div class="paragraph">
-<p>To run commands using the James CLI, you can use the running container via Docker:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>docker exec james java -jar /root/james-cli.jar \
- -h \<<HOST>> -p \<<PORT>> \<<COMMAND>></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>In this demo, we are using host 127.0.0.1 and port 9999, so every command looks like:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>docker exec james java -jar /root/james-cli.jar \
- -h 127.0.0.1 -p 9999 \<<COMMAND>></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Host 127.0.0.1 is of course localhost, and the use of port 9999 is completely arbitrary.</p>
-</div>
-<div class="paragraph">
-<p>To make this demo a little easier to use, set this up as a bash script by copying and pasting this script:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">printf '#!/bin/bash\n\ndocker exec james java -jar /root/james-cli.jar -h 127.0.0.1 -p 9999 $@' >> james ; chmod +x james</code></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="paragraph">
-<p>As an example, list all the domains currently in use by James:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./james listDomains</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You should notice that a default domain, james.local, has been created</p>
-</div>
-<div class="paragraph">
-<p>List all the current users:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./james listUsers</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You should see users <code>user01@james.local</code>, <code>user02@james.local</code>, and <code>user03@james.local</code>.</p>
-</div>
-<div class="paragraph">
-<p>Create a new "test.local" domain:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./james addDomain test.local</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>List the domains again to ensure that "test.local" has successfully been added:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./james listDomains</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Add the user "testuser" to the "test.local" domain with password "password":</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./james addUser testuser@test.local password</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You should now see your newly created user:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./james listUsers</code></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_connect_to_the_server_with_an_email_client"><a class="anchor" href="#_connect_to_the_server_with_an_email_client"></a>Connect to the server with an email client</h2>
-<div class="sectionbody">
-<div class="sidebarblock">
-<div class="content">
-<div class="paragraph">
-<p>For this demo, we will use Thunderbird, as it is available in multiple languages
-on Windows, Mac, and Linux.</p>
-</div>
-<div class="paragraph">
-<p>Go to <a href="https://www.thunderbird.net" class="bare">https://www.thunderbird.net</a> to download Thunderbird.</p>
-</div>
-</div>
-</div>
-<div class="paragraph">
-<p>After you have installed Thunderbird,
-<a href="https://support.mozilla.org/en-US/kb/manual-account-configuration">manually set up an account</a>
-for <a href="mailto:user01@james.local">user01@james.local</a> using the following parameters:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Account name: user01</p>
-</li>
-<li>
-<p>Your name: User 01</p>
-</li>
-<li>
-<p>Email address: <a href="mailto:user01@james.local">user01@james.local</a></p>
-</li>
-<li>
-<p>SMTP server name: localhost</p>
-</li>
-<li>
-<p>SMTP port: 25</p>
-</li>
-<li>
-<p>SMTP connection security: none</p>
-</li>
-<li>
-<p>SMTP authentication: password</p>
-</li>
-<li>
-<p>IMAP server name: localhost</p>
-</li>
-<li>
-<p>IMAP user name: <a href="mailto:user01@james.local">user01@james.local</a></p>
-</li>
-<li>
-<p>IMAP port: 143</p>
-</li>
-<li>
-<p>IMAP connection security: none</p>
-</li>
-<li>
-<p>IMAP authentication: none</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Repeat the above for <a href="mailto:testuser@test.local">testuser@test.local</a>:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Account name: testuser</p>
-</li>
-<li>
-<p>Your name: Test User</p>
-</li>
-<li>
-<p>Email address: <a href="mailto:testuser@test.local">testuser@test.local</a></p>
-</li>
-<li>
-<p>SMTP server name: localhost</p>
-</li>
-<li>
-<p>SMTP port: 25</p>
-</li>
-<li>
-<p>SMTP connection security: none</p>
-</li>
-<li>
-<p>SMTP authentication: password</p>
-</li>
-<li>
-<p>IMAP server name: localhost</p>
-</li>
-<li>
-<p>IMAP user name: <a href="mailto:testuser@test.local">testuser@test.local</a></p>
-</li>
-<li>
-<p>IMAP port: 143</p>
-</li>
-<li>
-<p>IMAP connection security: none</p>
-</li>
-<li>
-<p>IMAP authentication: none</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Now have fun sending emails back and forth to yourself. :-)
-But don’t spend all day doing this. You have too much work to do.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_connect_to_the_server_via_the_admin_api"><a class="anchor" href="#_connect_to_the_server_via_the_admin_api"></a>Connect to the server via the Admin API</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>We will use curl to connect to localhost on port 8000, as the Admin API
-is made available on this port.</p>
-</div>
-<div class="paragraph">
-<p>List the available domains:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl http://localhost:8000/domains</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You should see a response similar to this:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">[
- "edfce41c55e6",
- "james.linagora.com",
- "james.local",
- "localhost",
- "test.local",
- "172.17.0.2"
-]</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Test that a domain exists:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -I -X GET http://localhost:8000/domains/test.local</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You should see an empty <code>204</code> response, which means "yes, this domain does exist".</p>
-</div>
-<div class="paragraph">
-<p>Delete our test domain:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -X DELETE http://localhost:8000/domains/test.local</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Now retest <code>test.local</code>:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -I -X GET http://localhost:8000/domains/test.local</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>This time you will receive a <code>404</code> code because the <code>test.local</code> domain no longer exists.</p>
-</div>
-<div class="paragraph">
-<p>Documentation for the webadmin is available at: <a href="http://james.apache.org/server/manage-webadmin.html" class="bare">http://james.apache.org/server/manage-webadmin.html</a></p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_optional"><a class="anchor" href="#_optional"></a>Optional</h2>
-<div class="sectionbody">
-<div class="ulist">
-<ul>
-<li>
-<p>Connect manually with SMTP (~5 minutes)</p>
-</li>
-<li>
-<p>Connect manually with POP (~5 minutes)</p>
-</li>
-<li>
-<p>Connect manually with IMAP (~5 minutes)</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_stop_the_demo"><a class="anchor" href="#_stop_the_demo"></a>Stop the demo</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>To shutdown the server:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">docker stop james ; docker rm james</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>That’s all, folks!</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/5-minute-demo.html b/james-project/3.6.0/servers/5-minute-demo.html
deleted file mode 100644
index a4e6201..0000000
--- a/james-project/3.6.0/servers/5-minute-demo.html
+++ /dev/null
@@ -1,711 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Short Demo :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Server</a></li>
- <li><a href="index.html">Servers</a></li>
- <li><a href="demo.html">Demo</a></li>
- <li><a href="5-minute-demo.html">Short Demo</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../3.8.1/servers/5-minute-demo.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="5-minute-demo.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/5-minute-demo.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Short Demo</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>In this short demo (~5 minutes), we will set up a runing James demo very quickly
-using a prepared Docker image.
-Then you will add a domain, and a user account within that domain.</p>
-</div>
-<div class="paragraph">
-<p>Requirements:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Docker</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_set_up_the_demo_server"><a class="anchor" href="#_set_up_the_demo_server"></a>Set up the demo server</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>To begin, run the James demo server using Docker:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">docker run -d -p "25:25" -p "143:143" --name james linagora/james-jpa-sample:3.4.0</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Explanation:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>docker run</code> runs the provided image with the given parameters</p>
-</li>
-<li>
-<p>The <code>-d</code> parameter runs the container in "detached" mode</p>
-</li>
-<li>
-<p><code>-p "25:25" -p "143:143"</code> attaches the image ports to the ports 25 (SMTP) and 143 (IMAP) on the host machine</p>
-</li>
-<li>
-<p>The <code>--name james</code> parameter gives the running container a name to make it easier to manipulate</p>
-</li>
-<li>
-<p><code>linagora/james-jpa-sample:3.4.0</code> is the image that is used for this demo</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Docker will pull the image and start the container.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_connect_via_the_cli"><a class="anchor" href="#_connect_via_the_cli"></a>Connect via the CLI</h2>
-<div class="sectionbody">
-<div class="sidebarblock">
-<div class="content">
-<div class="paragraph">
-<p>To run commands using the James CLI, you can use the running container via Docker:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>docker exec james java -jar /root/james-cli.jar \
- -h \<<HOST>> -p \<<PORT>> \<<COMMAND>></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>In this demo, we are using host 127.0.0.1 and port 9999, so every command looks like:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>docker exec james java -jar /root/james-cli.jar \
- -h 127.0.0.1 -p 9999 \<<COMMAND>></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Host 127.0.0.1 is of course localhost, and the use of port 9999 is completely arbitrary.</p>
-</div>
-</div>
-</div>
-<div class="paragraph">
-<p>To make this demo a little easier to use, set this up as a bash script by copying and pasting this script:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">printf '#!/bin/bash\n\ndocker exec james java -jar /root/james-cli.jar -h 127.0.0.1 -p 9999 $@' >> james ; chmod +x james</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>As an example, list all the domains currently in use by James:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./james listDomains</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You should notice that a default domain, james.local, has been created</p>
-</div>
-<div class="paragraph">
-<p>List all the current users:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./james listUsers</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You should see users <code>user01@james.local</code>, <code>user02@james.local</code>, and <code>user03@james.local</code>.</p>
-</div>
-<div class="paragraph">
-<p>Create a new "test.local" domain:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./james addDomain test.local</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>List the domains again to ensure that "test.local" has successfully been added:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./james listDomains</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Add the user "testuser" to the "test.local" domain with password "password":</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./james addUser testuser@test.local password</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You should now see your newly created user:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./james listUsers</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>And that’s a wrap!</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_stop_the_server"><a class="anchor" href="#_stop_the_server"></a>Stop the server</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>To stop the demo:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">docker stop james ; docker rm james</code></pre>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/_images/metrics.png b/james-project/3.6.0/servers/_images/metrics.png
deleted file mode 100644
index e97b021..0000000
--- a/james-project/3.6.0/servers/_images/metrics.png
+++ /dev/null
Binary files differ
diff --git a/james-project/3.6.0/servers/_images/remote-delivery-error-handling.png b/james-project/3.6.0/servers/_images/remote-delivery-error-handling.png
deleted file mode 100644
index 7e0665a..0000000
--- a/james-project/3.6.0/servers/_images/remote-delivery-error-handling.png
+++ /dev/null
Binary files differ
diff --git a/james-project/3.6.0/servers/_images/server-components.png b/james-project/3.6.0/servers/_images/server-components.png
deleted file mode 100644
index 30112d9..0000000
--- a/james-project/3.6.0/servers/_images/server-components.png
+++ /dev/null
Binary files differ
diff --git a/james-project/3.6.0/servers/_images/specialized-instances.png b/james-project/3.6.0/servers/_images/specialized-instances.png
deleted file mode 100644
index 687cefe..0000000
--- a/james-project/3.6.0/servers/_images/specialized-instances.png
+++ /dev/null
Binary files differ
diff --git a/james-project/3.6.0/servers/_images/storage.png b/james-project/3.6.0/servers/_images/storage.png
deleted file mode 100644
index d52322a..0000000
--- a/james-project/3.6.0/servers/_images/storage.png
+++ /dev/null
Binary files differ
diff --git a/james-project/3.6.0/servers/basic/architecture.html b/james-project/3.6.0/servers/basic/architecture.html
deleted file mode 100644
index bc2a37d..0000000
--- a/james-project/3.6.0/servers/basic/architecture.html
+++ /dev/null
@@ -1,549 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>James Basic Server — Architecture :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="concepts.html">Concepts</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../index.html">Apache James Server</a></li>
- <li><a href="../index.html">Servers</a></li>
- <li><a href="index.html">Basic</a></li>
- <li><a href="architecture.html">Architecture</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../../3.8.1/servers/basic/architecture.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="architecture.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/basic/architecture.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">James Basic Server — Architecture</h1>
-<div class="paragraph">
-<p>(TODO)</p>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../_/js/site.js" data-ui-root-path="../../../../_"></script>
-<script async src="../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/basic/concepts.html b/james-project/3.6.0/servers/basic/concepts.html
deleted file mode 100644
index fb8059f..0000000
--- a/james-project/3.6.0/servers/basic/concepts.html
+++ /dev/null
@@ -1,569 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>James Basic Server — Background Concepts :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="objectives.html">Objectives</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../index.html">Apache James Server</a></li>
- <li><a href="../index.html">Servers</a></li>
- <li><a href="index.html">Basic</a></li>
- <li><a href="concepts.html">Concepts</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../../3.8.1/servers/basic/concepts.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="concepts.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/basic/concepts.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">James Basic Server — Background Concepts</h1>
-<div class="paragraph">
-<p>Before embarking on your adventure with the <strong>James Basic Server</strong>, we
-highly recommend that you familiarize yourself with the following concepts:</p>
-</div>
-<div class="ulist TODO: provide links and ensure that articles exist for each of these topics">
-<ul class="TODO: provide links and ensure that articles exist for each of these topics">
-<li>
-<p><a href="../../concepts/user/index.html" class="xref page">James User Model</a></p>
-</li>
-<li>
-<p><a href="../../concepts/protocols/smtp.html" class="xref page">SMTP</a></p>
-</li>
-<li>
-<p><a href="../../concepts/protocols/imap.html" class="xref page">IMAP</a></p>
-</li>
-<li>
-<p>Secured email communications</p>
-</li>
-<li>
-<p><a href="../../concepts/storage/index.html" class="xref page">Email storage</a></p>
-</li>
-</ul>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../_/js/site.js" data-ui-root-path="../../../../_"></script>
-<script async src="../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/basic/conf/index.html b/james-project/3.6.0/servers/basic/conf/index.html
deleted file mode 100644
index af1d765..0000000
--- a/james-project/3.6.0/servers/basic/conf/index.html
+++ /dev/null
@@ -1,549 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>James Basic Mail Server Configuration :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../architecture.html">Architecture</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../../distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../../distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../index.html">Basic</a></li>
- <li><a href="index.html">Configuration</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../../../3.8.1/servers/basic/conf/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="index.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/basic/conf/index.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">James Basic Mail Server Configuration</h1>
-<div class="paragraph">
-<p>(Work in progress.)</p>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/basic/context.html b/james-project/3.6.0/servers/basic/context.html
deleted file mode 100644
index 12f7b78..0000000
--- a/james-project/3.6.0/servers/basic/context.html
+++ /dev/null
@@ -1,583 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>James Basic Server — Context :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../index.html">Apache James Server</a></li>
- <li><a href="../index.html">Servers</a></li>
- <li><a href="index.html">Basic</a></li>
- <li><a href="context.html">Context</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../../3.8.1/servers/basic/context.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="context.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/basic/context.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">James Basic Server — Context</h1>
-<div class="paragraph">
-<p>Email has been around in one form or another for more than 50 years.
-It is arguably one of the most resilient applications or our day, and
-may even be called <strong>THE</strong> killer app of our time. Most of us, if not
-all but the most unfortunate, use email on a regular basis. If you are
-reading this page over the web, it is almost 100% certain that you have
-used and continue to use email.</p>
-</div>
-<div class="paragraph">
-<p>Despite its ubiquity, the vast majority of people do not control their
-own email infrastructure. Although, unlike telecommunications or electricity
-for example, the barriers to owning and maintaining your own infrastructure
-are very low, individuals and companies alike usually defer to the large
-email providers for this essential service.
-Although relying on the big providers is easy, what they offer is often
-limited and in some cases much more costly than it ought to be.</p>
-</div>
-<div class="paragraph">
-<p>The Apache James Community is dedicated to liberating email. Our mission
-is to make email hosting both easy and fun. We do this by:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Providing an easy-to-use self-hosted server for amateur Operators</p>
-</li>
-<li>
-<p>Providing an extendable server for those more experienced Operators</p>
-</li>
-<li>
-<p>Providing a distributed solution for heavy-duty projects</p>
-</li>
-<li>
-<p>Ensuring that James remains a flexible, reliable technology platform</p>
-</li>
-</ul>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../_/js/site.js" data-ui-root-path="../../../../_"></script>
-<script async src="../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/basic/help.html b/james-project/3.6.0/servers/basic/help.html
deleted file mode 100644
index 84f0d30..0000000
--- a/james-project/3.6.0/servers/basic/help.html
+++ /dev/null
@@ -1,549 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>James Basic Server — Where to get help :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="conf/index.html">Configuration</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../index.html">Apache James Server</a></li>
- <li><a href="../index.html">Servers</a></li>
- <li><a href="index.html">Basic</a></li>
- <li><a href="help.html">Help</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../../3.8.1/servers/basic/help.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="help.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/basic/help.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">James Basic Server — Where to get help</h1>
-<div class="paragraph">
-<p>(Redo this once there is consensus in the community.)</p>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../_/js/site.js" data-ui-root-path="../../../../_"></script>
-<script async src="../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/basic/index.html b/james-project/3.6.0/servers/basic/index.html
deleted file mode 100644
index fa7c316..0000000
--- a/james-project/3.6.0/servers/basic/index.html
+++ /dev/null
@@ -1,582 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>James Basic Mail Server :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item is-current-page" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../index.html">Apache James Server</a></li>
- <li><a href="../index.html">Servers</a></li>
- <li><a href="index.html">Basic</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../../3.8.1/servers/basic/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="index.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/basic/index.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">James Basic Mail Server</h1>
-<div class="paragraph">
-<p>The <strong>James Basic Server</strong> is intended for <a href="../../concepts/user/index.html#Operator" class="xref page">Operators</a>
-who are just getting initiated with operating their own
-<a href="#concepts/???">Self-Hosted</a> mail server.</p>
-</div>
-<div class="paragraph">
-<p>The server is intended to be a mostly "out-of-the-box" solution.
-With a few small interactions necessary to configure the system, you should
-be up and running in no time with all the standard features.</p>
-</div>
-<div class="paragraph">
-<p>These documents will present all the concepts that underpin this server,
-and will walk you through its installation and configuration. If you run into
-trouble, we explain how you can get help from the James Community.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="context.html" class="xref page">The context of contemporary email</a></p>
-</li>
-<li>
-<p><a href="objectives.html" class="xref page">Objectives and motivation of the Basic Server</a></p>
-</li>
-<li>
-<p><a href="concepts.html" class="xref page">Useful background concepts</a></p>
-</li>
-<li>
-<p><a href="architecture.html" class="xref page">Overview of architecture</a></p>
-</li>
-<li>
-<p><a href="conf/index.html" class="xref page">Configuration</a></p>
-</li>
-<li>
-<p><a href="help.html" class="xref page">Where to go for help</a></p>
-</li>
-</ul>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../_/js/site.js" data-ui-root-path="../../../../_"></script>
-<script async src="../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/basic/objectives.html b/james-project/3.6.0/servers/basic/objectives.html
deleted file mode 100644
index 7dec53b..0000000
--- a/james-project/3.6.0/servers/basic/objectives.html
+++ /dev/null
@@ -1,599 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>James Basic Server — Objectives :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="context.html">Context</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../index.html">Apache James Server</a></li>
- <li><a href="../index.html">Servers</a></li>
- <li><a href="index.html">Basic</a></li>
- <li><a href="objectives.html">Objectives</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../../3.8.1/servers/basic/objectives.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="objectives.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/basic/objectives.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">James Basic Server — Objectives</h1>
-<div class="paragraph">
-<p>The objective of the Basic Server is to be as simple and minimalistic as possible,
-while still being useful. Many people wish to have a basic self-hosted mail server that they
-can use without having to become a deep technical expert.
-The Basic Server is intended to be an entry-level server that is accessible to
-those who want a self-hosted mail server, but who don’t want to have to learn about all the
-complexities of email communications.</p>
-</div>
-<div class="paragraph">
-<p>This server is therefore intended to be the simplest to set up and use in
-production.
-Of all the James Servers, it has the least amount of dependencies and configurations.
-If you are not sure which of the James servers is best for you, you should
-probably choose this one.</p>
-</div>
-<div class="paragraph">
-<p>The default configuration of the Basic Server includes the following features:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Secure SMTP (SSL/TLS) over port 465</p>
-</li>
-<li>
-<p>Secure IMAP4 (SSL/TLS) over port 993</p>
-</li>
-<li>
-<p>Local Mailbox support</p>
-<div class="ulist">
-<ul>
-<li>
-<p>Files are stored locally on the filesystem</p>
-</li>
-<li>
-<p>Optionally use a volume if you are a Docker or Kubernetes user</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p>Multi-domain (virtual domain) support</p>
-</li>
-<li>
-<p>Administration of users either via a command-line tool or the admin api</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>We have disabled all of the insecure communications and require SSL. If you have
-a specific requirement to use an insecure protocol, or if the above list does not
-satisfy your needs, then after having successfully set up this server you may want
-to move on to the <a href="../extendable.html" class="xref page">Extendable Server</a>.</p>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../_/js/site.js" data-ui-root-path="../../../../_"></script>
-<script async src="../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/demo.html b/james-project/3.6.0/servers/demo.html
deleted file mode 100644
index 8fddbcd..0000000
--- a/james-project/3.6.0/servers/demo.html
+++ /dev/null
@@ -1,582 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Server Demo :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Server</a></li>
- <li><a href="index.html">Servers</a></li>
- <li><a href="demo.html">Demo</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../3.8.1/servers/demo.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="demo.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/demo.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Server Demo</h1>
-<div class="paragraph">
-<p>The James Demo Server sets up a light-weight, disposable mail server
-so you can try it out easily on your own local machine.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="5-minute-demo.html" class="xref page">Short demo</a> (~5 minutes)</p>
-<div class="ulist">
-<ul>
-<li>
-<p>Set up a demo server</p>
-</li>
-<li>
-<p>Create a new user with the CLI</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p><a href="15-minute-demo.html" class="xref page">Long demo</a> (~15 minutes)</p>
-<div class="ulist">
-<ul>
-<li>
-<p>Same steps as above</p>
-</li>
-<li>
-<p>Interact with the server via the Admin API</p>
-</li>
-<li>
-<p>Test the server with an email client</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed.html b/james-project/3.6.0/servers/distributed.html
deleted file mode 100644
index 98e5133..0000000
--- a/james-project/3.6.0/servers/distributed.html
+++ /dev/null
@@ -1,601 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>James Distributed Mail Server :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="extendable.html">Extendable</a>
- </li>
- <li class="nav-item is-current-page" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Server</a></li>
- <li><a href="index.html">Servers</a></li>
- <li><a href="distributed.html">Distributed</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="distributed.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">James Distributed Mail Server</h1>
-<div class="paragraph">
-<p>The Distributed server offers an easy way to scale email server. Based on
-noSQL solutions, it is intended to be easy to operate for large
-deployments, without needing sharding and protocol aware load balancing.</p>
-</div>
-<div class="paragraph">
-<p>The Distributed Server does assume that you have advanced
-technical knowledge and is the most complex and feature-rich option.</p>
-</div>
-<div class="paragraph">
-<p>This server is:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Intended for use by experts only</p>
-</li>
-<li>
-<p>Used for large-scale distributed deployments</p>
-</li>
-<li>
-<p>Is designed for Mail Delivery use cases but can also carry out mail processing</p>
-</li>
-<li>
-<p>The most feature-rich server, but also by far the most complex</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>In this section of the documentation, we will introduce you to:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="distributed/objectives.html" class="xref page">Objectives and motivation of the Distributed Server</a></p>
-</li>
-<li>
-<p><a href="#distributed/architecture.adoc" class="xref unresolved">Overview of architecture</a></p>
-</li>
-<li>
-<p><a href="distributed/run.html" class="xref page">Running the Distributed Server</a></p>
-</li>
-<li>
-<p><a href="distributed/run-docker.html" class="xref page">Run the Distributed Server with Docker</a></p>
-</li>
-<li>
-<p><a href="distributed/configure/index.html" class="xref page">Configure the Distributed Server</a></p>
-</li>
-<li>
-<p><a href="distributed/operate/index.html" class="xref page">Operation of the Distributed Server</a></p>
-</li>
-<li>
-<p><a href="distributed/extending/index.html" class="xref page">How to extend the server</a></p>
-</li>
-</ul>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/architecture/consistency-model.html b/james-project/3.6.0/servers/distributed/architecture/consistency-model.html
deleted file mode 100644
index 7877f96..0000000
--- a/james-project/3.6.0/servers/distributed/architecture/consistency-model.html
+++ /dev/null
@@ -1,730 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Consistency Model :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Architecture</a></li>
- <li><a href="consistency-model.html">Consistency Model</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="consistency-model.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/architecture/consistency-model.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Consistency Model</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This page presents the consistency model used by the Distributed Server and
-points to the tools built around it.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_data_replication"><a class="anchor" href="#_data_replication"></a>Data Replication</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The Distributed Server relies on different storage technologies, all having their own
-consistency models.</p>
-</div>
-<div class="paragraph">
-<p>These data stores replicate data in order to enforce some level of availability. We call
-this process replication. By consistency, we mean the ability for all replica to hold the
-same data. By availability, we mean the ability for a replica to answer a request.</p>
-</div>
-<div class="paragraph">
-<p>In distributed systems, <a href="https://en.wikipedia.org/wiki/CAP_theorem">according to the CAP theorem</a>,
-as we will necessarily encounter network partitions, then trade-offs need to be made between
-consistency and availability.</p>
-</div>
-<div class="paragraph">
-<p>This section details this trade-off for data stores used by the Distributed Server.</p>
-</div>
-<div class="sect2">
-<h3 id="_cassandra_consistency_model"><a class="anchor" href="#_cassandra_consistency_model"></a>Cassandra consistency model</h3>
-<div class="paragraph">
-<p><a href="https://cassandra.apache.org/">Cassandra</a> is an
-<a href="https://en.wikipedia.org/wiki/Eventual_consistency">eventually consistent</a> data store.
-This means that replica can hold diverging data, but are guaranteed to converge over time.</p>
-</div>
-<div class="paragraph">
-<p>Several mechanisms are built in Cassandra to enforce this convergence, and need to be
-leveraged by <strong>Distributed Server Administrator</strong>. Namely
-<a href="https://docs.datastax.com/en/dse/5.1/dse-admin/datastax_enterprise/tools/nodetool/toolsRepair.html">nodetool repair</a>,
-<a href="https://cassandra.apache.org/doc/latest/operating/hints.html">Hinted hand-off</a> and
-<a href="https://cassandra.apache.org/doc/latest/operating/read_repair.html">Read repair</a>.</p>
-</div>
-<div class="paragraph">
-<p>The Distributed Server tries to mitigate inconsistencies by relying on
-<a href="https://docs.datastax.com/en/archived/cassandra/3.0/cassandra/dml/dmlConfigConsistency.html">QUORUM</a> read and write levels.
-This means that a majority of replica are needed for read and write operations to be performed.</p>
-</div>
-<div class="paragraph">
-<p>Critical business operations, like UID allocation, rely on strong consistency mechanisms brought by
-<a href="https://www.datastax.com/blog/2013/07/lightweight-transactions-cassandra-20">lightweight transaction</a>.</p>
-</div>
-<div class="sect3">
-<h4 id="_about_multi_data_center_setups"><a class="anchor" href="#_about_multi_data_center_setups"></a>About multi data-center setups</h4>
-<div class="paragraph">
-<p>As strong consistency is required for some operations, and as lightweight transactions are
-slow across data centers, running James with a
-<a href="https://docs.datastax.com/en/ddac/doc/datastax_enterprise/production/DDACmultiDCperWorkloadType.html">multi data-center</a>
-Cassandra setup is discouraged.</p>
-</div>
-<div class="paragraph">
-<p>However <a href="../configure/cassandra.html" class="xref page">this page</a> enables setting alternative read level,
-which could be acceptable regarding limited requirements. <code>LOCAL_QUORUM</code> coupled with <code>LOCAL_SERIAL</code>
-is likely the only scalable setup.</p>
-</div>
-<div class="paragraph">
-<p>Running the Distributed Server IMAP server in a multi datacenter setup will likely result either in data loss,
-or very slow operations - as we rely on monotic UID generation, without strong consistency, UIDs could be allocated
-several times. Other protocols, like JMAP, suffer less from such limitations.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_elasticsearch_consistency_model"><a class="anchor" href="#_elasticsearch_consistency_model"></a>ElasticSearch consistency model</h3>
-<div class="paragraph">
-<p>ElasticSearch relies on <a href="https://www.elastic.co/blog/a-new-era-for-cluster-coordination-in-elasticsearch">strong consistency</a>
-with home grown algorithm.</p>
-</div>
-<div class="paragraph">
-<p>The 6.x release line, that the distributed server is using is known to be slow to recover from failures.</p>
-</div>
-<div class="paragraph">
-<p>Be aware that data is asynchronously indexed in ElasticSearch, changes will be eventually visible.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_rabbitmq_consistency_model"><a class="anchor" href="#_rabbitmq_consistency_model"></a>RabbitMQ consistency model</h3>
-<div class="paragraph">
-<p>The Distributed Server relies out of the box on a single RabbitMQ server, thus consistency concerns
-are not (yet) applicable. Availability concerns are applicable.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_denormalization"><a class="anchor" href="#_denormalization"></a>Denormalization</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>In Cassandra, data needs to be structured to match the read patterns. To support several conflicting
-read patterns, the data needs to be duplicated into different structures. This process is called
-denormalization.</p>
-</div>
-<div class="paragraph">
-<p>While data can be consistent at the table level, some inconsistencies can sneak in at the applicative
-level across denormalization tables.</p>
-</div>
-<div class="paragraph">
-<p>We write to a "table of truth" first, then duplicate the data to denormalization tables.</p>
-</div>
-<div class="paragraph">
-<p>The Distributed server offers several mechanisms to mitigate these inconsistencies:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Writes to denormalization tables are retried.</p>
-</li>
-<li>
-<p>Some <a href="../operate/guide.html#_solving_cassandra_inconsistencies" class="xref page">SolveInconsistencies tasks</a> are exposed and are able to heal a given denormalization table.
-They reset the "deduplication tables" content to the "table of truth" content.</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/blob/master/src/adr/0042-applicative-read-repairs.md">Read repairs</a>,
-when implemented for a given denormalization, enables auto-healing. When an inconsistency is detected, They reset the
-"deduplication tables" entry to the "table of truth" entry.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_consistency_across_data_stores"><a class="anchor" href="#_consistency_across_data_stores"></a>Consistency across data stores</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The Distributed Server leverages several data stores:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Cassandra is used for metadata storage</p>
-</li>
-<li>
-<p>ElasticSearch for search</p>
-</li>
-<li>
-<p>Object Storage for large object storage</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Thus the Distributed Server also offers mechanisms to enforce consistency across data stores.</p>
-</div>
-<div class="sect2">
-<h3 id="_write_path_organisation"><a class="anchor" href="#_write_path_organisation"></a>Write path organisation</h3>
-<div class="paragraph">
-<p>The primary data stores are composed of Cassandra for metadata and Object storage for binary data.</p>
-</div>
-<div class="paragraph">
-<p>To ensure the data referenced in Cassandra is pointing to a valid object in the object store, we write
-the object store payload first, then write the corresponding metadata in Cassandra.</p>
-</div>
-<div class="paragraph">
-<p>Such a procedure avoids metadata pointing to unexisting blobs, however might lead to some unreferenced
-blobs.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_cassandra_elasticsearch"><a class="anchor" href="#_cassandra_elasticsearch"></a>Cassandra <⇒ ElasticSearch</h3>
-<div class="paragraph">
-<p>After being written to the primary stores (namely Cassandra & Object Storage), email content is
-asynchronously indexed into ElasticSearch.</p>
-</div>
-<div class="paragraph">
-<p>This process, called the EventBus, which retries temporary errors, and stores transient errors for
-later admin-triggered retries is described further <a href="../operate/guide.html#_mailbox_event_bus" class="xref page">here</a>.
-His role is to spread load and limit inconsistencies.</p>
-</div>
-<div class="paragraph">
-<p>Furthermore, some <a href="../operate/guide.html#_usual_troubleshooting_procedures" class="xref page">re-indexing tasks</a>
-enables to re-synchronise ElasticSearch content with the primary data stores</p>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/architecture/index.html b/james-project/3.6.0/servers/distributed/architecture/index.html
deleted file mode 100644
index 42f34f1..0000000
--- a/james-project/3.6.0/servers/distributed/architecture/index.html
+++ /dev/null
@@ -1,1103 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Architecture :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Architecture</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="index.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/architecture/index.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Architecture</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This sections presents the Distributed Server architecture.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_storage"><a class="anchor" href="#_storage"></a>Storage</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>In order to deliver its promises, the Distributed Server leverages the following storage strategies:</p>
-</div>
-<div class="imageblock">
-<div class="content">
-<img src="../../_images/storage.png" alt="Storage responsibilities for the Distributed Server">
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>Cassandra</strong> is used for metadata storage</p>
-</li>
-<li>
-<p>The <strong>blob store</strong> storage interface is responsible of storing potentially large binary data. For instance
- email bodies, headers or attachments. Different technologies can be used: <strong>Cassandra</strong>, or S3 compatible <strong>Object Storage</strong>
-(S3 or Swift)</p>
-</li>
-<li>
-<p><strong>ElasticSearch</strong> component empowers full text search on emails.</p>
-</li>
-<li>
-<p><strong>RabbitMQ</strong> enables James nodes of a same cluster to collaborate together.</p>
-</li>
-<li>
-<p><strong>Tika</strong> (optional) enables text extraction from attachments, thus improving full text search results.</p>
-</li>
-<li>
-<p><strong>SpamAssassin</strong> (optional) can be used for Spam detection and user feedback is supported.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p><a href="consistency-model.html" class="xref page">This page</a> further details Distributed James consistency model.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_protocols"><a class="anchor" href="#_protocols"></a>Protocols</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The following protocols are supported and can be used to interact with the Distributed Server:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>SMTP</strong></p>
-</li>
-<li>
-<p><strong>IMAP</strong></p>
-</li>
-<li>
-<p><a href="../operate/webadmin.html" class="xref page">WebAdmin</a> REST Administration API</p>
-</li>
-<li>
-<p><strong>LMTP</strong></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The following protocols should be considered experimental</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>JMAP</strong> (draft specification as defined <a href="https://github.com/apache/james-project/tree/master/server/protocols/jmap-draft/doc">here</a>)</p>
-</li>
-<li>
-<p><strong>POP3</strong></p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_topology"><a class="anchor" href="#_topology"></a>Topology</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>While it is perfectly possible to deploy homogeneous James instances, with the same configuration and thus the same
-protocols and the same responsibilities one might want to investigate in
-<a href="specialized-instances.html" class="xref page">'Specialized instances'</a>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_components"><a class="anchor" href="#_components"></a>Components</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This section presents the various components of the Distributed server, providing context about
-their interactions, and about their implementations.</p>
-</div>
-<div class="sect2">
-<h3 id="_high_level_view"><a class="anchor" href="#_high_level_view"></a>High level view</h3>
-<div class="paragraph">
-<p>Here is a high level view of the various server components and their interactions:</p>
-</div>
-<div class="imageblock">
-<div class="content">
-<img src="../../_images/server-components.png" alt="Server components mobilized for SMTP & IMAP">
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>The SMTP protocol receives a mail, and enqueue it on the MailQueue</p>
-</li>
-<li>
-<p>The MailetContainer will start processing the mail Asynchronously and will take business decisions like storing the
-email localy in a user mailbox. The behaviour of the MailetContainer is highly customizable thanks to the Mailets and
-the Matcher composibility.</p>
-</li>
-<li>
-<p>The Mailbox component is responsible of storing a user’s mails.</p>
-</li>
-<li>
-<p>The user can use the IMAP or the JMAP protocol to retrieve and read his mails.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>These components will be presented more in depth below.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_mail_processing"><a class="anchor" href="#_mail_processing"></a>Mail processing</h3>
-<div class="paragraph">
-<p>Mail processing allows to take asynchronously business decisions on
-received emails.</p>
-</div>
-<div class="paragraph">
-<p>Here are its components:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>The <code>spooler</code> takes mail out of the mailQueue and executes mail
-processing within the <code>mailet container</code>.</p>
-</li>
-<li>
-<p>The <code>mailet container</code> synchronously executes the user defined logic.
-This <code>logic' is written through the use of `mailet</code>, <code>matcher</code> and
-<code>processor</code>.</p>
-</li>
-<li>
-<p>A <code>mailet</code> represents an action: mail modification, envelop
-modification, a side effect, or stop processing.</p>
-</li>
-<li>
-<p>A <code>matcher</code> represents a condition to execute a mailet.</p>
-</li>
-<li>
-<p>A <code>processor</code> is a flow of pair of <code>matcher</code> and <code>mailet</code> executed
-sequentially. The <code>ToProcessor</code> mailet is a <code>goto</code> instruction to start
-executing another <code>processor</code></p>
-</li>
-<li>
-<p>A <code>mail repository</code> allows storage of a mail as part of its
-processing. Standard configuration relies on the following mail
-repository:</p>
-<div class="ulist">
-<ul>
-<li>
-<p><code>cassandra://var/mail/error/</code> : unexpected errors that occurred
-during mail processing. Emails impacted by performance related
-exceptions, or logical bug within James code are typically stored here.
-These mails could be reprocessed once the cause of the error is fixed.
-The <code>Mail.error</code> field can help diagnose the issue. Correlation with
-logs can be achieved via the use of the <code>Mail.name</code> field.</p>
-</li>
-<li>
-<p><code>cassandra://var/mail/address-error/</code> : mail addressed to a
-non-existing recipient of a handled local domain. These mails could be
-reprocessed once the user is created, for instance.</p>
-</li>
-<li>
-<p><code>cassandra://var/mail/relay-denied/</code> : mail for whom relay was
-denied: missing authentication can, for instance, be a cause. In
-addition to prevent disasters upon miss configuration, an email review
-of this mail repository can help refine a host spammer blacklist.</p>
-</li>
-<li>
-<p><code>cassandra://var/mail/rrt-error/</code> : runtime error upon Recipient
-Rewritting occurred. This is typically due to a loop.</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_mail_queue"><a class="anchor" href="#_mail_queue"></a>Mail Queue</h3>
-<div class="paragraph">
-<p>An email queue is a mandatory component of SMTP servers. It is a system
-that creates a queue of emails that are waiting to be processed for
-delivery. Email queuing is a form of Message Queuing – an asynchronous
-service-to-service communication. A message queue is meant to decouple a
-producing process from a consuming one. An email queue decouples email
-reception from email processing. It allows them to communicate without
-being connected. As such, the queued emails wait for processing until
-the recipient is available to receive them. As James is an Email Server,
-it also supports mail queue as well.</p>
-</div>
-<div class="sect3">
-<h4 id="_why_mail_queue_is_necessary"><a class="anchor" href="#_why_mail_queue_is_necessary"></a>Why Mail Queue is necessary</h4>
-<div class="paragraph">
-<p>You might often need to check mail queue to make sure all emails are
-delivered properly. At first, you need to know why email queues get
-clogged. Here are the two core reasons for that:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Exceeded volume of emails</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Some mailbox providers enforce email rate limits on IP addresses. The
-limits are based on the sender reputation. If you exceeded this rate and
-queued too many emails, the delivery speed will decrease.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Spam-related issues</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Another common reason is that your email has been busted by spam
-filters. The filters will let the emails gradually pass to analyze how
-the rest of the recipients react to the message. If there is slow
-progress, it’s okay. Your email campaign is being observed and assessed.
-If it’s stuck, there could be different reasons including the blockage
-of your IP address.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_why_combining_cassandra_rabbitmq_and_object_storage_for_mailqueue"><a class="anchor" href="#_why_combining_cassandra_rabbitmq_and_object_storage_for_mailqueue"></a>Why combining Cassandra, RabbitMQ and Object storage for MailQueue</h4>
-<div class="ulist">
-<ul>
-<li>
-<p>RabbitMQ ensures the messaging function, and avoids polling.</p>
-</li>
-<li>
-<p>Cassandra enables administrative operations such as browsing, deleting
-using a time series which might require fine performance tuning (see
-<a href="http://cassandra.apache.org/doc/latest/operating/index.html">Operating
-Casandra documentation</a>).</p>
-</li>
-<li>
-<p>Object Storage stores potentially large binary payload.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>However the current design do not implement delays. Delays allow to
-define the time a mail have to be living in the mailqueue before being
-dequeued and is used for example for exponential wait delays upon remote
-delivery retries, or</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_mailbox"><a class="anchor" href="#_mailbox"></a>Mailbox</h3>
-<div class="paragraph">
-<p>Storage for emails belonging for users.</p>
-</div>
-<div class="paragraph">
-<p>Metadata are stored in Cassandra while headers, bodies and attachments are stored
-within the <a href="#_blobstore">BlobStore</a>.</p>
-</div>
-<div class="sect3">
-<h4 id="_search_index"><a class="anchor" href="#_search_index"></a>Search index</h4>
-<div class="paragraph">
-<p>Emails are indexed asynchronously in ElasticSearch via the <a href="#_event_bus">EventBus</a>
-in order to enpower advanced and fast email full text search.</p>
-</div>
-<div class="paragraph">
-<p>Text extraction can be set up using <a href="https://tika.apache.org/">Tika</a>, allowing
-to extract the text from attachment, allowing to search your emails based on the attachment
-textual content. In such case, the ElasticSearch indexer will call a Tika server prior
-indexing.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_quotas"><a class="anchor" href="#_quotas"></a>Quotas</h4>
-<div class="paragraph">
-<p>Current Quotas of users are hold in a Cassandra projection. Limitations can be defined via
-user, domain or globally.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_event_bus"><a class="anchor" href="#_event_bus"></a>Event Bus</h4>
-<div class="paragraph">
-<p>Distributed James relies on an event bus system to enrich mailbox capabilities. Each
-operation performed on the mailbox will trigger related events, that can
-be processed asynchronously by potentially any James node on a
-distributed system.</p>
-</div>
-<div class="paragraph">
-<p>Many different kind of events can be triggered during a mailbox
-operation, such as:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>MailboxEvent</code>: event related to an operation regarding a mailbox:</p>
-<div class="ulist">
-<ul>
-<li>
-<p><code>MailboxDeletion</code>: a mailbox has been deleted</p>
-</li>
-<li>
-<p><code>MailboxAdded</code>: a mailbox has been added</p>
-</li>
-<li>
-<p><code>MailboxRenamed</code>: a mailbox has been renamed</p>
-</li>
-<li>
-<p><code>MailboxACLUpdated</code>: a mailbox got its rights and permissions updated</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p><code>MessageEvent</code>: event related to an operation regarding a message:</p>
-<div class="ulist">
-<ul>
-<li>
-<p><code>Added</code>: messages have been added to a mailbox</p>
-</li>
-<li>
-<p><code>Expunged</code>: messages have been expunged from a mailbox</p>
-</li>
-<li>
-<p><code>FlagsUpdated</code>: messages had their flags updated</p>
-</li>
-<li>
-<p><code>MessageMoveEvent</code>: messages have been moved from a mailbox to an
-other</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p><code>QuotaUsageUpdatedEvent</code>: event related to quota update</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Mailbox listeners can register themselves on this event bus system to be
-called when an event is fired, allowing to do different kind of extra
-operations on the system, like:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Current quota calculation</p>
-</li>
-<li>
-<p>Message indexation with ElasticSearch</p>
-</li>
-<li>
-<p>Mailbox annotations cleanup</p>
-</li>
-<li>
-<p>Ham/spam reporting to SpamAssassin</p>
-</li>
-<li>
-<p>…</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_deleted_messages_vault"><a class="anchor" href="#_deleted_messages_vault"></a>Deleted Messages Vault</h4>
-<div class="paragraph">
-<p>Deleted Messages Vault is an interesting feature that will help James
-users have a chance to:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>retain users deleted messages for some time.</p>
-</li>
-<li>
-<p>restore & export deleted messages by various criteria.</p>
-</li>
-<li>
-<p>permanently delete some retained messages.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>If the Deleted Messages Vault is enabled when users delete their mails,
-and by that we mean when they try to definitely delete them by emptying
-the trash, James will retain these mails into the Deleted Messages
-Vault, before an email or a mailbox is going to be deleted. And only
-administrators can interact with this component via
-wref:webadmin.adoc#_deleted-messages-vault[WebAdmin] REST APIs].</p>
-</div>
-<div class="paragraph">
-<p>However, mails are not retained forever as you have to configure a
-retention period before using it (with one-year retention by default if
-not defined). It’s also possible to permanently delete a mail if needed.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_data"><a class="anchor" href="#_data"></a>Data</h3>
-<div class="paragraph">
-<p>Storage for domains and users.</p>
-</div>
-<div class="paragraph">
-<p>Domains are persisted in Cassandra.</p>
-</div>
-<div class="paragraph">
-<p>Users can be managed in Cassandra, or via a LDAP (read only).</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_recipient_rewrite_tables"><a class="anchor" href="#_recipient_rewrite_tables"></a>Recipient rewrite tables</h3>
-<div class="paragraph">
-<p>Storage of Recipients Rewritting rules, in Cassandra.</p>
-</div>
-<div class="sect3">
-<h4 id="_mapping_types"><a class="anchor" href="#_mapping_types"></a>Mapping types</h4>
-<div class="paragraph">
-<p>James allows using various mapping types for better expressing the intent of your address rewritting logic:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>Domain mapping</strong>: Rewrites the domain of mail addresses. Use it for technical purposes, user will not
-be allowed to use the source in their FROM address headers. Domain mappings can be managed via the CLI and
-added via <a href="../operate/webadmin.html#_domain_mappings" class="xref page">WebAdmin</a></p>
-</li>
-<li>
-<p><strong>Domain aliases</strong>: Rewrites the domain of mail addresses. Express the idea that both domains can be used
-inter-changeably. User will be allowed to use the source in their FROM address headers. Domain aliases can
-be managed via <a href="../operate/webadmin.html#_get_the_list_of_aliases_for_a_domain" class="xref page">WebAdmin</a></p>
-</li>
-<li>
-<p><strong>Forwards</strong>: Replaces the source address by another one. Vehicles the intent of forwarding incoming mails
-to other users. Listing the forward source in the forward destinations keeps a local copy. User will not be
-allowed to use the source in their FROM address headers. Forward can
-be managed via <a href="../operate/webadmin.html#_address_forwards" class="xref page">WebAdmin</a></p>
-</li>
-<li>
-<p><strong>Groups</strong>: Replaces the source address by another one. Vehicles the intent of a group registration: group
-address will be swapped by group member addresses (Feature poor mailing list). User will not be
-allowed to use the source in their FROM address headers. Groups can
-be managed via <a href="../operate/webadmin.html#_address_group" class="xref page">WebAdmin</a></p>
-</li>
-<li>
-<p><strong>Aliases</strong>: Replaces the source address by another one. Represents user owned mail address, with which
-he can interact as if it was his main mail address. User will be allowed to use the source in their FROM
-address headers. Aliases can be managed via <a href="../operate/webadmin.html#_address_aliases" class="xref page">WebAdmin</a></p>
-</li>
-<li>
-<p><strong>Address mappings</strong>: Replaces the source address by another one. Use for technical purposes, this mapping type do
-not hold specific intent. Prefer using one of the above mapping types…​ User will not be allowed to use the source
-in their FROM address headers. Address mappings can be managed via the CLI or via
-<a href="../operate/webadmin.html#_address_mappings" class="xref page">WebAdmin</a></p>
-</li>
-<li>
-<p><strong>Regex mappings</strong>: Applies the regex on the supplied address. User will not be allowed to use the source
-in their FROM address headers. Regex mappings can be managed via the CLI or via
-<a href="../operate/webadmin.html#_regex_mapping" class="xref page">WebAdmin</a></p>
-</li>
-<li>
-<p><strong>Error</strong>: Throws an error upon processing. User will not be allowed to use the source
-in their FROM address headers. Errors can be managed via the CLI</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_blobstore"><a class="anchor" href="#_blobstore"></a>BlobStore</h3>
-<div class="paragraph">
-<p>Stores potentially large binary data.</p>
-</div>
-<div class="paragraph">
-<p>Mailbox component, Mail Queue component, Deleted Message Vault
-component relies on it.</p>
-</div>
-<div class="paragraph">
-<p>Supported backends include S3 compatible ObjectStorage (<a href="https://wiki.openstack.org/wiki/Swift">Swift</a>, S3 API).</p>
-</div>
-<div class="paragraph">
-<p>Encryption can be configured on top of ObjectStorage.</p>
-</div>
-<div class="paragraph">
-<p>Blobs are currently deduplicated in order to reduce storage space. This means that two blobs with
-the same content will be stored one once.</p>
-</div>
-<div class="paragraph">
-<p>The downside is that deletion is more complicated, and a garbage collection needs to be run. This is a work
-in progress. See <a href="https://issues.apache.org/jira/browse/JAMES-3150">JAMES-3150</a>.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_task_manager"><a class="anchor" href="#_task_manager"></a>Task Manager</h3>
-<div class="paragraph">
-<p>Allows to control and schedule long running tasks run by other
-components. Among other it enables scheduling, progress monitoring,
-cancelation of long running tasks.</p>
-</div>
-<div class="paragraph">
-<p>Distributed James leverage a task manager using Event Sourcing and RabbitMQ for messaging.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_event_sourcing"><a class="anchor" href="#_event_sourcing"></a>Event sourcing</h3>
-<div class="paragraph">
-<p><a href="https://martinfowler.com/eaaDev/EventSourcing.html">Event sourcing</a> implementation
-for the Distributed server stores events in Cassandra. It enables components
-to rely on event sourcing technics for taking decisions.</p>
-</div>
-<div class="paragraph">
-<p>A short list of usage are:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Data leak prevention storage</p>
-</li>
-<li>
-<p>JMAP filtering rules storage</p>
-</li>
-<li>
-<p>Validation of the MailQueue configuration</p>
-</li>
-<li>
-<p>Sending email warnings to user close to their quota</p>
-</li>
-<li>
-<p>Implementation of the TaskManager</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/architecture/specialized-instances.html b/james-project/3.6.0/servers/distributed/architecture/specialized-instances.html
deleted file mode 100644
index 63aa2dd..0000000
--- a/james-project/3.6.0/servers/distributed/architecture/specialized-instances.html
+++ /dev/null
@@ -1,606 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Specialized instances :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Architecture</a></li>
- <li><a href="specialized-instances.html">Specialized instances</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="specialized-instances.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/architecture/specialized-instances.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Specialized instances</h1>
-<div class="paragraph">
-<p>While it is perfectly possible to deploy homogeneous James instances, with the same configuration and thus the same
-protocols and the same responsibilities one might want to investigate in 'Specialized instances'.</p>
-</div>
-<div class="paragraph">
-<p>This deployment topology consists of Distributed James servers with heterogeneous configurations on top of shared
-data-bases. Groups of James servers will thus handle various protocols and have different responsibilities.</p>
-</div>
-<div class="paragraph">
-<p>This approach limits cascading failures across protocols and services. Think of <strong>OutOfMemoryErrors</strong>, Cassandra driver
-queue overuse, CPUs starvation, etc.</p>
-</div>
-<div class="paragraph">
-<p>However, we can’t speak of micro-services here: all James instances runs the same code, James is still a monolith, and
-databases need to be shared across instances.</p>
-</div>
-<div class="imageblock">
-<div class="content">
-<img src="../../_images/specialized-instances.png" alt="Example of Specialized instances topology">
-</div>
-</div>
-<div class="paragraph">
-<p>We speak of:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>Front-line servers</strong> serves protocols. James enables to easily turn protocols on and off. Typically, each protocol would
-be isolated in its own group of James instances: james-imap, james-jmap, james-smtp, james-webadmin, etc…​ Refer to
-protocols configuration files to learn more.</p>
-</li>
-<li>
-<p><strong>Back-office servers</strong> handles other services like:</p>
-</li>
-<li>
-<p>Mail processing.</p>
-</li>
-<li>
-<p>Remote delivery.</p>
-</li>
-<li>
-<p>Event processing.</p>
-</li>
-<li>
-<p>Task execution.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Front-line servers will likely not handle back office responsibilities (but be sure to have back-office servers that do!).
- - <a href="../configure/mailetcontainer.html" class="xref page">Mail processing can be switched off</a>.
- - <a href="../configure/listeners.html" class="xref page">Mailbox event processing can be switched off</a>.
- - <a href="../configure/rabbitmq.html" class="xref page">Task execution can be switched off</a>.
- - Remote Delivery service is not started if the RemoteDelivery mailet is not positioned in mailetcontainer.xml.</p>
-</div>
-<div class="paragraph">
-<p>Of course, the above instances can be collocated at will, to reach some intermediate deployments with fewer
-instances to mitigate costs.</p>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/configure/batchsizes.html b/james-project/3.6.0/servers/distributed/configure/batchsizes.html
deleted file mode 100644
index 2c6adc6..0000000
--- a/james-project/3.6.0/servers/distributed/configure/batchsizes.html
+++ /dev/null
@@ -1,598 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — batchsizes.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="5">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Core components</li>
- <li><a href="batchsizes.html">batchsizes.properties</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="batchsizes.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/configure/batchsizes.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — batchsizes.properties</h1>
-<div class="paragraph">
-<p>This files allow to define the amount of data that should be fetched 'at once' when interacting with the mailbox. This is
-needed as IMAP can generate some potentially large requests.</p>
-</div>
-<div class="paragraph">
-<p>Increasing these values tend to fasten individual requests, at the cost of enabling potential higher load.</p>
-</div>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/batchsizes.properties">example</a>
-to get some examples and hints.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. batchsizes.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">fetch.metadata</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional, defaults to 200. How many messages should be read in a batch when using FetchType.MetaData</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">fetch.headers</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional, defaults to 200. How many messages should be read in a batch when using FetchType.Header</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">fetch.body</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional, defaults to 100. How many messages should be read in a batch when using FetchType.Body</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">fetch.full</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional, defaults to 50. How many messages should be read in a batch when using FetchType.Full</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">copy</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional, defaults to 200. How many messages should be copied in a batch.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">move</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional, defaults to 200. How many messages should be moved in a batch.</p></td>
-</tr>
-</tbody>
-</table>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/configure/blobstore.html b/james-project/3.6.0/servers/distributed/configure/blobstore.html
deleted file mode 100644
index 8a0a8fc..0000000
--- a/james-project/3.6.0/servers/distributed/configure/blobstore.html
+++ /dev/null
@@ -1,805 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — blobstore.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="5">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Storage dependencies</li>
- <li><a href="blobstore.html">blobstore.properties</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="blobstore.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/configure/blobstore.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — blobstore.properties</h1>
-<div class="sect1">
-<h2 id="_blobstore"><a class="anchor" href="#_blobstore"></a>BlobStore</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This file is optional. If omitted, the <strong>cassandra</strong> blob store will be used.</p>
-</div>
-<div class="paragraph">
-<p>BlobStore is the dedicated component to store blobs, non-indexable content.
-James uses the BlobStore for storing blobs which are usually mail contents, attachments, deleted mails…​</p>
-</div>
-<div class="paragraph">
-<p>You can choose the underlying implementation of BlobStore to fit with your James setup.</p>
-</div>
-<div class="paragraph">
-<p>It could be the implementation on top of Cassandra or file storage service S3 compatible like Openstack Swift and AWS S3.</p>
-</div>
-<div class="paragraph">
-<p>Consult <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/blob.properties">blob.properties</a>
-in GIT to get some examples and hints.</p>
-</div>
-<div class="sect2">
-<h3 id="_implementation_choice"><a class="anchor" href="#_implementation_choice"></a>Implementation choice</h3>
-<div class="paragraph">
-<p><strong>implementation</strong> :</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>cassandra: use cassandra based BlobStore</p>
-</li>
-<li>
-<p>objectstorage: use Swift/AWS S3 based BlobStore</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p><strong>deduplication.enable</strong>: Mandatory. Supported value: true and false.</p>
-</div>
-<div class="paragraph">
-<p>If you choose to enable deduplication, the mails with the same content will be stored only once.</p>
-</div>
-<div class="admonitionblock warning">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-warning" title="Warning"></i>
-</td>
-<td class="content">
-Once this feature is enabled, there is no turning back as turning it off will lead to the deletion of all
-the mails sharing the same content once one is deleted.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>This feature also requires a garbage collector mechanism to effectively drop blobs, which is not implemented yet.</p>
-</div>
-<div class="paragraph">
-<p>Consequently, all the requested deletions will not be performed, meaning that blobstore will only grow.</p>
-</div>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-note" title="Note"></i>
-</td>
-<td class="content">
-If you are upgrading from James 3.5 or older, the deduplication was enabled.
-</td>
-</tr>
-</table>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_cassandra_blobstore_cache"><a class="anchor" href="#_cassandra_blobstore_cache"></a>Cassandra BlobStore Cache</h3>
-<div class="paragraph">
-<p>A Cassandra cache can be enabled to reduce latency when reading small blobs frequently.
-A dedicated keyspace with a replication factor of one is then used.
-Cache eviction policy is TTL based.
-Only blobs below a given threshold will be stored.
-To be noted that blobs are stored within a single Cassandra row, hence a low threshold should be used.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. blobstore.properties cache related content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cache.enable</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">DEFAULT: false, optional, must be a boolean. Whether the cache should be enabled.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cache.cassandra.ttl</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">DEFAULT: 7 days, optional, must be a duration. Cache eviction policy is TTL based.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cache.cassandra.timeout</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">DEFAULT: 100ms, optional, must be a duration, cannot exceed 1 hour.
-Timeout after which this cache should be bypassed.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cache.sizeThresholdInBytes</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">DEFAULT: 8192, optional, must be a positive integer. Unit: bytes.
-Supported units: bytes, Kib, MiB, GiB, TiB
-Maximum size of stored objects expressed in bytes.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="sect2">
-<h3 id="_object_storage_configuration"><a class="anchor" href="#_object_storage_configuration"></a>Object storage configuration</h3>
-<div class="sect3">
-<h4 id="_aws_s3_configuration"><a class="anchor" href="#_aws_s3_configuration"></a>AWS S3 Configuration</h4>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 2. blobstore.properties S3 related properties</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.s3.endPoint</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">S3 service endpoint</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.s3.region</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">S3 region</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.s3.accessKeyId</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys">S3 access key id</a></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.s3.secretKey</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys">S3 access key secret</a></p></td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="sect3">
-<h4 id="_buckets_configuration"><a class="anchor" href="#_buckets_configuration"></a>Buckets Configuration</h4>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 3. Bucket configuration</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.bucketPrefix</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Bucket is an concept in James and similar to Containers in Swift or Buckets in AWS S3.
-BucketPrefix is the prefix of bucket names in James BlobStore</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">objectstorage.namespace</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">BlobStore default bucket name. Most of blobs storing in BlobStore are inside the default bucket.
-Unless a special case like storing blobs of deleted messages.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_blob_export"><a class="anchor" href="#_blob_export"></a>Blob Export</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Blob Exporting is the mechanism to help James to export a blob from an user to another user.
-It is commonly used to export deleted messages (consult <a href="/server/config-vault">configuring deleted messages vault</a>).
-The deleted messages are transformed into a blob and James will export that blob to the target user.</p>
-</div>
-<div class="paragraph">
-<p>This configuration helps you choose the blob exporting mechanism fit with your James setup and it is only applicable with Guice products.</p>
-</div>
-<div class="paragraph">
-<p>Consult <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/blob.properties">blob.properties</a>
-in GIT to get some examples and hints.</p>
-</div>
-<div class="paragraph">
-<p>Configuration for exporting blob content:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 4. blobstore.properties content</caption>
-<colgroup>
-<col style="width: 100%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">blob.export.implementation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">localFile: Local File Exporting Mechanism (explained below). Default: localFile</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">linshare: LinShare Exporting Mechanism (explained below)</p></td>
-</tr>
-</tbody>
-</table>
-<div class="sect2">
-<h3 id="_local_file_blob_export_configuration"><a class="anchor" href="#_local_file_blob_export_configuration"></a>Local File Blob Export Configuration</h3>
-<div class="paragraph">
-<p>For each request, this mechanism retrieves the content of a blob and save it to a distinct local file, then send an email containing the absolute path of that file to the target mail address.</p>
-</div>
-<div class="paragraph">
-<p>Note: that absolute file path is the file location on James server. Therefore, if there are two or more James servers connected, it should not be considered an option.</p>
-</div>
-<div class="paragraph">
-<p><strong>blob.export.localFile.directory</strong>: The directory URL to store exported blob data in files, and the URL following
-<a href="http://james.apache.org/server/3/apidocs/org/apache/james/filesystem/api/FileSystem.html">James File System scheme</a>.
-Default: <a href="file://var/blobExporting" class="bare">file://var/blobExporting</a></p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_linshare_blob_export_configuration"><a class="anchor" href="#_linshare_blob_export_configuration"></a>LinShare Blob Export Configuration</h3>
-<div class="paragraph">
-<p>Instead of exporting blobs in local file system, using <a href="https://www.linshare.org/en/index.html">LinShare</a>
-helps you upload your blobs and people you have been shared to can access those blobs by accessing to
-LinShare server and download them.</p>
-</div>
-<div class="paragraph">
-<p>This way helps you to share via whole network as long as they can access to LinShare server.</p>
-</div>
-<div class="paragraph">
-<p>To get an example or details explained, visit <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/blob.properties">blob.properties</a></p>
-</div>
-<div class="paragraph">
-<p><strong>blob.export.linshare.url</strong>: The URL to connect to LinShare</p>
-</div>
-<div class="paragraph">
-<p><strong>blob.export.linshare.token</strong>: The authentication token to connect to LinShare</p>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/configure/cassandra.html b/james-project/3.6.0/servers/distributed/configure/cassandra.html
deleted file mode 100644
index 9e92231..0000000
--- a/james-project/3.6.0/servers/distributed/configure/cassandra.html
+++ /dev/null
@@ -1,819 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — cassandra.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item is-current-page" data-depth="5">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Storage dependencies</li>
- <li><a href="cassandra.html">cassandra.properties</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="cassandra.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/configure/cassandra.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — cassandra.properties</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/cassandra.properties">example</a>
-to get some examples and hints.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_configuration"><a class="anchor" href="#_configuration"></a>Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Here are generic properties:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. cassandra.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandra.nodes</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">List of some nodes of the cassandra’s cluster in following format host:port or host, if the port is not specified we use 9042</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandra.keyspace.create</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Indicate if the keyspace should be created by James. Optional, default value: <strong>false</strong>
-If set to true James will attempt to create the keyspace when starting up.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandra.keyspace</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Is the name of the keyspace used by James. Optional, default value: <strong>apache_james</strong></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandra.user</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Username used as a credential for contacting Cassandra cluster. Optional, default is absent,
-required if <strong>cassandra.password</strong> is supplied</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandra.password</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Password used as a credential for contacting Cassandra cluster. Optional, default is absent,
-required if <strong>cassandra.user</strong> is supplied</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandra.ssl</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Whether SSL should be enabled on the communications with Cassandra cluster. Optional, defaults to false.</p>
-<p class="tableblock">The keystore used for trusting SSL server socket can be set via JSSE system properties as explained on
-<a href="https://docs.datastax.com/en/developer/java-driver/3.7/manual/ssl/">Cassandra driver manual</a>.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandra.replication.factor</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Is the replication factor used upon keyspace creation. Modifying this property while the keyspace already exists
-will have no effect. Optional. Default value 1.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandra.query.logger.constant.threshold</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">If specified all queries that take more than the given integer in millisecond will be considered slow and logged.
-If not specified by default a DynamicThresholdQueryLogger will be used (see above)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandra.query.slow.query.latency.threshold.percentile</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Default is com.datastax.driver.core.QueryLogger.DEFAULT_SLOW_QUERY_THRESHOLD_PERCENTILE.
-The latency percentile beyond which queries are considered 'slow' and will be logged.
-If you specify cassandra.query.logger.constant.threshold, you should not specify this property</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandra.query.logger.max.query.string.length</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Default is com.datastax.driver.core.QueryLogger.DEFAULT_MAX_QUERY_STRING.LENGTH.
-The maximum length of a CQL query string that can be logged verbatim by the cassandra driver</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandra.query.logger.max.logged.parameters</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Default is com.datastax.driver.core.QueryLogger.DEFAULT_MAX_LOGGED_PARAMETERS.
-The maximum number of query parameters that can be logged by the cassandra driver</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandra.query.logger.max.parameter.value.length</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Default is com.datastax.driver.core.QueryLogger.DEFAULT_MAX_PARAMETER_VALUE_LENGTH.
-The maximum length of query parameter value that can be logged by the cassandra driver</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandra.readTimeoutMillis</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional.
-If specified defines the Cassandra <a href="https://docs.datastax.com/en/developer/java-driver/3.5/manual/socket_options/">driver read timeout</a>.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandra.consistency_level.regular</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Allows specifying the driver default consistency level. Defaults to QUORUM.
-Allowed values: <a href="https://docs.datastax.com/en/cassandra-oss/3.x/cassandra/dml/dmlConfigConsistency.html">QUORUM, LOCAL_QUORUM, or EACH_QUORUM</a></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandra.consistency_level.lightweight_transaction</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Allows specifying the driver serial consistency level. Defaults to SERIAL.
-Allowed values: <a href="https://docs.datastax.com/en/cassandra-oss/3.x/cassandra/dml/dmlConfigConsistency.html">SERIAL or LOCAL_SERIAL</a></p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_pooling_options"><a class="anchor" href="#_pooling_options"></a>Pooling options</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Here are some properties for Pooling options:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre># Read com.datastax.driver.core.PoolingOptions for knowing defaults value
-# No value here will default to driver's default value
-
-# cassandra.pooling.local.max.connections=8
-# cassandra.pooling.local.max.requests=128
-## In ms. Should be higher than socket read timeout
-# cassandra.pooling.timeout=5000
-## In seconds.
-# cassandra.pooling.heartbeat.timeout=30
-# cassandra.pooling.max.queue.size=256</pre>
-</div>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 2. cassandra.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandra.pooling.local.max.connections</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 8.
-If specified defines the Cassandra
-<a href="https://docs.datastax.com/en/developer/java-driver/3.5/manual/pooling/#pool-size">maximum number of connections to hosts</a>
-(remote and local).</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandra.pooling.local.max.requests</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 128.
-If specified defines the Cassandra
-<a href="https://docs.datastax.com/en/developer/java-driver/3.5/manual/pooling/">maximum number of concurrent requests per connection</a>.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandra.pooling.timeout</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 5000 (ms).
-If specified defines the Cassandra
-<a href="https://docs.datastax.com/en/developer/java-driver/3.5/manual/pooling/#acquisition-queue">timeout for waiting in the pool queue</a>.
-Should be higher than sockets timeout.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandra.pooling.heartbeat.timeout</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 30 (s).
-If specified defines the Cassandra
-<a href="https://docs.datastax.com/en/developer/java-driver/3.5/manual/pooling/#heartbeat">heartbeat timeout</a>.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cassandra.pooling.max.queue.size</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 256.
-If specified defines the Cassandra
-<a href="https://docs.datastax.com/en/developer/java-driver/3.5/manual/pooling/#acquisition-queue">maximum size of the connection pool queue</a>.</p></td>
-</tr>
-</tbody>
-</table>
-<div class="paragraph">
-<p>If you want more explanation about Cassandra configuration, you should visit the dedicated <a href="https://docs.datastax.com/en/developer/java-driver/3.9">documentation</a>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_cassandra_mailbox_configuration"><a class="anchor" href="#_cassandra_mailbox_configuration"></a>Cassandra Mailbox Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p><strong>cassandra.properties</strong> file furthermore expose some options to tune the Cassandra Mailbox behaviour.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 3. cassandra.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailbox.read.repair.chance</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 0.1 (10% chance).
-Must be between 0 and 1 (inclusive). Controls the probability of doing a read-repair upon mailbox read.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailbox.read.repair.chance</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 0.1 (10% chance).
-Must be between 0 and 1 (inclusive). Controls the probability of doing a read-repair upon mailbox read.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailbox.counters.read.repair.chance.max</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 0.1 (10% chance).
-Must be between 0 and 1 (inclusive). Controls the probability of doing a read-repair upon mailbox counters read.
-Formula: read_repair_chance = min(mailbox.counters.read.repair.chance.max, (100/unseens)*mailbox.counters.read.repair.chance.one.hundred)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailbox.counters.read.repair.chance.one.hundred</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 0.01 (1% chance).
-Must be between 0 and 1 (inclusive). Controls the probability of doing a read-repair upon mailbox counters read.
-Formula: read_repair_chance = min(mailbox.counters.read.repair.chance.max, (100/unseens)*mailbox.counters.read.repair.chance.one.hundred)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailbox.max.retry.acl</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 1000.
-Controls the number of retries upon Cassandra ACL updates.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailbox.max.retry.modseq</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 100000.
-Controls the number of retries upon Cassandra ModSeq generation.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailbox.max.retry.uid</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 100000.
-Controls the number of retries upon Cassandra Uid generation.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailbox.max.retry.message.flags.update</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 1000.
-Controls the number of retries upon Cassandra flags update, in MessageMapper.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailbox.max.retry.message.id.flags.update</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 1000.
-Controls the number of retries upon Cassandra flags update, in MessageIdMapper.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">fetch.advance.row.count</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 1000.
-Controls the number of remaining rows we should wait before prefetch when paging.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">chunk.size.message.read</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 100.
-Controls the number of messages to be retrieved in parallel.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailbox.blob.part.size</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 102400 (100KB).
-Controls the size of blob parts used to store messages in the Cassandra blobStore.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">message.read.strong.consistency</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Boolean, defaults to true. Disabling should be considered experimental.
-If enabled, regular consistency level is used for read transactions for message. This might result
-in stale reads as the system.paxos table will not be checked for latest updates. Better performance are expected
-by turning it off. Note that reads performed as part of write transactions are always performed with a strong
-consistency.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/configure/collecting-contacts.html b/james-project/3.6.0/servers/distributed/configure/collecting-contacts.html
deleted file mode 100644
index 4c5cb79..0000000
--- a/james-project/3.6.0/servers/distributed/configure/collecting-contacts.html
+++ /dev/null
@@ -1,602 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Contact collection :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item is-current-page" data-depth="5">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Extensions</li>
- <li><a href="collecting-contacts.html">Contact collection</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="collecting-contacts.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/configure/collecting-contacts.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Contact collection</h1>
-<div class="sect1">
-<h2 id="_motivation"><a class="anchor" href="#_motivation"></a>Motivation</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Many modern applications combines email and contacts.</p>
-</div>
-<div class="paragraph">
-<p>We want recipients of emails sent by a user to automatically be added to this user contacts, for convenience. This
-should even be performed when a user sends emails via SMTP for example using thunderbird.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_design"><a class="anchor" href="#_design"></a>Design</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The idea is to send AMQP messages holding information about mail envelope for a traitment via a tierce application.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_configuration"><a class="anchor" href="#_configuration"></a>Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>We can achieve this goal by combining simple mailets building blocks.</p>
-</div>
-<div class="paragraph">
-<p>Here is a sample pipeline achieving aforementioned objectives :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="SenderIsLocal" class="ContactExtractor">
- <attribute>extractedContacts</attribute>
-</mailet>
-<mailet match="All" class="AmqpForwardAttribute">
- <uri>amqp://${env:JAMES_AMQP_USERNAME}:${env:JAMES_AMQP_PASSWORD}@${env:JAMES_AMQP_HOST}:${env:JAMES_AMQP_PORT}</uri>
- <exchange>collector:email</exchange>
- <attribute>extractedContacts</attribute>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>A sample message looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "userEmail": "sender@james.org",
- "emails": ["to@james.org"]
-}</pre>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/configure/collecting-events.html b/james-project/3.6.0/servers/distributed/configure/collecting-events.html
deleted file mode 100644
index b7ba81b..0000000
--- a/james-project/3.6.0/servers/distributed/configure/collecting-events.html
+++ /dev/null
@@ -1,636 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Event collection :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item is-current-page" data-depth="5">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Extensions</li>
- <li><a href="collecting-events.html">Event collection</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="collecting-events.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/configure/collecting-events.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Event collection</h1>
-<div class="sect1">
-<h2 id="_motivation"><a class="anchor" href="#_motivation"></a>Motivation</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Many calendar application do add events invitation received by email directly in ones calendar.</p>
-</div>
-<div class="paragraph">
-<p>Such behaviours requires the calendar application to be aware of the ICalendar related emails a user received.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_design"><a class="anchor" href="#_design"></a>Design</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The idea is to write a portion of mailet pipeline extracting Icalendar attachments and to hold them as attachments that
-can later be sent to other applications over AMQP to be treated in an asynchronous, decoupled fashion.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_configuration"><a class="anchor" href="#_configuration"></a>Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>We can achieve this goal by combining simple mailets building blocks.</p>
-</div>
-<div class="paragraph">
-<p>Here is a sample pipeline achieving aforementioned objectives :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><!-- ICAL pipeline -->
-<mailet match="All" class="StripAttachment">
- <mimeType>text/calendar</mimeType>
- <attribute>rawIcalendar</attribute>
-</mailet>
-<mailet match="All" class="MimeDecodingMailet">
- <attribute>rawIcalendar</attribute>
-</mailet>
-<mailet match="All" class="ICalendarParser">
- <sourceAttribute>rawIcalendar</sourceAttribute>
- <destinationAttribute>icalendar</destinationAttribute>
-</mailet>
-<mailet match="All" class="ICALToHeader">
- <attribute>icalendar</attribute>
-</mailet>
-<mailet match="All" class="ICALToJsonAttribute">
- <source>icalendar</source>
- <destination>icalendarAsJson</destination>
- <rawSource>rawIcalendar</rawSource>
-</mailet>
-<mailet match="All" class="AmqpForwardAttribute">
- <uri>amqp://${env:JAMES_AMQP_USERNAME}:${env:JAMES_AMQP_PASSWORD}@${env:JAMES_AMQP_HOST}:${env:JAMES_AMQP_PORT}</uri>
- <exchange>james:events</exchange>
- <attribute>icalendarAsJson</attribute>
-</mailet>
-<!-- End of ICAL pipeline --></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>A sample message looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "ical": "RAW_DATA_AS_TEXT_FOLLOWING_ICS_FORMAT",
- "sender": "other@james.apache.org",
- "recipient": "any@james2.apache.org",
- "replyTo": "other@james.apache.org",
- "uid": "f1514f44bf39311568d640727cff54e819573448d09d2e5677987ff29caa01a9e047feb2aab16e43439a608f28671ab7c10e754ce92be513f8e04ae9ff15e65a9819cf285a6962bc",
- "dtstamp": "20170106T115036Z",
- "method": "REQUEST",
- "sequence": "0",
- "recurrence-id": null
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The following pipeline positions the X-MEETING-UID in the Header in order for mail user agent to correlate events with this mail.
-The sample look like:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">X-MEETING-UID: f1514f44bf39311568d640727cff54e819573448d09d2e5677987ff29caa01a9e047feb2aab16e43439a608f28671ab7c10e754ce92be513f8e04ae9ff15e65a9819cf285a6962bc</code></pre>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/configure/dns.html b/james-project/3.6.0/servers/distributed/configure/dns.html
deleted file mode 100644
index 86f7220..0000000
--- a/james-project/3.6.0/servers/distributed/configure/dns.html
+++ /dev/null
@@ -1,622 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — dnsservice.xml :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item is-current-page" data-depth="5">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Core components</li>
- <li><a href="dns.html">dnsservice.xml</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="dns.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/configure/dns.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — dnsservice.xml</h1>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/dnsservice.xml">example</a>
-to get some examples and hints.</p>
-</div>
-<div class="paragraph">
-<p>Specifies DNS Server information for use by various components inside Apache James Server.</p>
-</div>
-<div class="paragraph">
-<p>DNS Transport services are controlled by a configuration block in
-the dnsservice.xml. This block affects SMTP remote delivery.</p>
-</div>
-<div class="paragraph">
-<p>The dnsservice tag defines the boundaries of the configuration
-block. It encloses all the relevant configuration for the DNS server.
-The behavior of the DNS service is controlled by the attributes and
-children of this tag.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. dnsservice.xml content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">servers</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Information includes a list of DNS Servers to be used by James. These are
-specified by the server elements, each of which is a child element of the
-servers element. Each server element is the IP address of a single DNS server.
-The server elements can have multiple server children. Enter ip address of your DNS server, one IP address per server
-element. If no DNS servers are found and you have not specified any below, 127.0.0.1 will be used</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">autodiscover</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false - If you use autodiscover and add DNS servers manually a combination of all the DNS servers will be used.
-If autodiscover is true, James will attempt to autodiscover the DNS servers configured on your underlying system.
-Currently, this works if the OS has a unix-like /etc/resolv.xml,
-or the system is Windows based with ipconfig or winipcfg. Change autodiscover to false if you would like to turn off autodiscovery
-and set the DNS servers manually in the servers section</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">authoritative</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>true/false</strong> - This tag specifies whether or not
-to require authoritative (non-cached) DNS records; to only accept DNS responses that are
-authoritative for the domain. It is primarily useful in an intranet/extranet environment.
-This should always be <strong>false</strong> unless you understand the implications.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">maxcachesize</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Maximum number of entries to maintain in the DNS cache (typically 50000)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">negativeCacheTTL</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Sets the maximum length of time that negative records will be stored in the DNS negative cache in
-seconds (a negative record means the name has not been found in the DNS). Values for this cache
-can be positive meaning the time in seconds before retrying to resolve the name, zero meaning no
-cache or a negative value meaning infinite caching.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">singleIPperMX</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false (default) - Specifies if Apache James Server must try a single server for each multihomed mx host</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">verbose</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Turn on general debugging statements</p></td>
-</tr>
-</tbody>
-</table>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/configure/domainlist.html b/james-project/3.6.0/servers/distributed/configure/domainlist.html
deleted file mode 100644
index 071f189..0000000
--- a/james-project/3.6.0/servers/distributed/configure/domainlist.html
+++ /dev/null
@@ -1,608 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — domainlist.xml :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item is-current-page" data-depth="5">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Core components</li>
- <li><a href="domainlist.html">domainlist.xml</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="domainlist.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/configure/domainlist.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — domainlist.xml</h1>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/domainlist.xml">example</a>
-to get some examples and hints.</p>
-</div>
-<div class="paragraph">
-<p>This configuration block is defined by the <strong>domainlist</strong> tag.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. domainlist.xml content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">domainnames</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Domainnames identifies the DNS namespace served by this instance of James.
-These domainnames are used for both matcher/mailet processing and SMTP auth
-to determine when a mail is intended for local delivery - Only applicable for XMLDomainList. The entries mentionned here will be created upon start.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">autodetect</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false - If autodetect is true, James wil attempt to discover its own host name AND
-use any explicitly specified servernames.
-If autodetect is false, James will use only the specified domainnames. Defaults to false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">autodetectIP</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false - If autodetectIP is not false, James will also allow add the IP address for each servername.
-The automatic IP detection is to support RFC 2821, Sec 4.1.3, address literals. Defaults to false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">defaultDomain</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the default domain which will be used if an email is send to a recipient without a domain part.
-If no defaultdomain is set the first domain of the DomainList gets used. If the default is not yet contained by the Domain List, the domain will be created upon start.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">read.cache.enable</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Experimental. Boolean, defaults to false.
-Whether or not to cache domainlist.contains calls. Enable a faster execution however writes will take time
-to propagate.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">read.cache.expiracy</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Experimental. String (duration), defaults to 10 seconds (10s). Supported units are ms, s, m, h, d, w, month, y.
-Expiracy of the cache. Longer means less reads are performed to the backend but writes will take longer to propagate.
-Low values (a few seconds) are advised.</p></td>
-</tr>
-</tbody>
-</table>
-<div class="paragraph">
-<p>To override autodetected domainnames simply add explicit domainname elements.
-In most cases this will be necessary. By default, the domainname 'localhost' is specified. This can be removed, if required.</p>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/configure/dsn.html b/james-project/3.6.0/servers/distributed/configure/dsn.html
deleted file mode 100644
index 81e5464..0000000
--- a/james-project/3.6.0/servers/distributed/configure/dsn.html
+++ /dev/null
@@ -1,810 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Delivery Submission Notifications :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item is-current-page" data-depth="5">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Extensions</li>
- <li><a href="dsn.html">ESMTP DSN support</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="dsn.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/configure/dsn.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Delivery Submission Notifications</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>DSN introduced in <a href="https://tools.ietf.org/html/rfc3461">RFC-3461</a> allows a SMTP sender to demand status messages,
-defined in <a href="https://tools.ietf.org/html/rfc3464">RFC-3464</a> to be sent back to the <code>Return-Path</code> upon delivery
-progress.</p>
-</div>
-<div class="paragraph">
-<p>DSN support is not enabled by default, as it needs specific configuration of the
-<a href="mailetcontainer.html" class="xref page">mailetcontainer.xml</a> to be specification compliant.</p>
-</div>
-<div class="paragraph">
-<p>To enable it you need to:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Add DSN SMTP hooks as part of the SMTP server stack</p>
-</li>
-<li>
-<p>Configure <a href="mailetcontainer.html" class="xref page">mailetcontainer.xml</a> to generate DSN bounces when needed</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_enabling_dsn_in_smtp_server_stack"><a class="anchor" href="#_enabling_dsn_in_smtp_server_stack"></a>Enabling DSN in SMTP server stack</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>For this simply add the <code>DSN hooks</code> in the handler chain in <code>smtpserver.xml</code> :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><smtpserver enabled="true">
- <...> <!-- The rest of your SMTP configuration, unchanged -->
- <handlerchain>
- <handler class="org.apache.james.smtpserver.dsn.DSNEhloHook"/>
- <handler class="org.apache.james.smtpserver.dsn.DSNMailParameterHook"/>
- <handler class="org.apache.james.smtpserver.dsn.DSNRcptParameterHook"/>
- <handler class="org.apache.james.smtpserver.dsn.DSNMessageHook"/>
- <...> <!-- other handlers, like: -->
- <handler class="org.apache.james.smtpserver.CoreCmdHandlerLoader"/> <!-- for instance -->
- </handlerchain>
-</smtpserver></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_enabling_dsn_generation_as_part_of_mail_processing"><a class="anchor" href="#_enabling_dsn_generation_as_part_of_mail_processing"></a>Enabling DSN generation as part of mail processing</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>For the below conditions to be matched we assume you follow
-<a href="remote-delivery-error-handling.html" class="xref page">RemoteDelivery error handling for MXs</a>, which is a
-requirement for detailed RemoteDelivery error and delay handling on top of the Distributed server.</p>
-</div>
-<div class="paragraph">
-<p>Here is a sample <a href="mailetcontainer.html" class="xref page">mailetcontainer.xml</a> achieving the following DSN generation:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Generate a generic <code>delivered</code> notification if LocalDelivery succeeded, if requested</p>
-</li>
-<li>
-<p>Generate a generic <code>failed</code> notification in case of local errors, if requested</p>
-</li>
-<li>
-<p>Generate a specific <code>failed</code> notification in case of a non existing local user, if requested</p>
-</li>
-<li>
-<p>Generate a specific <code>failed</code> notification in case of an address rewriting loop, if requested</p>
-</li>
-<li>
-<p>Generate a <code>failed</code> notification in case of remote permanent errors, if requested. We blame the remote server…​</p>
-</li>
-<li>
-<p>Generate a <code>delayed</code> notification in case of temporary remote errors we are about to retry, if requested. We blame the remote server…​</p>
-</li>
-<li>
-<p>Generate a <code>failed</code> notification in case of temporary remote errors we are not going to retry (failed too many time), if requested. We blame the remote server…​</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailetcontainer enableJmx="true">
- <!-- Common processing settings are unchanged -->
-
- <processors>
- <processor state="root" enableJmx="true">\
- <!-- Content of root processor is unchanged -->
- </processor>
-
- <processor state="transport" enableJmx="true">
- <!-- transport processor unchanged -->
- </processor>
-
- <processor state="error" enableJmx="true">
- <mailet match="DSNFailureRequested" class="DSNBounce">
- <prefix>[FAILED]</prefix>
- <passThrough>true</passThrough>
- <messageString>Hi. This is the James mail server at [machine].
-I'm afraid I wasn't able to deliver your message to the following addresses.
-This is a permanent error; I've given up. Sorry it didn't work out. Below
-I include the list of recipients, and the reason why I was unable to deliver
-your message.</messageString>
- <action>failed</action>
- <defaultStatus>5.0.0</defaultStatus>
- </mailet>
- <mailet match="All" class="ToRepository">
- <repositoryPath>cassandra://var/mail/error/</repositoryPath>
- </mailet>
- </processor>
-
- <processor state="local-delivery" enableJmx="true">
- <!-- Your local-delivery pipeline -->
- <mailet match="All" class="LocalDelivery">
- <!-- Do not abort the pipeline yet -->
- <consume>false</consume>
- </mailet>
- <!-- Tell the world we succeeded -->
- <mailet match="DSNSuccessRequested" class="DSNBounce">
- <prefix>[SUCCESS]</prefix>
- <passThrough>true</passThrough>
- <messageString>Hi. This is the James mail server at [machine].
-I successfully delivered your message to the following addresses.
-Note that it indicates your recipients received the message but do
-not imply they read it.</messageString>
- <action>delivered</action>
- <defaultStatus>2.0.0</defaultStatus>
- </mailet>
- <mailet match="All" class="Null"/> <!-- ignore people not having requesting a dsn success bounce -->
- </processor>
-
- <processor state="relay" enableJmx="true">
- <!-- Perform at most 5 RemoteDelivery attempts -->
- <mailet match="AtMost=5" class="RemoteDelivery">
- <outgoingQueue>outgoing</outgoingQueue>
- <maxRetries>0</maxRetries>
- <maxDnsProblemRetries>0</maxDnsProblemRetries>
- <deliveryThreads>10</deliveryThreads>
- <sendpartial>true</sendpartial>
- <!-- Use a custom processor for error handling -->
- <bounceProcessor>remote-delivery-error</bounceProcessor>
- </mailet>
- <!-- When retries are exceeded, consider the mail as a permanent failure -->
- <mailet match="DSNFailureRequested" class="DSNBounce">
- <prefix>[FAILED]</prefix>
- <passThrough>true</passThrough>
- <messageString>Hi. This is the James mail server at [machine].
-I'm afraid I wasn't able to deliver your message to the following addresses.
-This is a permanent error; I've given up. Sorry it didn't work out.
-The remote server we should relay this mail to keep on failing.
-Below I include the list of recipients, and the reason why I was unable to deliver
-your message.</messageString>
- <action>failed</action>
- <defaultStatus>5.0.0</defaultStatus>
- </mailet>
- <mailet match="All" class="ToRepository">
- <repositoryPath>cassandra://var/mail/error/remote-delivery/permanent/</repositoryPath>
- </mailet>
- </processor>
-
- <processor state="remote-delivery-error" enableJmx="true">
- <matcher name="dsn-permanent" match="org.apache.james.mailetcontainer.impl.matchers.And">
- <matcher match="IsRemoteDeliveryPermanentError"/>
- <matcher match="DSNFailureRequested"/>
- </matcher>
- <matcher name="dsn-temporary" match="org.apache.james.mailetcontainer.impl.matchers.And">
- <matcher match="IsRemoteDeliveryTemporaryError"/>
- <matcher match="DSNDelayRequested"/>
- </matcher>
-
- <mailet match="dsn-permanent" class="DSNBounce">
- <prefix>[FAILED]</prefix>
- <passThrough>true</passThrough>
- <messageString>Hi. This is the James mail server at [machine].
-I'm afraid I wasn't able to deliver your message to the following addresses.
-This is a permanent error; I've given up. Sorry it didn't work out.
-The remote server we should relay this mail to returns a permanent error.
-Below I include the list of recipients, and the reason why I was unable to deliver
-your message.</messageString>
- <action>failed</action>
- <defaultStatus>5.0.0</defaultStatus>
- </mailet>
-
- <mailet match="dsn-temporary" class="DSNBounce">
- <prefix>[DELAYED]</prefix>
- <passThrough>true</passThrough>
- <messageString>Hi. This is the James mail server at [machine].
-I'm afraid I wasn't able to deliver your message to the following addresses yet.
-This is a temporary error: I will keep on trying.
-Below I include the list of recipients, and the reason why I was unable to deliver
-your message.</messageString>
- <action>delayed</action>
- <defaultStatus>4.0.0</defaultStatus>
- </mailet>
-
- <!-- Error management for remote delivery error handling as described in remote-delivery-error-handling.adoc -->
- </processor>
-
- <processor state="local-address-error" enableJmx="true">
- <mailet match="DSNFailureRequested" class="DSNBounce">
- <prefix>[FAILED]</prefix>
- <passThrough>true</passThrough>
- <messageString>Hi. This is the James mail server at [machine].
-I'm afraid I wasn't able to deliver your message to the following addresses.
-This is a permanent error; I've given up. Sorry it didn't work out.
-The following addresses do not exist here. Sorry.</messageString>
- <action>failed</action>
- <defaultStatus>5.0.0</defaultStatus>
- </mailet>
- <mailet match="All" class="ToRepository">
- <repositoryPath>cassandra://var/mail/address-error/</repositoryPath>
- </mailet>
- </processor>
-
- <processor state="relay-denied" enableJmx="true">
- <!-- This is an abuse, you likely do not want to be polite with these people. we just keep a copy for later audit & replay -->
- <mailet match="All" class="ToRepository">
- <repositoryPath>cassandra://var/mail/relay-denied/</repositoryPath>
- <notice>Warning: You are sending an e-mail to a remote server. You must be authenticated to perform such an operation</notice>
- </mailet>
- </processor>
-
- <processor state="rrt-error" enableJmx="false">
- <mailet match="All" class="ToRepository">
- <repositoryPath>cassandra://var/mail/rrt-error/</repositoryPath>
- <passThrough>true</passThrough>
- </mailet>
- <mailet match="IsSenderInRRTLoop" class="Null"/>
- <mailet match="DSNFailureRequested" class="DSNBounce">
- <prefix>[FAILED]</prefix>
- <passThrough>true</passThrough>
- <messageString>Hi. This is the James mail server at [machine].
-I'm afraid I wasn't able to deliver your message to the following addresses.
-This is a permanent error; I've given up. Sorry it didn't work out.
-The following addresses is caught in a rewriting loop. An admin should come and fix it (you likely want to report it).
-Once resolved the admin should be able to resume the processing of your email.
-Below I include the list of recipients, and the reason why I was unable to deliver
-your message.</messageString>
- <action>failed</action>
- <defaultStatus>5.1.6/defaultStatus>
- </mailet>
- </processor>
- </processors>
-</mailetcontainer></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_limitations"><a class="anchor" href="#_limitations"></a>Limitations</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The out of the box tooling do not allow generating <code>relayed</code> DSN notification as RemoteDelivery misses a success
-callback.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/configure/elasticsearch.html b/james-project/3.6.0/servers/distributed/configure/elasticsearch.html
deleted file mode 100644
index 28495d3..0000000
--- a/james-project/3.6.0/servers/distributed/configure/elasticsearch.html
+++ /dev/null
@@ -1,869 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — elasticsearch.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item is-current-page" data-depth="5">
- <a class="nav-link" href="elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Storage dependencies</li>
- <li><a href="elasticsearch.html">elasticsearch.properties</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="elasticsearch.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/configure/elasticsearch.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — elasticsearch.properties</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/cassandra.properties">example</a>
-to get some examples and hints.</p>
-</div>
-<div class="paragraph">
-<p>If you want more explanation about ElasticSearch configuration, you should visit the dedicated <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/index.html">documentation</a>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_elasticsearch_configuration"><a class="anchor" href="#_elasticsearch_configuration"></a>ElasticSearch Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This file section is used to configure the connection tp an ElasticSearch cluster.</p>
-</div>
-<div class="paragraph">
-<p>Here are the properties allowing to do so :</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. elasticsearch.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">elasticsearch.clusterName</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Is the name of the cluster used by James.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">elasticsearch.nb.shards</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Number of shards for index provisionned by James</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">elasticsearch.nb.replica</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Number of replica for index provisionned by James (default: 0)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">elasticsearch.index.waitForActiveShards</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Wait for a certain number of active shard copies before proceeding with the operation. Defaults to 1.
-You may consult the <a href="https://www.elastic.co/guide/en/elasticsearch/reference/7.10/docs-index_.html#active-shards">documentation</a> for more information.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">elasticsearch.retryConnection.maxRetries</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Number of retries when connecting the cluster</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">elasticsearch.retryConnection.minDelay</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Minimum delay between connection attempts</p></td>
-</tr>
-</tbody>
-</table>
-<div class="sect2">
-<h3 id="_mailbox_search"><a class="anchor" href="#_mailbox_search"></a>Mailbox search</h3>
-<div class="paragraph">
-<p>The main use of ElasticSearch within the Distributed Server is indexing the mailbox content of users in order to enable
-powerful and efficient full-text search of the mailbox content.</p>
-</div>
-<div class="paragraph">
-<p>Data indexing is performed asynchronously in a reliable fashion via a MailboxListener.</p>
-</div>
-<div class="paragraph">
-<p>Here are the properties related to the use of ElasticSearch for Mailbox Search:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 2. elasticsearch.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">elasticsearch.index.mailbox.name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Name of the mailbox index backed by the alias. It will be created if missing.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">elasticsearch.index.name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Deprecated</strong> Use <strong>elasticsearch.index.mailbox.name</strong> instead.
-Name of the mailbox index backed by the alias. It will be created if missing.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">elasticsearch.alias.read.mailbox.name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Name of the alias to use by Apache James for mailbox reads. It will be created if missing.
-The target of the alias is the index name configured above.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">elasticsearch.alias.read.name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Deprecated</strong> Use <strong>elasticsearch.alias.read.mailbox.name</strong> instead.
-Name of the alias to use by Apache James for mailbox reads. It will be created if missing.
-The target of the alias is the index name configured above.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">elasticsearch.alias.write.mailbox.name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Name of the alias to use by Apache James for mailbox writes. It will be created if missing.
-The target of the alias is the index name configured above.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">elasticsearch.alias.write.name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Deprecated</strong> Use <strong>elasticsearch.alias.write.mailbox.name</strong> instead.
-Name of the alias to use by Apache James for mailbox writes. It will be created if missing.
-The target of the alias is the index name configured above.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">elasticsearch.indexAttachments</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Indicates if you wish to index attachments or not (default: true).</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="sect2">
-<h3 id="_quota_search"><a class="anchor" href="#_quota_search"></a>Quota search</h3>
-<div class="paragraph">
-<p>Users are indexed by quota usage, allowing operators a quick audit of users quota occupation.</p>
-</div>
-<div class="paragraph">
-<p>Users quota are asynchronously indexed upon quota changes via a dedicated MailboxListener.</p>
-</div>
-<div class="paragraph">
-<p>The following properties affect quota search :</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 3. elasticsearch.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">elasticsearch.index.quota.ratio.name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Specify the ElasticSearch alias name used for quotas</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">elasticsearch.alias.read.quota.ratio.name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Specify the ElasticSearch alias name used for reading quotas</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">elasticsearch.alias.write.quota.ratio.name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Specify the ElasticSearch alias name used for writing quotas</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="sect2">
-<h3 id="_disabling_elasticsearch"><a class="anchor" href="#_disabling_elasticsearch"></a>Disabling ElasticSearch</h3>
-<div class="paragraph">
-<p>ElasticSearch component can be disabled but consider it would make search feature to not work. In particular it will break JMAP protocol and SEARCH IMAP comment in an nondeterministic way.
-This is controlled in the <code>search.properties</code> file via the <code>implementation</code> property (defaults
-to <code>ElasticSearch</code>). Setting this configuration parameter to <code>scanning</code> will effectively disable ElasticSearch, no
-further indexation will be done however searches will rely on the scrolling search, leading to expensive and longer
-searches. Disabling ElasticSearch requires no extra action, however
-<a href="../operate/webadmin.html#reindexing_all_mails" class="xref page">a full re-indexing</a>needs to be carried out when enabling ElasticSearch.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_exporting_metrics_directly_to_elasticsearch"><a class="anchor" href="#_exporting_metrics_directly_to_elasticsearch"></a>Exporting metrics directly to ElasticSearch</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>For configuring the metric reporting on ElasticSearch :</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 4. elasticsearch.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">elasticsearch.http.host</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Host to report metrics on. Defaults to master host. Must be specified if metric export to ElasticSearch is enabled.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">elasticsearch.http.port</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Http port to use for publishing metrics. Must be specified if metric export to ElasticSearch is enabled.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">elasticsearch.metrics.reports.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Boolean value. Enables metrics reporting. Defaults to false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">elasticsearch.metrics.reports.period</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Seconds between metric reports. Defaults to 60 seconds.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">elasticsearch.metrics.reports.index</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Index to publish metrics on. Defaults to <code>james-metrics</code>.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_ssl_trusting_configuration"><a class="anchor" href="#_ssl_trusting_configuration"></a>SSL Trusting Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>By default James will use the system TrustStore to validate https server certificates, if the certificate on
-ES side is already in the system TrustStore, you can leave the sslValidationStrategy property empty or set it to default.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 5. elasticsearch.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">elasticsearch.hostScheme.https.sslValidationStrategy</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Accept only <strong>default</strong>, <strong>ignore</strong>, <strong>override</strong>. Default is <strong>default</strong>. default: Use the default SSL TrustStore of the system.
-ignore: Ignore SSL Validation check (not recommended).
-override: Override the SSL Context to use a custom TrustStore containing ES server’s certificate.</p></td>
-</tr>
-</tbody>
-</table>
-<div class="paragraph">
-<p>In some cases, you want to secure the connection from clients to ES by setting up a <strong>https</strong> protocol
-with a self signed certificate. And you prefer to left the system ca-certificates un touch.
-There are possible solutions to let the ES RestHighLevelClient to trust your self signed certificate.</p>
-</div>
-<div class="paragraph">
-<p>Second solution: importing a TrustStore containing the certificate into SSL context.
-A certificate normally contains two parts: a public part in .crt file, another private part in .key file.
-To trust the server, the client needs to be acknowledged that the server’s certificate is in the list of
-client’s TrustStore. Basically, you can create a local TrustStore file containing the public part of a remote server
-by execute this command:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>keytool -import -v -trustcacerts -file certificatePublicFile.crt -keystore trustStoreFileName.jks -keypass fillThePassword -storepass fillThePassword</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>When there is a TrustStore file and the password to read, fill two options <strong>trustStorePath</strong>
-and <strong>trustStorePassword</strong> with the TrustStore location and the password. ES client will accept
-the certificate of ES service.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 6. elasticsearch.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">elasticsearch.hostScheme.https.trustStorePath</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Use it when https is configured in elasticsearch.hostScheme, and sslValidationStrategy is <strong>override</strong>
-Configure Elasticsearch rest client to use this trustStore file to recognize nginx’s ssl certificate.
-Once you chose <strong>override</strong>, you need to specify both trustStorePath and trustStorePassword.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">elasticsearch.hostScheme.https.trustStorePassword</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Use it when https is configured in elasticsearch.hostScheme, and sslValidationStrategy is <strong>override</strong>
-Configure Elasticsearch rest client to use this trustStore file with the specified password.
-Once you chose <strong>override</strong>, you need to specify both trustStorePath and trustStorePassword.</p></td>
-</tr>
-</tbody>
-</table>
-<div class="paragraph">
-<p>During SSL handshaking, the client can determine whether accept or reject connecting to a remote server by its hostname.
-You can configure to use which HostNameVerifier in the client.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 7. elasticsearch.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">elasticsearch.hostScheme.https.hostNameVerifier</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Default is <strong>default</strong>. default: using the default hostname verifier provided by apache http client.
-accept_any_hostname: accept any host (not recommended).</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/configure/extensions.html b/james-project/3.6.0/servers/distributed/configure/extensions.html
deleted file mode 100644
index e53cf3d..0000000
--- a/james-project/3.6.0/servers/distributed/configure/extensions.html
+++ /dev/null
@@ -1,582 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — extensions.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item is-current-page" data-depth="5">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Extensions</li>
- <li><a href="extensions.html">extensions.properties</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="extensions.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/configure/extensions.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — extensions.properties</h1>
-<div class="paragraph">
-<p>This files enables an operator to define additional bindings used to instanciate others extensions</p>
-</div>
-<div class="paragraph">
-<p><strong>guice.extension.module</strong>: come separated list of fully qualified class name. These classes needs to implement Guice modules.</p>
-</div>
-<div class="paragraph">
-<p>Here is an exemple of such a class :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>public class MyServiceModule extends AbstractModule {
- @Override
- protected void configure() {
- bind(MyServiceImpl.class).in(Scopes.SINGLETON);
- bind(MyService.class).to(MyServiceImpl.class);
- }
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Recording it in extensions.properties :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>guice.extension.module=com.project.MyServiceModule</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Enables to inject MyService into your extensions.</p>
-</div>
-<div class="paragraph">
-<p>Read <a href="../extending/index.html#_defining_custom_injections_for_your_extensions" class="xref page">this page</a> for more details.</p>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/configure/healthcheck.html b/james-project/3.6.0/servers/distributed/configure/healthcheck.html
deleted file mode 100644
index ddb3ecc..0000000
--- a/james-project/3.6.0/servers/distributed/configure/healthcheck.html
+++ /dev/null
@@ -1,574 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — healthcheck.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item is-current-page" data-depth="5">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Core components</li>
- <li><a href="healthcheck.html">healthcheck.properties</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="healthcheck.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/configure/healthcheck.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — healthcheck.properties</h1>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/healthcheck.properties">example</a>
-to get some examples and hints.</p>
-</div>
-<div class="paragraph">
-<p>Use this configuration to define the initial delay and period for the PeriodicalHealthChecks. It is only applicable with Guice products.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. healthcheck.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">healthcheck.period</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Define the period between two periodical health checks (default: 60s). Units supported are (ms - millisecond, s - second, m - minute, h - hour, d - day). Default unit is millisecond.</p></td>
-</tr>
-</tbody>
-</table>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/configure/imap.html b/james-project/3.6.0/servers/distributed/configure/imap.html
deleted file mode 100644
index f14eade..0000000
--- a/james-project/3.6.0/servers/distributed/configure/imap.html
+++ /dev/null
@@ -1,662 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — imapserver.xml :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="5">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Protocols</li>
- <li><a href="imap.html">imapserver.xml</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="imap.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/configure/imap.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — imapserver.xml</h1>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/imapserver.xml">example</a>
-to get some examples and hints.</p>
-</div>
-<div class="paragraph">
-<p>The IMAP4 service is controlled by a configuration block in the imap4server.xml.
-The imap4server tag defines the boundaries of the configuration block. It encloses
-all the relevant configuration for the IMAP4 server. The behavior of the IMAP4 service is
-controlled by the attributes and children of this tag.</p>
-</div>
-<div class="paragraph">
-<p>This tag has an optional boolean attribute - <strong>enabled</strong> - that defines whether the service is active or not.
-The value defaults to "true" if not present.</p>
-</div>
-<div class="paragraph">
-<p>The standard children of the imapserver tag are:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. imapserver.xml content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">bind</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure this to bind to a specific inetaddress. This is an optional integer value. This value is the port on which this IMAP4 server is configured
-to listen. If the tag or value is absent then the service
-will bind to all network interfaces for the machine If the tag or value is omitted, the value will default to the standard IMAP4 port
-port 143 is the well-known/IANA registered port for IMAP
-port 993 is the well-known/IANA registered port for IMAPS ie over SSL/TLS</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connectionBacklog</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Number of connection backlog of the server (maximum number of queued connection requests)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">compress</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false - Use or don’t use COMPRESS extension. Defaults to false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">maxLineLength</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Maximal allowed line-length before a BAD response will get returned to the client
-This should be set with caution as a to high value can make the server a target for DOS (Denial of Service)!</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">inMemorySizeLimit</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">10MB size limit before we will start to stream to a temporary file</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">plainAuthDisallowed</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Whether or not to enable Authentication PLAIN if the connection is not encrypted via SSL or STARTTLS</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">timeout</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Default to 30 minutes. After this time, inactive channels that have not performed read, write, or both operation for a while
-will be closed. Negative value disable this behaviour.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">enableIdle</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Default to true. If enabled IDLE commands will generate a server heartbeat on a regular period.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">idleTimeInterval</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Defaults to 120. Needs to be a strictly positive integer.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">idleTimeIntervalUnit</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Default to SECONDS. Needs to be a parseable TimeUnit.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">disabledCaps</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Implemented server capabilities NOT to advertise to the client. Coma separated list. Defaults to no disabled capabilities.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jmxName</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The name given to the configuration</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tls</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set to true to support STARTTLS or SSL for the Socket.
-To use this you need to copy sunjce_provider.jar to /path/james/lib directory. To create a new keystore execute:
-<code>keytool -genkey -alias james -keyalg RSA -keystore /path/to/james/conf/keystore</code>.
-Please note that each IMAP server exposed on different port can specify its own keystore, independently from any other
-TLS based protocols.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">handler.helloName</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">This is the name used by the server to identify itself in the IMAP4
-protocol. If autodetect is TRUE, the server will discover its
-own host name and use that in the protocol. If discovery fails,
-the value of 'localhost' is used. If autodetect is FALSE, James
-will use the specified value.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connectiontimeout</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Connection timeout in seconds</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connectionLimit</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum simultaneous incoming connections for this service</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connectionLimitPerIP</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum simultaneous incoming connections per IP for this service</p></td>
-</tr>
-</tbody>
-</table>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/configure/index.html b/james-project/3.6.0/servers/distributed/configure/index.html
deleted file mode 100644
index 7f73efa..0000000
--- a/james-project/3.6.0/servers/distributed/configure/index.html
+++ /dev/null
@@ -1,716 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Configuration :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Configuration</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="index.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/configure/index.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Configuration</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This section presents how to configure the Distributed server.</p>
-</div>
-<div class="paragraph">
-<p>The Distributed Server relies on separated files for configuring various components. Some files follow an <strong>xml</strong> format
-and some others follow a <strong>property</strong> format. Some files can be ommited, in which case the functionality can be disabled,
-or rely on reasonable defaults.</p>
-</div>
-<div class="paragraph">
-<p>The following configuration files are exposed:</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_for_protocols"><a class="anchor" href="#_for_protocols"></a>For protocols</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>By omitting these files, the underlying protocols will be disabled.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="imap.html" class="xref page"><strong>imapserver.xml</strong></a> allows configuration for the IMAP protocol <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/imapserver.xml">example</a></p>
-</li>
-<li>
-<p><a href="jmap.html" class="xref page"><strong>jmap.properties</strong></a> allows to configure the JMAP protocol <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/jmap.properties">example</a></p>
-</li>
-<li>
-<p><a href="jmx.html" class="xref page"><strong>jmx.properties</strong></a> allows configuration of JMX being used by the Command Line Interface <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/jmx.properties">example</a></p>
-</li>
-<li>
-<p><a href="smtp.html#_lmtp_configuration" class="xref page"><strong>lmtpserver.xml</strong></a> allows configuring the LMTP protocol <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/lmtpserver.xml">example</a></p>
-</li>
-<li>
-<p><strong>managesieveserver.xml</strong> allows configuration for ManagedSieve (unsupported) <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/managesieveserver.xml">example</a></p>
-</li>
-<li>
-<p><a href="pop3.html" class="xref page"><strong>pop3server.xml</strong></a> allows configuration for the POP3 protocol (experimental) <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/pop3server.xml">example</a></p>
-</li>
-<li>
-<p><a href="smtp.html" class="xref page"><strong>smtpserver.xml</strong></a> allows configuration for the SMTP protocol <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/smtpserver.xml">example</a></p>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="smtp-hooks.html" class="xref page">This page</a> list SMTP hooks that can be used out of the box with the Distributed Server.</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p><a href="webadmin.html" class="xref page"><strong>webadmin.properties</strong></a> enables configuration for the WebAdmin protocol <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/webadmin.properties">example</a></p>
-</li>
-<li>
-<p><a href="ssl.html" class="xref page">This page</a> details SSL & TLS configuration.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_for_storage_dependencies"><a class="anchor" href="#_for_storage_dependencies"></a>For storage dependencies</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Except specific documented cases, these files are required, at least to establish a connection with the storage components.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="blobstore.html" class="xref page"><strong>blobstore.properties</strong></a> allows to configure the BlobStore <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/blob.properties">example</a></p>
-</li>
-<li>
-<p><a href="cassandra.html" class="xref page"><strong>cassandra.properties</strong></a> allows to configure the Cassandra driver <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/cassandra.properties">example</a></p>
-</li>
-<li>
-<p><a href="elasticsearch.html" class="xref page"><strong>elasticsearch.properties</strong></a> allows to configure ElasticSearch driver <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/elasticsearch.properties">example</a></p>
-</li>
-<li>
-<p><a href="rabbitmq.html" class="xref page"><strong>rabbitmq.properties</strong></a> allows configuration for the RabbitMQ driver <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/rabbitmq.properties">example</a></p>
-</li>
-<li>
-<p><a href="tika.html" class="xref page"><strong>tika.properties</strong></a> allows configuring Tika as a backend for text extraction <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/tika.properties">example</a></p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_for_core_components"><a class="anchor" href="#_for_core_components"></a>For core components</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>By omitting these files, sane default values are used.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="batchsizes.html" class="xref page"><strong>batchsizes.properties</strong></a> allows to configure mailbox read batch sizes <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/batchsizes.properties">example</a></p>
-</li>
-<li>
-<p><a href="dns.html" class="xref page"><strong>dnsservice.xml</strong></a> allows to configure DNS resolution <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/dnsservice.xml">example</a></p>
-</li>
-<li>
-<p><a href="domainlist.html" class="xref page"><strong>domainlist.xml</strong></a> allows to configure Domain storage <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/domainlist.xml">example</a></p>
-</li>
-<li>
-<p><a href="healthcheck.html" class="xref page"><strong>healthcheck.properties</strong></a> allows to configure periodical healthchecks <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/healthcheck.properties">example</a></p>
-</li>
-<li>
-<p><a href="mailetcontainer.html" class="xref page"><strong>mailetcontainer.xml</strong></a> allows configuring mail processing <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/mailetcontainer.xml">example</a></p>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="mailets.html" class="xref page">This page</a> list matchers that can be used out of the box with the Distributed Server.</p>
-</li>
-<li>
-<p><a href="matchers.html" class="xref page">This page</a> list matchers that can be used out of the box with the Distributed Server.</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p><a href="mailrepositorystore.html" class="xref page"><strong>mailrepositorystore.xml</strong></a> enables registration of allowed MailRepository protcols and link them to MailRepository implementations <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/mailrepositorystore.xml">example</a></p>
-</li>
-<li>
-<p><a href="recipientrewritetable.html" class="xref page"><strong>recipientrewritetable.xml</strong></a> enables advanced configuration for the Recipient Rewrite Table component <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/recipientrewritetable.xml">example</a></p>
-</li>
-<li>
-<p><a href="usersrepository.html" class="xref page"><strong>usersrepository.xml</strong></a> allows configuration of user storage <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/usersrepository.xml">example</a></p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_for_extensions"><a class="anchor" href="#_for_extensions"></a>For extensions</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>By omitting these files, no extra behaviour is added.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="vault.html" class="xref page"><strong>deletedMessageVault.properties</strong></a> allows to configure the DeletedMessageVault <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/deletedMessageVault.properties">example</a></p>
-</li>
-<li>
-<p><a href="listeners.html" class="xref page"><strong>listeners.xml</strong></a> enables configuration of Mailbox Listeners <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/listeners.xml">example</a></p>
-</li>
-<li>
-<p><a href="extensions.html" class="xref page"><strong>extensions.properties</strong></a> allows to extend James behaviour by loading your extensions in it <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/extensions.properties">example</a></p>
-</li>
-<li>
-<p><a href="spam.html" class="xref page">This page</a> documents Anti-Spam setup with SpamAssassin.</p>
-</li>
-<li>
-<p><a href="remote-delivery-error-handling.html" class="xref page">This page</a> proposes a simple strategy for RemoteDelivery error handling.</p>
-</li>
-<li>
-<p><a href="collecting-contacts.html" class="xref page">This page</a> documents contact collection</p>
-</li>
-<li>
-<p><a href="collecting-events.html" class="xref page">This page</a> documents event collection</p>
-</li>
-<li>
-<p><a href="dsn.html" class="xref page">this page</a> specified how to support SMTP Delivery Submission Notification (<a href="https://tools.ietf.org/html/rfc3461">RFC-3461</a>)</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/configure/jmap.html b/james-project/3.6.0/servers/distributed/configure/jmap.html
deleted file mode 100644
index 2067d6f..0000000
--- a/james-project/3.6.0/servers/distributed/configure/jmap.html
+++ /dev/null
@@ -1,709 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — jmap.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item is-current-page" data-depth="5">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Protocols</li>
- <li><a href="jmap.html">jmap.properties</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="jmap.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/configure/jmap.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — jmap.properties</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p><a href="https://jmap.io/">JMAP</a> is intended to be a new standard for email clients to connect to mail
-stores. It therefore intends to primarily replace IMAP + SMTP submission. It is also designed to be more
-generic. It does not replace MTA-to-MTA SMTP transmission.</p>
-</div>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/jmap.properties">example</a>
-to get some examples and hints.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. jmap.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true/false. Governs whether JMAP should be enabled</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jmap.port</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Defaults to 80. The port this server will be listening on. This value must be a valid
-port, ranging between 1 and 65535 (inclusive)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tls.keystoreURL</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Keystore to be used for generating authentication tokens for password authentication mechanism.
-This should not be the same keystore than the ones used by TLS based protocols.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tls.secret</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Password used to read the keystore</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jwt.publickeypem.url</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. JWT tokens allow request to bypass authentication</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">url.prefix</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Configuration urlPrefix for JMAP routes.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Default value: <a href="http://localhost" class="bare">http://localhost</a>.</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">upload.max.size</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. Configuration max size Upload in new JMAP-RFC-8621.</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Default value: 30M. Supported units are B (bytes) K (KB) M (MB) G (GB).</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">view.email.query.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional boolean. Defaults to false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Should simple Email/query be resolved against a Cassandra projection, or should we resolve them against ElasticSearch?
-This enables a higher resilience, but the projection needs to be correctly populated.</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jmap.version.default</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional string. Defaults to draft. Allowed values: draft, rfc-8621.</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Which version of the JMAP protocol should be served when none supplied in the Accept header.
-Defaults to draft for legacy reasons (avoid breaking changes) but setting the value to
-rfc-8621 allow compatibility with other third party apps.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_wire_tapping"><a class="anchor" href="#_wire_tapping"></a>Wire tapping</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Enabling <strong>TRACE</strong> on <code>org.apache.james.jmap.wire</code> enables reactor-netty wiretap, logging of
-all incoming and outgoing requests, outgoing requests. This will log also potentially sensible information
-like authentication credentials.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_generating_a_jwt_key_pair"><a class="anchor" href="#_generating_a_jwt_key_pair"></a>Generating a JWT key pair</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The Distributed server enforces the use of RSA-SHA-256.</p>
-</div>
-<div class="paragraph">
-<p>One can use OpenSSL to generate a JWT key pair :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre># private key
-openssl genrsa -out rs256-4096-private.rsa 4096
-# public key
-openssl rsa -in rs256-4096-private.rsa -pubout > rs256-4096-public.pem</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The private key can be used to generate JWT tokens, for instance
-using <a href="https://github.com/vandium-io/jwtgen">jwtgen</a>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>jwtgen -a RS256 -p rs256-4096-private.rsa 4096 -c "sub=bob@domain.tld" -e 3600 -V</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>This token can then be passed as <code>Bearer</code> of the <code>Authorization</code> header :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -H "Authorization: Bearer $token" -XPOST http://127.0.0.1:80/jmap -d '...'</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The public key can be referenced as <code>jwt.publickeypem.url</code> of the <code>jmap.properties</code> configuration file.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_annotated_specification"><a class="anchor" href="#_annotated_specification"></a>Annotated specification</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The [annotated documentation](<a href="https://github.com/apache/james-project/tree/master/server/protocols/jmap-rfc-8621/doc/specs/spec" class="bare">https://github.com/apache/james-project/tree/master/server/protocols/jmap-rfc-8621/doc/specs/spec</a>)
-presents the limits of the JMAP RFC-8621 implementation part of the Apache James project. We furthermore implement
-[JSON Meta Application Protocol (JMAP) Subprotocol for WebSocket](<a href="https://tools.ietf.org/html/rfc8887" class="bare">https://tools.ietf.org/html/rfc8887</a>).</p>
-</div>
-<div class="paragraph">
-<p>Some methods / types are not yet implemented, some implementations are naive, and the PUSH is not supported yet.</p>
-</div>
-<div class="paragraph">
-<p>Users are invited to read these limitations before using actively the JMAP RFC-8621 implementation, and should ensure their
-client applications only uses supported operations.</p>
-</div>
-<div class="paragraph">
-<p>Contributions enhancing support are furthermore welcomed.</p>
-</div>
-<div class="paragraph">
-<p>The list of tested JMAP clients are:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>[OpenPaaS](<a href="https://open-paas.org/" class="bare">https://open-paas.org/</a>) is actively using the draft version of the JMAP implementation. Migration to
-RFC-8621 is planned.</p>
-</li>
-<li>
-<p>Experiments had been run on top of [LTT.RS](<a href="https://github.com/iNPUTmice/lttrs-android" class="bare">https://github.com/iNPUTmice/lttrs-android</a>). Version in the Accept
-headers needs to be explicitly set to <code>rfc-8621</code>. [Read more](<a href="https://github.com/linagora/james-project/pull/4089" class="bare">https://github.com/linagora/james-project/pull/4089</a>).</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/configure/jmx.html b/james-project/3.6.0/servers/distributed/configure/jmx.html
deleted file mode 100644
index 785229f..0000000
--- a/james-project/3.6.0/servers/distributed/configure/jmx.html
+++ /dev/null
@@ -1,586 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — jmx.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item is-current-page" data-depth="5">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Protocols</li>
- <li><a href="jmx.html">jmx.properties</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="jmx.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/configure/jmx.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — jmx.properties</h1>
-<div class="paragraph">
-<p>This is used to configure the JMX MBean server via which all management is achieved.</p>
-</div>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/jmx.properties">example</a>
-in GIT to get some examples and hints.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. jmx.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jmx.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Boolean. Should the JMX server be enabled? Defaults to <code>true</code>.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jmx.address</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The IP address (host name) the MBean Server will bind/listen to.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jmx.port</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The port number the MBean Server will bind/listen to.</p></td>
-</tr>
-</tbody>
-</table>
-<div class="paragraph">
-<p>To access from a remote location, it has been reported that <code>-Dcom.sun.management.jmxremote.ssl=false</code> is needed as
-a JVM argument.</p>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/configure/listeners.html b/james-project/3.6.0/servers/distributed/configure/listeners.html
deleted file mode 100644
index 418d6be..0000000
--- a/james-project/3.6.0/servers/distributed/configure/listeners.html
+++ /dev/null
@@ -1,797 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — listeners.xml :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item is-current-page" data-depth="5">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Extensions</li>
- <li><a href="listeners.html">listeners.xml</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="listeners.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/configure/listeners.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — listeners.xml</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>Distributed James relies on an event bus system to enrich mailbox capabilities. Each
-operation performed on the mailbox will trigger related events, that can
-be processed asynchronously by potentially any James node on a
-distributed system.</p>
-</div>
-<div class="paragraph">
-<p>Mailbox listeners can register themselves on this event bus system to be
-called when an event is fired, allowing to do different kind of extra
-operations on the system.</p>
-</div>
-<div class="paragraph">
-<p>Distributed James allows the user to register potentially user defined additional mailbox listeners.</p>
-</div>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/listener.xml">example</a>
-to get some examples and hints.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_configuration"><a class="anchor" href="#_configuration"></a>Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The <executeGroupListeners> controls whether to launch group mailbox listener consumption. Defaults to true. Use with caution:
-never disable on standalone james servers, and ensure at least some instances do consume group mailbox listeners within a
-clustered topology.</p>
-</div>
-<div class="paragraph">
-<p>Mailbox listener configuration is under the XML element <listener>.</p>
-</div>
-<div class="paragraph">
-<p>Some MailboxListener allows you to specify if you want to run them synchronously or asynchronously. To do so,
-for MailboxListener that supports this, you can use the <strong>async</strong> attribute (optional, per mailet default) to govern the execution mode.
-If <strong>true</strong> the execution will be scheduled in a reactor elastic scheduler. If <strong>false</strong>, the execution is synchronous.</p>
-</div>
-<div class="paragraph">
-<p>Already provided additional listeners are documented below.</p>
-</div>
-<div class="sect2">
-<h3 id="_spamassassinlistener"><a class="anchor" href="#_spamassassinlistener"></a>SpamAssassinListener</h3>
-<div class="paragraph">
-<p>Provides per user real-time HAM/SPAM feedback to a SpamAssassin server depending on user actions.</p>
-</div>
-<div class="paragraph">
-<p>This mailet is asynchronous by default, but this behaviour can be overridden by the <strong>async</strong>
-configuration property.</p>
-</div>
-<div class="paragraph">
-<p>This MailboxListener is supported.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><listeners>
- <!-- ... -->
- <listener>
- <class>org.apache.james.mailbox.spamassassin.SpamAssassinListener</class>
- </listener>
-</listeners></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Please note that a <code>spamassassin.properties</code> file is needed. Read also
-<a href="spam.html" class="xref page">this page</a> for extra configuration required to support this feature.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_mailboxoperationlogginglistener"><a class="anchor" href="#_mailboxoperationlogginglistener"></a>MailboxOperationLoggingListener</h3>
-<div class="paragraph">
-<p>Provides more insights on mailbox operationsby logging them.</p>
-</div>
-<div class="paragraph">
-<p>This MailboxListener is supported.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><listeners>
- <listener>
- <class>org.apache.james.mailbox.cassandra.MailboxOperationLoggingListener</class>
- </listener>
- <!-- ... -->
-</listeners></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_quotathresholdcrossinglistener"><a class="anchor" href="#_quotathresholdcrossinglistener"></a>QuotaThresholdCrossingListener</h3>
-<div class="paragraph">
-<p>Sends emails to users exceeding 80% and 99% of their quota to warn them (for instance).</p>
-</div>
-<div class="paragraph">
-<p>Here are the following properties you can configure:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. QuotaThresholdCrossingListener configuration properties</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Useful when configuring several time this listener. You might want to do so to use different rendering templates for
-different occupation thresholds.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">gracePeriod</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Period during which no more email for a given threshold should be sent.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">subjectTemplate</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Mustache template for rendering the subject of the warning email.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">bodyTemplate</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Mustache template for rendering the body of the warning email.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">thresholds</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Floating number between 0 and 1 representing the threshold of quota occupation from which a mail should be sent.
-Configuring several thresholds is supported.</p></td>
-</tr>
-</tbody>
-</table>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><listeners>
- <!-- ... -->
- <listener>
- <class>org.apache.james.mailbox.quota.mailing.listeners.QuotaThresholdCrossingListener</class>
- <group>QuotaThresholdCrossingListener-upper-threshold</group>
- <configuration>
- <thresholds>
- <threshold>
- <value>0.8</value>
- </threshold>
- </thresholds>
- <name>thirst</name>
- <subjectTemplate>conf://templates/QuotaThresholdMailSubject.mustache</subjectTemplate>
- <bodyTemplate>conf://templates/QuotaThresholdMailBody.mustache</bodyTemplate>
- <gracePeriod>1week/</gracePeriod>
- </configuration>
- </listener>
-</listeners></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Here are examples of templates you can use:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>For subject template: <code>conf://templates/QuotaThresholdMailSubject.mustache</code></p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>Warning: Your email usage just exceeded a configured threshold</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>For body template: <code>conf://templates/QuotaThresholdMailBody.mustache</code></p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>You receive this email because you recently exceeded a threshold related to the quotas of your email account.
-
-{{#hasExceededSizeThreshold}}
-You currently occupy more than {{sizeThreshold}} % of the total size allocated to you.
-You currently occupy {{usedSize}}{{#hasSizeLimit}} on a total of {{limitSize}} allocated to you{{/hasSizeLimit}}.
-
-{{/hasExceededSizeThreshold}}
-{{#hasExceededCountThreshold}}
-You currently occupy more than {{countThreshold}} % of the total message count allocated to you.
-You currently have {{usedCount}} messages{{#hasCountLimit}} on a total of {{limitCount}} allowed for you{{/hasCountLimit}}.
-
-{{/hasExceededCountThreshold}}
-You need to be aware that actions leading to exceeded quotas will be denied. This will result in a degraded service.
-To mitigate this issue you might reach your administrator in order to increase your configured quota. You might also delete some non important emails.</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>This MailboxListener is supported.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_predeletionhook_configuration"><a class="anchor" href="#_predeletionhook_configuration"></a>PreDeletionHook configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Before deleting a message in James, this message and some related information about the deletion will be passed to a set of PreDeletionHook instances,
-This process is called notifying, and it acts sequentially. If the notifying process for all PreDeletionHooks finish successfully, then the message will be processed to be deleted.
-Otherwise, that message won’t be deleted.</p>
-</div>
-<div class="paragraph">
-<p>Pre Deletion Hook configuration is under the XML element <preDeletionHook></p>
-</div>
-<div class="paragraph">
-<p>Already provided additional pre deletion hooks includes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>org.apache.james.vault.DeletedMessageVaultHook</code>: Storing messages about being deleted into
-<code>org.apache.james.vault.DeletedMessageVault</code></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><listeners>
- <!-- ... -->
- <preDeletionHook>
- <class>org.apache.james.vault.DeletedMessageVaultHook</class>
- </preDeletionHook>
-</listeners></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Read also <a href="vault.html" class="xref page">this page</a> for extra configuration required to support this feature.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/configure/mailetcontainer.html b/james-project/3.6.0/servers/distributed/configure/mailetcontainer.html
deleted file mode 100644
index 910379b..0000000
--- a/james-project/3.6.0/servers/distributed/configure/mailetcontainer.html
+++ /dev/null
@@ -1,675 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — mailetcontainer.xml :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item is-current-page" data-depth="5">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Core components</li>
- <li><a href="mailetcontainer.html">mailetcontainer.xml</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="mailetcontainer.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/configure/mailetcontainer.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — mailetcontainer.xml</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This documents explains how to configure Mail processing. Mails pass through the MailetContainer. The
-MailetContainer is a Matchers (condition for executing a mailet) and Mailets (execution units that perform
-actions based on incoming mail) pipeline arranged into processors (List of mailet/matcher pairs allowing
-better logical organisation). You can read more about these concepts on
-<a href="#distributed/architecture.adoc#_mail_processing" class="xref unresolved">the mailet container feature description</a>.</p>
-</div>
-<div class="paragraph">
-<p>Apache James Server includes a number of <a href="mailets.html" class="xref page">Packaged Mailets</a> and
-<a href="matchers.html" class="xref page">Packaged Matchers</a>.</p>
-</div>
-<div class="paragraph">
-<p>Futhermore, you can write and use with James <a href="../extending/mail-processing.html" class="xref page">your own mailet and matchers</a>.</p>
-</div>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/mailetcontainer.xml">example</a>
-to get some examples and hints.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. mailetcontainer.xml content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">context.postmaster</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The body of this element is the address that the server
-will consider its postmaster address. This address will be listed as the sender address
-of all error messages that originate from James. Also, all messages addressed to
-postmaster@<servername>, where <servername> is one of the domain names whose
-mail is being handled by James, will be redirected to this email address.
-Set this to the appropriate email address for error reports
-If this is set to a non-local email address, the mail server
-will still function, but will generate a warning on startup.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">spooler.threads</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Number of simultaneous threads used to spool the mails. Set to zero, it disables mail processing - use with
-caution.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">spooler.errorRepository</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Mail repository to store email in after several unrecoverable errors. Mails failing processing, for which
-the Mailet Container could not handle Error, will be stored there after their processing had been attempted
-5 times. Note that if standard java Exception occurs, <strong>Error handling</strong> section below will be applied
-instead.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_the_mailet_tag"><a class="anchor" href="#_the_mailet_tag"></a>The Mailet Tag</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Consider the following simple <strong>mailet</strong> tag:</p></p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="RemoteAddrNotInNetwork=127.0.0.1" class="ToProcessor">
- <processor>spam</processor>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The mailet tag has two required attributes, <strong>match</strong> and <strong>class</strong>.</p>
-</div>
-<div class="paragraph">
-<p>The <strong>match</strong> attribute is set to the value of the specific Matcher class to be instantiated with a an
-optional argument. If present, the argument is separated from the Matcher class name by an '='. Semantic
-interpretation of the argument is left to the particular mailet.</p>
-</div>
-<div class="paragraph">
-<p>The <strong>class</strong> attribute is set to the value of the Mailet class that is to be instantiated.</p>
-</div>
-<div class="paragraph">
-<p>Finally, the children of the <strong>mailet</strong> tag define the configuration that is passed to the Mailet. The
-tags used in this section should have no attributes or children. The names and bodies of the elements will be passed to
-the mailet as (name, value) pairs.</p>
-</div>
-<div class="paragraph">
-<p>So in the example above, a Matcher instance of RemoteAddrNotInNetwork would be instantiated, and the value "127.0.0.1"
-would be passed to the matcher. The Mailet of the pair will be an instance of ToProcessor, and it will be passed the (name, value)
-pair of ("processor", "spam").</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_error_handling"><a class="anchor" href="#_error_handling"></a>Error handling</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>If an exception is encountered during the execution of a mailet or a matcher, the default behaviour is to
-process the mail using the <strong>error</strong> processor.</p>
-</div>
-<div class="paragraph">
-<p>The <strong>onMailetException</strong> property allows you to override this behaviour. You can specify another
-processor than the <strong>error</strong> one for handling the errors of this mailet. The <strong>ignore</strong> special value also
-allows to continue processing and ignore the error.</p>
-</div>
-<div class="paragraph">
-<p>Moreover, the <strong>onMatcherException</strong> allows you to override matcher error handling. You can
-specify another processor than the <strong>error</strong> one for handling the errors of this mailet. The <strong>matchall</strong>
-special value also allows you to match all recipients when there is an error. The <strong>nomatch</strong>
-special value also allows you to match no recipients when there is an error.</p>
-</div>
-<div class="paragraph">
-<p>Here is a short example to illustrate this:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match=RecipientIsLocal class="LocalDelivery">
- <onMailetException>deliveryError</onMailetException>
- <onMatcherException>nomatch</onMatcherException>
-</mailet></pre>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/configure/mailets.html b/james-project/3.6.0/servers/distributed/configure/mailets.html
deleted file mode 100644
index 64f636e..0000000
--- a/james-project/3.6.0/servers/distributed/configure/mailets.html
+++ /dev/null
@@ -1,3084 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Mailets :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item is-current-page" data-depth="5">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Core components</li>
- <li><a href="mailets.html">Packaged Mailets</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="mailets.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/configure/mailets.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Mailets</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This documentation page lists and documents Mailet that can be used within the
-Distributed Server MailetContainer in order to write your own mail processing logic with out-of-the-box components.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_supported_mailets"><a class="anchor" href="#_supported_mailets"></a>Supported mailets</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_adddeliveredtoheader"><a class="anchor" href="#_adddeliveredtoheader"></a>AddDeliveredToHeader</h3>
-<div class="paragraph">
-<p>This mailet adds the de-facto standard QMail Delivered-To header.</p>
-</div>
-<div class="paragraph">
-<p>Upon processing by LocalDelivery, a Delivered-To header matching the recipient mail address will be added before storage.</p>
-</div>
-<div class="paragraph">
-<p>Example</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="AddDeliveredToHeader"></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_addfooter"><a class="anchor" href="#_addfooter"></a>AddFooter</h3>
-<div class="paragraph">
-<p>Takes the message and attaches a footer message to it. Right now, it only
-supports simple messages. Needs to have additions to make it support
-messages with alternate content types or with attachments.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_addsubjectprefix"><a class="anchor" href="#_addsubjectprefix"></a>AddSubjectPrefix</h3>
-<div class="paragraph">
-<p>Add an prefix (tag) to the subject of a message <br></p>
-</div>
-<div class="paragraph">
-<p>Sample Configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="RecipientIs=robot@james.apache.org" class="TagMessage">
- <subjectPrefix>[robot]</subjectPrefix>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_amqpforwardattribute"><a class="anchor" href="#_amqpforwardattribute"></a>AmqpForwardAttribute</h3>
-<div class="paragraph">
-<p>This mailet forwards the attributes values to a AMPQ.</p>
-</div>
-<div class="paragraph">
-<p>It takes 4 parameters:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>attribute (mandatory): content to be forwarded, expected to be a Map<String, byte[]>
-where the byte[] content is issued from a MimeBodyPart.
-It is typically generated from the StripAttachment mailet.</p>
-</li>
-<li>
-<p>uri (mandatory): AMQP URI defining the server where to send the attachment.</p>
-</li>
-<li>
-<p>exchange (mandatory): name of the AMQP exchange.</p>
-</li>
-<li>
-<p>routing_key (optional, default to empty string): name of the routing key on this exchange.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This mailet will sent the data attached to the mail as an attribute holding a map.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_bounce"><a class="anchor" href="#_bounce"></a>Bounce</h3>
-<div class="paragraph">
-<p>Generates a response to the reverse-path address. Note that this is different
-than a mail-client’s reply, which would use the Reply-To or From header.</p>
-</div>
-<div class="paragraph">
-<p>Bounced messages are attached in their entirety (headers and content) and the
-resulting MIME part type is "message/rfc822".</p>
-</div>
-<div class="paragraph">
-<p>The reverse-path and the Return-Path header of the response is set to "null"
-("<>"), meaning that no reply should be sent.</p>
-</div>
-<div class="paragraph">
-<p>A sender of the notification message can optionally be specified. If one is
-not specified, the postmaster’s address will be used.</p>
-</div>
-<div class="paragraph">
-<p>A notice text can be specified, and in such case will be inserted into the
-notification inline text.</p>
-</div>
-<div class="paragraph">
-<p>If the notified message has an "error message" set, it will be inserted into
-the notification inline text. If the <strong>attachError</strong> init
-parameter is set to true, such error message will be attached to the
-notification message.</p>
-</div>
-<div class="paragraph">
-<p>Supports the <strong>passThrough</strong> init parameter (true if missing).</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="Bounce">
- <sender>*an address or postmaster or sender or unaltered, default=postmaster*</sender>
- <attachError>*true or false, default=false*</attachError>
- <message>*notice attached to the original message text (optional)*</message>
- <prefix>*optional subject prefix prepended to the original message*</prefix>
- <inline>*default=none*</inline>
- <attachment>*default=message*</attachment>
- <passThrough>*true or false, default=true*</passThrough>
- <fakeDomainCheck>*true or false, default=true*</fakeDomainCheck>
- <debug>*true or false, default=false*</debug>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The behaviour of this mailet is equivalent to using Resend with the following
-configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="Resend">
- <sender>*an address or postmaster or sender or unaltered*</sender>
- <attachError>*true or false*</attachError>
- <message>**dynamically built**</message>
- <prefix>*a string*</prefix>
- <passThrough>true or false</passThrough>
- <fakeDomainCheck>*true or false*</fakeDomainCheck>
- <recipients>*sender*</recipients>
- <reversePath>null</reversePath>
- <inline>see Resend</inline>
- <attachment>see Resend</attachment>
- <isReply>true</isReply>
- <debug>*true or false*</debug>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>notice</strong> and <strong>sendingAddress</strong> can be used instead of <strong>message</strong>
-and <strong>sender</strong>; such names are kept for backward compatibility.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_contactextractor"><a class="anchor" href="#_contactextractor"></a>ContactExtractor</h3>
-<div class="paragraph">
-<p>Collects the sender and the recipients of a message and store them as JSON in a
-specified message attribute.</p>
-</div>
-<div class="paragraph">
-<p>Here is the JSON format:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "userEmail" : "sender@james.org",
- "emails" : [ "to@james.org", "cc@james.org" ]
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="ContactExtractor">
- <attribute>ExtractedContacts</attribute>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_convertto7bit"><a class="anchor" href="#_convertto7bit"></a>ConvertTo7Bit</h3>
-<div class="paragraph">
-<p>Make sure the message stream is 7bit. Every 8bit part is encoded to
-quoted-printable or base64 and the message is saved.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_dkimsign"><a class="anchor" href="#_dkimsign"></a>DKIMSign</h3>
-<div class="paragraph">
-<p>This mailet sign a message using the DKIM protocol
-If the privateKey is encoded using a password then you can pass
-the password as privateKeyPassword parameter.</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration with inlined private key:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match=&quot;All&quot; class=&quot;DKIMSign&quot;>
- <signatureTemplate>v=1; s=selector; d=example.com; h=from:to:received:received; a=rsa-sha256; bh=; b=;</signatureTemplate>
- <privateKey>
- -----BEGIN RSA PRIVATE KEY-----
- MIICXAIBAAKBgQDYDaYKXzwVYwqWbLhmuJ66aTAN8wmDR+rfHE8HfnkSOax0oIoT
- M5zquZrTLo30870YMfYzxwfB6j/Nz3QdwrUD/t0YMYJiUKyWJnCKfZXHJBJ+yfRH
- r7oW+UW3cVo9CG2bBfIxsInwYe175g9UjyntJpWueqdEIo1c2bhv9Mp66QIDAQAB
- AoGBAI8XcwnZi0Sq5N89wF+gFNhnREFo3rsJDaCY8iqHdA5DDlnr3abb/yhipw0I
- /1HlgC6fIG2oexXOXFWl+USgqRt1kTt9jXhVFExg8mNko2UelAwFtsl8CRjVcYQO
- cedeH/WM/mXjg2wUqqZenBmlKlD6vNb70jFJeVaDJ/7n7j8BAkEA9NkH2D4Zgj/I
- OAVYccZYH74+VgO0e7VkUjQk9wtJ2j6cGqJ6Pfj0roVIMUWzoBb8YfErR8l6JnVQ
- bfy83gJeiQJBAOHk3ow7JjAn8XuOyZx24KcTaYWKUkAQfRWYDFFOYQF4KV9xLSEt
- ycY0kjsdxGKDudWcsATllFzXDCQF6DTNIWECQEA52ePwTjKrVnLTfCLEG4OgHKvl
- Zud4amthwDyJWoMEH2ChNB2je1N4JLrABOE+hk+OuoKnKAKEjWd8f3Jg/rkCQHj8
- mQmogHqYWikgP/FSZl518jV48Tao3iXbqvU9Mo2T6yzYNCCqIoDLFWseNVnCTZ0Q
- b+IfiEf1UeZVV5o4J+ECQDatNnS3V9qYUKjj/krNRD/U0+7eh8S2ylLqD3RlSn9K
- tYGRMgAtUXtiOEizBH6bd/orzI9V9sw8yBz+ZqIH25Q=
- -----END RSA PRIVATE KEY-----
- </privateKey>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Sample configuration with file-provided private key:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match=&quot;All&quot; class=&quot;DKIMSign&quot;>
- <signatureTemplate>v=1; s=selector; d=example.com; h=from:to:received:received; a=rsa-sha256; bh=; b=;</signatureTemplate>
- <privateKeyFilepath>dkim-signing.pem</privateKeyFilepath>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>By default the mailet assume that Javamail will convert LF to CRLF when sending
-so will compute the hash using converted newlines. If you don’t want this
-behaviour then set forceCRLF attribute to false.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_dkimverify"><a class="anchor" href="#_dkimverify"></a>DKIMVerify</h3>
-<div class="paragraph">
-<p>This mailet verify a message using the DKIM protocol</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="DKIMVerify">
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>By default the mailet assume that Javamail will use LF instead of CRLF
-so it will verify the hash using converted newlines. If you don’t want this
-behaviour then set forceCRLF attribute to false.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_dsnbounce"><a class="anchor" href="#_dsnbounce"></a>DSNBounce</h3>
-<div class="paragraph">
-<p>Generates a Delivery Status Notification (DSN) Note that this is different
-than a mail-client’s reply, which would use the Reply-To or From header.</p>
-</div>
-<div class="paragraph">
-<p>Bounced messages are attached in their entirety (headers and content) and the
-resulting MIME part type is "message/rfc822".</p>
-</div>
-<div class="paragraph">
-<p>The reverse-path and the Return-Path header of the response is set to "null"
-("<>"), meaning that no reply should be sent.</p>
-</div>
-<div class="paragraph">
-<p>A sender of the notification message can optionally be specified. If one is
-not specified, the postmaster’s address will be used.</p>
-</div>
-<div class="paragraph">
-<p>Supports the <code>passThrough</code> init parameter (true if missing).</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="DSNBounce">
- <sender>*an address or postmaster or sender or unaltered, default=postmaster*</sender>
- <prefix>*optional subject prefix prepended to the original message*</prefix>
- <attachment>*message, heads or none, default=message*</attachment>
- <messageString>*the message sent in the bounce, the first occurrence of the pattern [machine] is replaced with the name of the executing machine, default=Hi. This is the James mail server at [machine] ... *</messageString>
- <passThrough>*true or false, default=true*</passThrough>
- <debug>*true or false, default=false*</debug>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_extractmdnoriginaljmapmessageid"><a class="anchor" href="#_extractmdnoriginaljmapmessageid"></a>ExtractMDNOriginalJMAPMessageId</h3>
-<div class="paragraph">
-<p>This mailet handles MDN messages and define a header X-JAMES-MDN-JMAP-MESSAGE-ID referencing
-the original message (by its Jmap Id) asking for the recipient to send an MDN.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_forward"><a class="anchor" href="#_forward"></a>Forward</h3>
-<div class="paragraph">
-<p>Replaces incoming recipients with those specified, and resends the message
-unaltered.</p>
-</div>
-<div class="paragraph">
-<p>Can be totally replaced by an equivalent usage of {@link Resend} (see below),
-simply replacing <strong><forwardto></strong> with <strong><recipients></strong>.</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="Forward">
- <forwardTo>*comma delimited list of email addresses*</forwardTo>
- <passThrough>*true or false, default=false*</passThrough>
- <fakeDomainCheck>*true or false, default=true*</fakeDomainCheck>
- <debug>*true or false, default=false*</debug>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The behaviour of this mailet is equivalent to using Resend with the following
-configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="Resend">
- <forwardTo>comma delimited list of email addresses</recipients>
- <passThrough>true or false</passThrough>
- <fakeDomainCheck>*true or false*</fakeDomainCheck>
- <debug>*true or false*</debug>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>forwardto</strong> can be used instead of <strong>forwardTo</strong>; such name is kept
-for backward compatibility.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_icalendarparser"><a class="anchor" href="#_icalendarparser"></a>ICalendarParser</h3>
-<div class="paragraph">
-<p>This mailet can be combined with the Strip attachment mailet.</p>
-</div>
-<div class="paragraph">
-<p>The ICS body part byte array is arranged as map then this mailet should look for ICS and parse it
-with Ical4J then store it as a mail attribute</p>
-</div>
-<div class="paragraph">
-<p>Configuration: The mailet contains 2 mandatory attributes</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> <mailet match="All" class="ICalendarParser" >
- <sourceAttribute>source.attribute.name</sourceAttribute>
- <!-- The attribute which contains output value of StripAttachment mailet -- >
- <destAttribute>dest.attribute.name</destAttribute>
- <!-- The attribute store the map of Calendar -- >
- </mailet ></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_icaltoheader"><a class="anchor" href="#_icaltoheader"></a>ICALToHeader</h3>
-<div class="paragraph">
-<p>ICALToHeader takes a Map of filenames to ICAL4J calendars, will pick the first Calendar,
-and add it to the headers of the e-mail.</p>
-</div>
-<div class="paragraph">
-<p>The following headers will be added : X_MEETING_UID, X_MEETING_METHOD, X_MEETING_RECURRENCE_ID, X_MEETING_SEQUENCE,
-X_MEETING_DTSTAMP</p>
-</div>
-<div class="paragraph">
-<p>The only configuration parameter for this mailet is the attribute the ICAL4J Calendar map should be attached to,
-named <strong>attribute</strong>.</p>
-</div>
-<div class="paragraph">
-<p>Configuration example :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match=??? class=ICALToHeader>
- <attribute>icalendars</attribute>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_icaltojsonattribute"><a class="anchor" href="#_icaltojsonattribute"></a>ICALToJsonAttribute</h3>
-<div class="paragraph">
-<p>ICALToJsonAttribute takes a map of ICAL4J objects attached as attribute, and
-output the map of corresponding json bytes as an other attribute, with unique String keys.</p>
-</div>
-<div class="paragraph">
-<p>The JSON contains the following fields :</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>ical</strong> : the raw ical string, in UTF-8</p>
-</li>
-<li>
-<p><strong>sender</strong> : the sender of the mail (compulsory, mail without sender will be discarded)</p>
-</li>
-<li>
-<p><strong>recipient</strong> : the recipient of the mail. If the mail have several recipients, each recipient will have its own JSON.</p>
-</li>
-<li>
-<p><strong>uid</strong> : the UID of the ical (optional)</p>
-</li>
-<li>
-<p><strong>sequence</strong> : the sequence of the ical (optional)</p>
-</li>
-<li>
-<p><strong>dtstamp</strong> : the date stamp of the ical (optional)</p>
-</li>
-<li>
-<p><strong>method</strong> : the method of the ical (optional)</p>
-</li>
-<li>
-<p><strong>recurrence-id</strong> : the recurrence-id of the ical (optional)</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Example are included in test call ICalToJsonAttributeTest.</p>
-</div>
-<div class="paragraph">
-<p>Configuration example :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match=??? class=ICALToJsonAttribute>
- <sourceAttribute>icalendars</sourceAttribute>
- <destinationAttribute>icalendarJson</destinationAttribute>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_icssanitizer"><a class="anchor" href="#_icssanitizer"></a>ICSSanitizer</h3>
-<div class="paragraph">
-<p>Some senders embed 'text/calendar' content as part of Mime bodypart headers with an empty body.</p>
-</div>
-<div class="paragraph">
-<p>This mailet duplicate the 'text/calendar' content to the Mime body part.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="ICSSanitizer"/></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_localdelivery"><a class="anchor" href="#_localdelivery"></a>LocalDelivery</h3>
-<div class="paragraph">
-<p>Receives a Mail from the Queue and takes care of delivery of the
-message to local inboxes.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_logmessage"><a class="anchor" href="#_logmessage"></a>LogMessage</h3>
-<div class="paragraph">
-<p>Logs Message Headers and/or Body.
-If the "passThrough" in confs is true the mail will be left untouched in
-the pipe. If false will be destroyed. Default is true.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_mailattributeslisttomimeheaders"><a class="anchor" href="#_mailattributeslisttomimeheaders"></a>MailAttributesListToMimeHeaders</h3>
-<div class="paragraph">
-<p>Convert attributes of type Collection<String> to headers</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="MailAttributesToMimeHeaders">
- <simplemapping>org.apache.james.attribute1;headerName1</simplemapping>
- <simplemapping>org.apache.james.attribute2;headerName2</simplemapping>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_mailattributestomimeheaders"><a class="anchor" href="#_mailattributestomimeheaders"></a>MailAttributesToMimeHeaders</h3>
-<div class="paragraph">
-<p>Convert attributes of type Collection<String> to headers</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="MailAttributesToMimeHeaders">
- <simplemapping>org.apache.james.attribute1;headerName1</simplemapping>
- <simplemapping>org.apache.james.attribute2;headerName2</simplemapping>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_metricsmailet"><a class="anchor" href="#_metricsmailet"></a>MetricsMailet</h3>
-<div class="paragraph">
-<p>This Metrics mailet increments a counter on every incoming emails.</p>
-</div>
-<div class="paragraph">
-<p>This counter is accessible via JMX, or grafana. Read <a href="../operate/metrics.html" class="xref page">more about metrics</a>.</p>
-</div>
-<div class="paragraph">
-<p>Example :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="all" class="MetricsMailet">
- <metricName>relayDenied</metricName>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will increment a counter relayDenied</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_mailattributestomimeheaders_2"><a class="anchor" href="#_mailattributestomimeheaders_2"></a>MailAttributesToMimeHeaders</h3>
-<div class="paragraph">
-<p>This mailet replace the mail attribute map of key to MimePart
-by a map of key to the MimePart content (as bytes).</p>
-</div>
-<div class="paragraph">
-<p>It takes only one parameter:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>attribute (mandatory): mime content to be decoded, expected to be a Map<String, byte[]></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Then all this map attribute values will be replaced by their content.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_notifypostmaster"><a class="anchor" href="#_notifypostmaster"></a>NotifyPostmaster</h3>
-<div class="paragraph">
-<p>Sends a notification message to the Postmaster.</p>
-</div>
-<div class="paragraph">
-<p>A sender of the notification message can optionally be specified. If one is
-not specified, the postmaster’s address will be used.</p>
-</div>
-<div class="paragraph">
-<p>The "To:" header of the notification message can be set to "unaltered"; if
-missing will be set to the postmaster.</p>
-</div>
-<div class="paragraph">
-<p>A notice text can be specified, and in such case will be inserted into the
-notification inline text.</p>
-</div>
-<div class="paragraph">
-<p>If the notified message has an "error message" set, it will be inserted into
-the notification inline text. If the <strong>attachError</strong> init
-parameter is set to true, such error message will be attached to the
-notification message.</p>
-</div>
-<div class="paragraph">
-<p>The notified messages are attached in their entirety (headers and content)
-and the resulting MIME part type is "message/rfc822".</p>
-</div>
-<div class="paragraph">
-<p>Supports the <strong>passThrough</strong> init parameter (true if missing).</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="NotifyPostmaster">
- <sender>*an address or postmaster or sender or unaltered, default=postmaster*</sender>
- <attachError>*true or false, default=false*</attachError>
- <message>*notice attached to the original message text (optional)*</message>
- <prefix>*optional subject prefix prepended to the original message, default="Re:"*</prefix>
- <inline>*default=none*</inline>
- <attachment>*default=message*</attachment>
- <passThrough>*true or false, default=true*</passThrough>
- <fakeDomainCheck>*true or false, default=true*</fakeDomainCheck>
- <to>*unaltered (optional, defaults to postmaster)*</to>
- <debug>*true or false, default=false*</debug>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The behaviour of this mailet is equivalent to using Resend with the following
-configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="Resend">
- <sender>*an address or postmaster or sender or unaltered*</sender>
- <attachError>*true or false*</attachError>
- <message>*<b>dynamically built</b>*</message>
- <prefix>*a string*</prefix>
- <passThrough>*true or false*</passThrough>
- <fakeDomainCheck>*true or false*</fakeDomainCheck>
- <to>*<b>unaltered or postmaster</b>*</to>
- <recipients><b>postmaster</b></recipients>
- <inline>see {@link Resend}</inline>
- <attachment>see {@link Resend}</attachment>
- <isReply>true</isReply>
- <debug>*true or false*</debug>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>notice</strong>, <strong>sendingAddress</strong> and <strong>attachError</strong> can be used
-instead of <strong>message</strong>, <strong>sender</strong> and <strong>attachError</strong>; such names
-are kept for backward compatibility.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_notifysender"><a class="anchor" href="#_notifysender"></a>NotifySender</h3>
-<div class="paragraph">
-<p>Sends a notification message to the sender of a message.</p>
-</div>
-<div class="paragraph">
-<p>A sender of the notification message can optionally be specified. If one is
-not specified, the postmaster’s address will be used.</p>
-</div>
-<div class="paragraph">
-<p>The "To:" header of the notification message can be set to "unaltered"; if
-missing will be set to the sender of the notified message.</p>
-</div>
-<div class="paragraph">
-<p>A notice text can be specified, and in such case will be inserted into the
-notification inline text.</p>
-</div>
-<div class="paragraph">
-<p>If the notified message has an "error message" set, it will be inserted into
-the notification inline text. If the <strong>attachError</strong> init
-parameter is set to true, such error message will be attached to the
-notification message.</p>
-</div>
-<div class="paragraph">
-<p>The notified messages are attached in their entirety (headers and content)
-and the resulting MIME part type is "message/rfc822".</p>
-</div>
-<div class="paragraph">
-<p>Supports the <strong>passThrough</strong> init parameter (true if missing).</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="NotifySender">
- <sender>*an address or postmaster or sender or unaltered, default=postmaster*</sender>
- <attachError>*true or false, default=false*</attachError>
- <prefix>*optional subject prefix prepended to the original message*</prefix>
- <inline>default=none*</inline>
- <attachment>default=message*</attachment>
- <passThrough>*true or false, default=true*</passThrough>
- <fakeDomainCheck>*true or false, default=true*</fakeDomainCheck>
- <to>*unaltered or sender or from(optional, defaults to sender)*</to>
- <debug>*true or false, default=false*</debug>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The behaviour of this mailet is equivalent to using Resend with the following
-configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="Resend">
- <sender>*an address or postmaster or sender or unaltered*</sender>
- <attachError>*true or false*</attachError>
- <message>*<b>dynamically built</b>*</message>
- <prefix>*a string*</prefix>
- <passThrough>true</passThrough>
- <fakeDomainCheck>*true or false*</fakeDomainCheck>
- <to>*unaltered or sender or from&lt*;/to>
- <recipients><b>sender</b></recipients>
- <inline>none</inline>
- <attachment>message</attachment>
- <isReply>true</isReply>
- <debug>*true or false*</debug>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>notice</strong>, <strong>sendingAddress</strong> and <strong>attachError</strong> can be used
-instead of <strong>message</strong>, <strong>sender</strong> and <strong>attachError</strong>; such names
-are kept for backward compatibility.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_null"><a class="anchor" href="#_null"></a>Null</h3>
-<div class="paragraph">
-<p>Simplest Mailet which destroys any incoming messages by setting their state to GHOST.</p>
-</div>
-<div class="paragraph">
-<p>This effectively stops all processing of this mail.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_postmasteralias"><a class="anchor" href="#_postmasteralias"></a>PostmasterAlias</h3>
-<div class="paragraph">
-<p>Rewrites recipient addresses to make sure email for the postmaster is
-always handled. This mailet is silently inserted at the top of the root
-spool processor. All recipients mapped to postmaster@<servernames> are
-changed to the postmaster account as specified in the server conf.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_randomstoring"><a class="anchor" href="#_randomstoring"></a>RandomStoring</h3>
-<div class="paragraph">
-<p>Process messages and randomly assign them to 4 to 8 mailboxes.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_recipientrewritetable"><a class="anchor" href="#_recipientrewritetable"></a>RecipientRewriteTable</h3>
-<div class="paragraph">
-<p>Mailet which should get used when using RecipientRewriteTable-Store to
-implementations for mappings of forwards and aliases.</p>
-</div>
-<div class="paragraph">
-<p>By specifying an 'errorProcessor' you can specify your logic upon RecipientRewriteTable failures.</p>
-</div>
-<div class="paragraph">
-<p>Exemple:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> <mailet match="All" class="RecipientRewriteTable">
- <errorProcessor>rrt-errors</errorProcessor>
- </mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_recipienttolowercase"><a class="anchor" href="#_recipienttolowercase"></a>RecipientToLowerCase</h3>
-<div class="paragraph">
-<p>GenericMailet which convert all Recipients to lowercase.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_redirect"><a class="anchor" href="#_redirect"></a>Redirect</h3>
-<div class="paragraph">
-<p>A mailet providing configurable redirection services.</p>
-</div>
-<div class="paragraph">
-<p>Can produce listserver, forward and notify behaviour, with the original
-message intact, attached, appended or left out altogether.</p>
-</div>
-<div class="paragraph">
-<p>It differs from Resend because (i) some defaults are different,
-notably for the following parameters: <strong><recipients></strong>,
-<strong><to></strong>, <strong><reversePath></strong> and <strong><inline></strong>; (ii)
-because it allows the use of the <strong><static></strong> parameter;.</p>
-</div>
-<div class="paragraph">
-<p>Use <code>Resend</code> if you need full control, <code>Redirect</code> if
-the more automatic behaviour of some parameters is appropriate.</p>
-</div>
-<div class="paragraph">
-<p>This built in functionality is controlled by the configuration as laid out
-below. In the table please note that the parameters controlling message
-headers accept the <b>"unaltered"</b> value, whose meaning is to
-keep the associated header unchanged and, unless stated differently,
-corresponds to the assumed default if the parameter is missing.</p>
-</div>
-<div class="paragraph">
-<p>The configuration parameters are:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. Redirect parameters</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">recipients</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A comma delimited list of addresses for recipients of this message; it will
-use the "to" list if not specified, and "unaltered" if
-none of the lists is specified.</p>
-<p class="tableblock">These addresses will only appear in the To: header if no "to" list
-is supplied.</p>
-<p class="tableblock">Such addresses can contain "full names", like <strong>Mr. John D. Smith
-<<a href="mailto:john.smith@xyz.com">john.smith@xyz.com</a>></strong>.</p>
-<p class="tableblock">The list can include constants "sender", "from",
-"replyTo", "postmaster", "reversePath",
-"recipients", "to", "null" and
-"unaltered"; "replyTo" uses the ReplyTo header if
-available, otherwise the From header if available, otherwise the Sender
-header if available, otherwise the return-path; "from" is made
-equivalent to "sender", and "to" is made equivalent to
-"recipients"; "null" is ignored.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">to</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A comma delimited list of addresses to appear in the To: header; the email
-will be delivered to any of these addresses if it is also in the recipients
-list.</p>
-<p class="tableblock">The recipients list will be used if this list is not supplied; if none of the
-lists is specified it will be "unaltered".</p>
-<p class="tableblock">Such addresses can contain "full names", like <strong>Mr. John D. Smith
-<<a href="mailto:john.smith@xyz.com">john.smith@xyz.com</a>></strong>.</p>
-<p class="tableblock">The list can include constants "sender", "from",
-"replyTo", "postmaster", "reversePath",
-"recipients", "to", "null" and
-"unaltered"; "from" uses the From header if available,
-otherwise the Sender header if available, otherwise the return-path;
-"replyTo" uses the ReplyTo header if available, otherwise the From
-header if available, otherwise the Sender header if available, otherwise the
-return-path; "recipients" is made equivalent to "to"; if
-"null" is specified alone it will remove this header.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">sender</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">single email address to appear in the From: and Return-Path: headers and
-become the sender.</p>
-<p class="tableblock">It can include constants "sender", "postmaster" and
-"unaltered"; "sender" is equivalent to
-"unaltered".</p>
-<p class="tableblock">Default: "unaltered".</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">message</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A text message to insert into the body of the email.</p>
-<p class="tableblock">Default: no message is inserted.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">inline</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">One of the following items:</p>
-<p class="tableblock">* unaltered The original message is the new
-message, for forwarding/aliasing
-* heads The
-headers of the original message are appended to the message
-* body The
-body of the original is appended to the new message
-*
-all &nbsp
-; Both headers and body are appended
-* none
-Neither body nor headers are appended
-</ul>
-Default: "body".</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">attachment</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">One of the following items:</p>
-<p class="tableblock">* heads The headers of the original are
-attached as text
-* body The body of the original is
-attached as text
-* all Both
-headers and body are attached as a single text file
-* none Nothing is attached
-* message The original message is attached as type message/rfc822,
-this means that it can, in many cases, be opened, resent, fw’d, replied to
-etc by email client software.</p>
-<p class="tableblock">Default: "none".</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">passThrough</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false, if true the original message continues in the mailet processor
-after this mailet is finished. False causes the original to be stopped.</p>
-<p class="tableblock">Default: false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">fakeDomainCheck</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false, if true will check if the sender domain is valid.</p>
-<p class="tableblock">Default: true.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">attachError</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false, if true any error message available to the mailet is appended
-to the message body (except in the case of inline == unaltered).</p>
-<p class="tableblock">Default: false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">replyTo</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A single email address to appear in the Reply-To: header.</p>
-<p class="tableblock">It can include constants "sender", "postmaster"
-"null" and "unaltered"; if "null" is specified
-it will remove this header.</p>
-<p class="tableblock">Default: "unaltered".</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">reversePath</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A single email address to appear in the Return-Path: header.</p>
-<p class="tableblock">It can include constants "sender", "postmaster" and
-"null"; if "null" is specified then it will set it to <>,
-meaning "null return path".</p>
-<p class="tableblock">Notice: the "unaltered" value is <strong>not allowed</strong>.</p>
-<p class="tableblock">Default: the value of the <strong><sender></strong> parameter, if set, otherwise
-remains unaltered.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">subject</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">An optional string to use as the subject.</p>
-<p class="tableblock">Default: keep the original message subject.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">prefix</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">An optional subject prefix prepended to the original message subject, or to a
-new subject specified with the <strong><subject></strong> parameter.</p>
-<p class="tableblock">For example: <strong>[Undeliverable mail]</strong>.</p>
-<p class="tableblock">Default: ".</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">isReply</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false, if true the IN_REPLY_TO header will be set to the id of the
-current message.</p>
-<p class="tableblock">Default: false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">debug</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false. If this is true it tells the mailet to write some debugging
-information to the mailet log.</p>
-<p class="tableblock">Default: false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">static</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false. If this is true it tells the mailet that it can reuse all the
-initial parameters (to, from, etc) without re-calculating their values. This
-will boost performance where a redirect task doesn’t contain any dynamic
-values. If this is false, it tells the mailet to recalculate the values for
-each e-mail processed.</p>
-<p class="tableblock">Default: false.</p></td>
-</tr>
-</tbody>
-</table>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> <mailet match="RecipientIs=test@localhost" class="Redirect">
- <recipients>x@localhost, y@localhost, z@localhost</recipients>
- <to>list@localhost</to>
- <sender>owner@localhost</sender>
- <message>sent on from James</message>
- <inline>unaltered</inline>
- <passThrough>FALSE</passThrough>
- <replyTo>postmaster</replyTo>
- <prefix xml:space="preserve">[test mailing] </prefix>
- <!-- note the xml:space="preserve" to preserve whitespace -->
- <static>TRUE</static>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>and:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> <mailet match="All" class="Redirect">
- <recipients>x@localhost</recipients>
- <sender>postmaster</sender>
- <message xml:space="preserve">Message marked as spam:</message>
- <inline>heads</inline>
- <attachment>message</attachment>
- <passThrough>FALSE</passThrough>
- <attachError>TRUE</attachError>
- <replyTo>postmaster</replyTo>
- <prefix>[spam notification]</prefix>
- <static>TRUE</static>
- </mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>replyto</strong> can be used instead of <strong>replyTo</strong>; such name is kept for
-backward compatibility.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_remotedelivery"><a class="anchor" href="#_remotedelivery"></a>RemoteDelivery</h3>
-<div class="paragraph">
-<p>The RemoteDelivery mailet delivers messages to a remote SMTP server able to deliver or forward messages to their final
-destination.</p>
-</div>
-<div class="paragraph">
-<p>The remote SMTP server through which each mail is delivered is resolved using MX lookup for each message destination
-unless the <strong><gateway/></strong> parameter is set. The <strong><gateway/></strong> parameter enables the
-definition of one or more gateway servers through which all messages are sent.</p>
-</div>
-<div class="paragraph">
-<p>If an attempt to deliver a message fails, a redelivery attempt is scheduled according to the scheme defined
-by the <strong><delayTime/></strong> parameter, retrying up to the limit defined
-by the <strong><maxRetries/></strong> parameter. When the retry limit is exceeded, delivery failure is processed
-according to the setting of the <strong><bounceProcessor/></strong> parameter.</p>
-</div>
-<div class="paragraph">
-<p>These are the parameters that control the operation of the RemoteDelivery mailet:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>outgoing</strong> (required) - a String containing the name of the queue that will hold messages being processed by this mailet.</p>
-</li>
-<li>
-<p><strong>bind</strong> (optional) - a String describing the local IP address to which the mailet should be bound while delivering
-emails. This tag is useful for multihomed machines. Default is to bind to the default local address of the machine.<br>
-Note: The same IP address must be used for all of those RemoteDelivery instances where you explicitly supply a bind address.</p>
-</li>
-<li>
-<p><strong>delayTime</strong> (optional) a String containing a comma separated list of patterns defining the number of and delays between delivery
-attempts. The pattern is <strong>[attempts\</strong>]delay [unit]* where:</p>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>attempts</strong> (optional) - an Integer for the number of delivery attempts. Default is 1.</p>
-</li>
-<li>
-<p><strong>delay</strong> (required) - a Long for the delay between attempts.</p>
-</li>
-<li>
-<p><strong>unit</strong> (optional) - a String with the value of one of 'msec', 'sec', 'minute', 'hour', or 'day'. Default is msec.</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Default is one attempt after 6 hours, which if explicitly declared would be written as <strong><delayTime>1 6 hour</delayTime></strong></p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>maxRetries</strong> (optional) an Integer for the number of times an attempt is made to deliver a particular mail.
-Default is the greater of five and the sum of the attempts for each <strong><delayTime/></strong> specified.</p>
-</li>
-<li>
-<p><strong>maxDnsProblemRetries</strong> (optional) - an Integer for the number of times to retry if DNS problems for a domain occur.
-Default is 0.</p>
-</li>
-<li>
-<p><strong>timeout</strong> (optional) - an Integer for the Socket I/O timeout in milliseconds. Default is 180000</p>
-</li>
-<li>
-<p><strong>connectionTimeout</strong> (optional) - an Integer for the Socket connection timeout in milliseconds. Default is 60000</p>
-</li>
-<li>
-<p><strong>bounceProcessor</strong> (optional) - a String containing the name of the mailet processor to pass messages that cannot
-be delivered to for DSN bounce processing. Default is to send a traditional message containing the bounce details.</p>
-</li>
-<li>
-<p><strong>startTLS</strong> (optional) - a Boolean (true/false) indicating whether the STARTTLS command (if supported by the server)
-to switch the connection to a TLS-protected connection before issuing any login commands. Default is false.</p>
-</li>
-<li>
-<p><strong>sslEnable</strong> (optional) - a Boolean (true/false) indicating whether to use SSL to connect and use the SSL port unless
-explicitly overridden. Default is false.</p>
-</li>
-<li>
-<p><strong>gateway</strong> (optional) - a String containing a comma separated list of patterns defining the gateway servers to be used to
-deliver mail regardless of the recipient address. If multiple gateway servers are defined, each will be tried in definition order
-until delivery is successful. If none are successful, the mail is bounced. The pattern is <strong>host[:port]</strong> where:</p>
-</li>
-<li>
-<p><strong>host</strong> (required) - the FQN of the gateway server.</p>
-</li>
-<li>
-<p><strong>port</strong> (optional) - the port of the gateway server. Default is the value defined in the <strong><gatewayPort/></strong>
-parameter if set, else the default port for the specified connection type.
-Default is to resolve the destination SMTP server for each mail using MX lookup.</p>
-</li>
-<li>
-<p><strong>gatewayPort</strong> (optional) - an Integer for the gateway port to be used for each defined gateway server for which a
-port is not explicitly defined in the <strong><gateway/></strong> parameter. Default is the default port for the specified connection type.</p>
-</li>
-<li>
-<p><strong>gatewayUsername</strong> (optional) - a String containing the user name to be used to authenticate the user using the
-AUTH command. Default is not to issue the AUTH command.</p>
-</li>
-<li>
-<p><strong>gatewayPassword</strong> (required if <strong>gatewayUsername</strong>) is set - a String representing the password to be used
-to authenticate the user using the AUTH command.</p>
-</li>
-<li>
-<p><strong>heloName</strong> (optional) - a String containing the name used in the SMTP HELO and EHLO commands. Default is the default domain,
-which is typically <strong>localhost</strong>.</p>
-</li>
-<li>
-<p><strong>mail.</strong>* (optional) - Any property beginning with <strong>mail.</strong> described in the Javadoc for package
-<a href="https://javaee.github.io/javamail/docs/api/com/sun/mail/smtp/package-summary.html">*com.sun.mail.smtp*</a>
-can be set with a parameter of the corresponding name. For example the parameter
-<strong><mail.smtp.ssl.enable>true</mail.smtp.ssl.enable></strong> is equivalent to the Java code
-<strong>props.put("mail.smtp.ssl.enable", "true");</strong>. Properties set by this facility override settings made
-within the mailet code.<br>
-Note: This facility should be used with extreme care by expert users with a thorough knowledge of the relevant RFCs and
-the ability to perform their own problem resolutions.</p>
-</li>
-<li>
-<p><strong>debug</strong> (optional) - a Boolean (true/false) indicating whether debugging is on. Default is false.</p>
-</li>
-</ul>
-</div>
-<div class="sect3">
-<h4 id="_security"><a class="anchor" href="#_security"></a>Security</h4>
-<div class="paragraph">
-<p>You can use the <strong>mail.smtp.ssl.enable</strong> javax property described above to force SMTP outgoing delivery to default to SSL
-encrypted traffic.</p>
-</div>
-<div class="paragraph">
-<p>When enabling SSL, you might need to specify <strong>mail.smtp.ssl.checkserveridentity</strong> and <strong>mail.smtp.ssl.trust</strong>
-properties. You can also control ciphersuites and protocols via <strong>mail.smtp.ssl.ciphersuites</strong> and
-<strong>mail.smtp.ssl.protocols</strong> properties.</p>
-</div>
-<div class="paragraph">
-<p><strong>startTls</strong> can alternatively be enabled upon sending a mail. For this, use the <strong>startTls</strong> configuration property, serving as a shortcut for
-javax <strong>mail.smtp.starttls.enable</strong> property. Depending on how strict your security policy is, you might consider
-<strong>mail.smtp.starttls.required</strong> as well. Be aware that configuring trust will then be required.</p>
-</div>
-<div class="paragraph">
-<p>Read <a href="https://javaee.github.io/javamail/docs/api/com/sun/mail/smtp/package-summary.html"><strong>com.sun.mail.smtp</strong></a>
-for full information.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_removeallmailattributes"><a class="anchor" href="#_removeallmailattributes"></a>RemoveAllMailAttributes</h3>
-<div class="paragraph">
-<p>This mailet sets removes all attributes set on the Mail instance</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="RemoveAllMailAttributes"/></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_removemailattribute"><a class="anchor" href="#_removemailattribute"></a>RemoveMailAttribute</h3>
-<div class="paragraph">
-<p>This mailet sets attributes on the Mail.</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="RemoveMailAttribute">
- <name>attribute_name1</name>
- <name>attribute_name2</name>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_removemimeheader"><a class="anchor" href="#_removemimeheader"></a>RemoveMimeHeader</h3>
-<div class="paragraph">
-<p>Remove mime headers from the message (global) and per recipient (specific).</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="RemoveMimeHeader">
- <name>header1,header2</name>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_removemimeheader_2"><a class="anchor" href="#_removemimeheader_2"></a>RemoveMimeHeader</h3>
-<div class="paragraph">
-<p>This mailet removes all of the headers starting with a given prefix in the message (global) and per recipient (specific).</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="RemoveMimeHeaderByPrefix">
- <name>X-APPLICATIVE-HEADER-</name>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_replacecontent"><a class="anchor" href="#_replacecontent"></a>ReplaceContent</h3>
-<div class="paragraph">
-<p>Replace text contents</p>
-</div>
-<div class="paragraph">
-<p>This mailet allow to specific regular expression to replace text in subject and content.</p>
-</div>
-<div class="paragraph">
-<p>Each expression is defined as: <strong>/REGEX_PATTERN/SUBSTITUTION_PATTERN/FLAGS/</strong></p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>REGEX_PATTERN</strong> is a regex used for the match</p>
-</li>
-<li>
-<p><strong>SUBSTITUTION_PATTERN</strong> is a substitution pattern</p>
-</li>
-<li>
-<p><strong>FLAGS</strong> flags supported for the pattern:</p>
-<div class="ulist">
-<ul>
-<li>
-<p>i: case insensitive</p>
-</li>
-<li>
-<p>m: multi line</p>
-</li>
-<li>
-<p>x: extended (N/A)</p>
-</li>
-<li>
-<p>r: repeat - keep matching until a substitution is possible</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>To identify subject and body pattern we use the tags <subjectPattern> and <bodyPattern></p>
-</div>
-<div class="paragraph">
-<p>Rules can be specified in external files.
-Lines must be CRLF terminated and lines starting with # are considered comments.
-Tags used to include external files are <subjectPatternFile> and
-<bodyPatternFile>
-If file path starts with # then the file is loaded as a resource.</p>
-</div>
-<div class="paragraph">
-<p>Use of both files and direct patterns at the same time is allowed.</p>
-</div>
-<div class="paragraph">
-<p>This mailet allow also to enforce the resulting charset for messages processed, when a replacement has been done.
-To do that the tag <charset> must be specified.</p>
-</div>
-<div class="paragraph">
-<p>NOTE:
-Regexp rules must be escaped by regexp escaping rules and applying this 2 additional rules:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>"/" char inside an expression must be prefixed with "\":
-e.g: "/\//-//" replaces "/" with "-"</p>
-</li>
-<li>
-<p>when the rules are specified using <subjectPattern> or <bodyPattern> and
-"/,/" has to be used in a pattern string it must be prefixed with a "\".
-E.g: "/\/\/,//" replaces "/" with "," (the rule would be "/\//,//" but the "/,/" must
-be escaped.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_resend"><a class="anchor" href="#_resend"></a>Resend</h3>
-<div class="paragraph">
-<p>A mailet providing configurable redirection services.</p>
-</div>
-<div class="paragraph">
-<p>Can produce listserver, forward and notify behaviour, with the original
-message intact, attached, appended or left out altogether. Can be used as a
-replacement to {@link Redirect}, having more consistent defaults, and new
-options available.</p>
-</div>
-<div class="paragraph">
-<p>Use <code>Resend</code> if you need full control, <code>Redirect</code> if
-the more automatic behaviour of some parameters is appropriate.</p>
-</div>
-<div class="paragraph">
-<p>This built in functionality is controlled by the configuration as laid out
-below. In the table please note that the parameters controlling message
-headers accept the <b>"unaltered"</b> value, whose meaning is to
-keep the associated header unchanged and, unless stated differently,
-corresponds to the assumed default if the parameter is missing.</p>
-</div>
-<div class="paragraph">
-<p>The configuration parameters are:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 2. Resend properties</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">recipients</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A comma delimited list of addresses for recipients of this message.</p>
-<p class="tableblock">Such addresses can contain "full names", like <strong>Mr. John D. Smith
-<<a href="mailto:john.smith@xyz.com">john.smith@xyz.com</a>></strong>.</p>
-<p class="tableblock">The list can include constants "sender", "from",
-"replyTo", "postmaster", "reversePath",
-"recipients", "to", "null" and
-"unaltered"; "replyTo" uses the ReplyTo header if
-available, otherwise the From header if available, otherwise the Sender
-header if available, otherwise the return-path; "from" is made
-equivalent to "sender", and "to" is made equivalent to
-"recipients"; "null" is ignored. Default:
-"unaltered".</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">to</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A comma delimited list of addresses to appear in the To: header.</p>
-<p class="tableblock">Such addresses can contain "full names", like <strong>Mr. John D. Smith
-<<a href="mailto:john.smith@xyz.com">john.smith@xyz.com</a>></strong>.</p>
-<p class="tableblock">The list can include constants "sender", "from",
-"replyTo", "postmaster", "reversePath",
-"recipients", "to", "null" and
-"unaltered"; "from" uses the From header if available,
-otherwise the Sender header if available, otherwise the return-path;
-"replyTo" uses the ReplyTo header if available, otherwise the From
-header if available, otherwise the Sender header if available, otherwise the
-return-path; "recipients" is made equivalent to "to"; if
-"null" is specified alone it will remove this header. Default:
-"unaltered".</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">sender</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A single email address to appear in the From: header and become the sender.</p>
-<p class="tableblock">It can include constants "sender", "postmaster" and
-"unaltered"; "sender" is equivalent to
-"unaltered".</p>
-<p class="tableblock">Default: "unaltered".</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">message</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A text message to insert into the body of the email.</p>
-<p class="tableblock">Default: no message is inserted.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">inline</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">One of the following items:
-</p>
-<ul>
-* unaltered The original message is the new
-message, for forwarding/aliasing
-* heads The
-headers of the original message are appended to the message
-* body The
-body of the original is appended to the new message
-*
-all &nbsp
-; Both headers and body are appended
-* none
-Neither body nor headers are appended</p>
-<p class="tableblock">Default: "unaltered".</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">attachment</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">One of the following items:</p>
-<p class="tableblock">* heads The headers of the original are
-attached as text
-* body The body of the original is
-attached as text
-* all Both
-headers and body are attached as a single text file
-* none Nothing is attached
-* message The original message is attached as type message/rfc822,
-this means that it can, in many cases, be opened, resent, fw’d, replied to
-etc by email client software.</p>
-<p class="tableblock">Default: "none".</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">passThrough</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false, if true the original message continues in the mailet processor
-after this mailet is finished. False causes the original to be stopped.</p>
-<p class="tableblock">Default: false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">fakeDomainCheck</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false, if true will check if the sender domain is valid.</p>
-<p class="tableblock">Default: true.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">attachError</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false, if true any error message available to the mailet is appended
-to the message body (except in the case of inline == unaltered).</p>
-<p class="tableblock">Default: false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">replyTo</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A single email address to appear in the Reply-To: header.</p>
-<p class="tableblock">It can include constants "sender", "postmaster"
-"null" and "unaltered"; if "null" is specified
-it will remove this header.</p>
-<p class="tableblock">Default: "unaltered".</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">reversePath</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A single email address to appear in the Return-Path: header.</p>
-<p class="tableblock">It can include constants "sender", "postmaster"
-"null" and "unaltered"; if "null" is specified
-then it will set it to <>, meaning "null return path".</p>
-<p class="tableblock">Default: "unaltered".</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">subject</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">An optional string to use as the subject.</p>
-<p class="tableblock">Default: keep the original message subject.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">prefix</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">An optional subject prefix prepended to the original message subject, or to a
-new subject specified with the <strong><subject></strong> parameter.</p>
-<p class="tableblock">For example: <strong>[Undeliverable mail]</strong>.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">isReply</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false, if true the IN_REPLY_TO header will be set to the id of the
-current message.</p>
-<p class="tableblock">Default: false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">debug</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false. If this is true it tells the mailet to write some debugging
-information to the mailet log.</p>
-<p class="tableblock">Default: false.</p></td>
-</tr>
-</tbody>
-</table>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> <mailet match="RecipientIs=test@localhost" class="Resend">
- <recipients>x@localhost, y@localhost, z@localhost</recipients>
- <to>list@localhost</to>
- <sender>owner@localhost</sender>
- <message>sent on from James</message>
- <inline>unaltered</inline>
- <passThrough>FALSE</passThrough>
- <replyTo>postmaster</replyTo>
- <prefix xml:space="preserve">[test mailing] </prefix>
- <!-- note the xml:space="preserve" to preserve whitespace -->
- <static>TRUE</static>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>and:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> <mailet match="All" class="Resend">
- <recipients>x@localhost</recipients>
- <sender>postmaster</sender>
- <message xml:space="preserve">Message marked as spam:</message>
- <inline>heads</inline>
- <attachment>message</attachment>
- <passThrough>FALSE</passThrough>
- <attachError>TRUE</attachError>
- <replyTo>postmaster</replyTo>
- <prefix>[spam notification]</prefix>
- </mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The following example forwards the message without any modification, based on
-the defaults:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> <mailet match="All" class="Resend&quot/;></pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>replyto</strong> can be used instead of <strong>replyTo</strong>; such name is kept for
-backward compatibility.</p>
-</div>
-<div class="admonitionblock warning">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-warning" title="Warning"></i>
-</td>
-<td class="content">
-as the message (or a copy of it) is reinjected in the spool
-without any modification, the preceding example is very likely to cause a
-"configuration loop" in your system, unless some other mailet has previously
-modified something (a header for instance) that could force the resent
-message follow a different path so that it does not return here
-unchanged.
-</td>
-</tr>
-</table>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_setmailattribute"><a class="anchor" href="#_setmailattribute"></a>SetMailAttribute</h3>
-<div class="paragraph">
-<p>This mailet sets attributes on the Mail.</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="SetMailAttribute">
- <name1>value1</name1>
- <name2>value2</name2>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_setmailattribute_2"><a class="anchor" href="#_setmailattribute_2"></a>SetMailAttribute</h3>
-<div class="paragraph">
-<p>Adds a specified header and value to the message.</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="AddHeader">
- <name>X-MailetHeader</name>
- <value>TheHeaderValue</value>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_sieve"><a class="anchor" href="#_sieve"></a>Sieve</h3>
-<div class="paragraph">
-<p>Execute Sieve scripts for incoming emails, and set the result of the execution as attributes of the mail</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_sign"><a class="anchor" href="#_sign"></a>Sign</h3>
-<div class="paragraph">
-<p>Puts a <strong>server-side</strong> SMIME signature on a message.</p>
-</div>
-<div class="paragraph">
-<p>It is a concrete subclass of Sign, with very few modifications to it,
-to specialize for SMIME.</p>
-</div>
-<div class="paragraph">
-<p>Handles the following init parameters:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><keyHolderClass>: Sets the class of the KeyHolder object that will handle the cryptography functions,
-for example org.apache.james.security.SMIMEKeyHolder for SMIME.</p>
-</li>
-<li>
-<p><debug>: if <strong>true</strong> some useful information is logged.
-The default is <strong>false</strong>.</p>
-</li>
-<li>
-<p><keyStoreFileName>: the {@link java.security.KeyStore} full file name.</p>
-</li>
-<li>
-<p><keyStorePassword>: the <strong>KeyStore</strong> password.
-If given, it is used to check the integrity of the keystore data,
-otherwise, if null, the integrity of the keystore is not checked.</p>
-</li>
-<li>
-<p><keyAlias>: the alias name to use to search the Key using {@link java.security.KeyStore#getKey}.
-The default is to look for the first and only alias in the keystore;
-if zero or more than one is found a {@link java.security.KeyStoreException} is thrown.</p>
-</li>
-<li>
-<p><keyAliasPassword>: the alias password. The default is to use the <strong>KeyStore</strong> password.
-At least one of the passwords must be provided.</p>
-</li>
-<li>
-<p><keyStoreType>: the type of the keystore. The default will use {@link java.security.KeyStore#getDefaultType}.</p>
-</li>
-<li>
-<p><postmasterSigns>: if <strong>true</strong> the message will be signed even if the sender is the Postmaster. The default is <strong>true</strong>.</p>
-</li>
-<li>
-<p><rebuildFrom>: If <strong>true</strong> will modify the "From:" header. The default is <strong>true</strong>.</p>
-</li>
-<li>
-<p><signerName>: the name of the signer to be shown in the explanation text. The default is to use the "CN="
-property of the signing certificate.</p>
-</li>
-<li>
-<p><explanationText>. There is a default explanation string template in English, displaying
-also all the headers of the original message.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_smimechecksignature"><a class="anchor" href="#_smimechecksignature"></a>SMIMECheckSignature</h3>
-<div class="paragraph">
-<p>Verifies the s/mime signature of a message. The s/mime signing ensure that
-the private key owner is the real sender of the message. To be checked by
-this mailet the s/mime signature must contain the actual signature, the
-signer’s certificate and optionally a set of certificate that can be used to
-create a chain of trust that starts from the signer’s certificate and leads
-to a known trusted certificate.</p>
-</div>
-<div class="paragraph">
-<p>This check is composed by two steps: firstly it’s ensured that the signature
-is valid, then it’s checked if a chain of trust starting from the signer
-certificate and that leads to a trusted certificate can be created. The first
-check verifies that the the message has not been modified after the signature
-was put and that the signer’s certificate was valid at the time of the
-signing. The latter should ensure that the signer is who he declare to be.</p>
-</div>
-<div class="paragraph">
-<p>The results of the checks perfomed by this mailet are wrote as a mail
-attribute which default name is org.apache.james.SMIMECheckSignature (it can
-be changed using the mailet parameter <strong>mailAttribute</strong>). After
-the check this attribute will contain a list of SMIMESignerInfo object, one
-for each message’s signer. These objects contain the signer’s certificate and
-the trust path.</p>
-</div>
-<div class="paragraph">
-<p>Optionally, specifying the parameter <strong>strip</strong>, the signature of
-the message can be stripped after the check. The message will become a
-standard message without an attached s/mime signature.</p>
-</div>
-<div class="paragraph">
-<p>The configuration parameter of this mailet are summerized below. The firsts
-defines the location, the format and the password of the keystore containing
-the certificates that are considered trusted. Note: only the trusted certificate
-entries are read, the key ones are not.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>keyStoreType (default: jks): Certificate store format . "jks" is the
-standard java certificate store format, but pkcs12 is also quite common and
-compatible with standard email clients like Outlook Express and Thunderbird.</p>
-</li>
-<li>
-<p>keyStoreFileName (default: JAVA_HOME/jre/lib/security/cacert): Certificate
-store path.</p>
-</li>
-<li>
-<p>keyStorePassword (default: ""): Certificate store password.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Other parameters configure the behavior of the mailet:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>strip (default: false): Defines if the s/mime signature of the message
-have to be stripped after the check or not. Possible values are true and
-false.</p>
-</li>
-<li>
-<p>mailAttribute (default: org.apache.james.SMIMECheckSignature):
-specifies in which attribute the check results will be written.</p>
-</li>
-<li>
-<p>onlyTrusted (default: true): Usually a message signature to be
-considered by this mailet as authentic must be valid and trusted. Setting
-this mailet parameter to "false" the last condition is relaxed and also
-"untrusted" signature are considered will be considered as authentic.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_smimedecrypt"><a class="anchor" href="#_smimedecrypt"></a>SMIMEDecrypt</h3>
-<div class="paragraph">
-<p>This mailet decrypts a s/mime encrypted message. It takes as input an
-encrypted message and it tries to dechiper it using the key specified in its
-configuration. If the decryption is successful the mail will be changed and
-it will contain the decrypted message. The mail attribute
-<strong>org.apache.james.SMIMEDecrypt</strong> will contain the public
-certificate of the key used in the process.</p>
-</div>
-<div class="paragraph">
-<p>The configuration parameters of this mailet are summarized below. The firsts
-define the keystore where the key that will be used to decrypt messages is
-saved.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>keyStoreType (default: system dependent): defines the type of the store.
-Usually jks, pkcs12 or pkcs7</p>
-</li>
-<li>
-<p>keyStoreFileName (mandatory): private key store path.</p>
-</li>
-<li>
-<p>keyStorePassword (default: ""): private key store password</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The other parameters define which private key have to be used. (if the store
-contains more than one key).</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>keyAlias: private key alias.</p>
-</li>
-<li>
-<p>keyPass: private key password</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_smimesign"><a class="anchor" href="#_smimesign"></a>SMIMESign</h3>
-<div class="paragraph">
-<p>Puts a <strong>server-side</strong> signature on a message.</p>
-</div>
-<div class="paragraph">
-<p>It is a concrete subclass of AbstractSign, with very few modifications to it.</p>
-</div>
-<div class="paragraph">
-<p>A text file with an explanation text is attached to the original message,
-and the resulting message with all its attachments is signed.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>The resulting appearance of the message is almost unchanged: only an extra attachment</p>
-</li>
-<li>
-<p>and the signature are added.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The kind of signature depends on the value of the <keyHolderClass> init parameter.</p>
-</div>
-<div class="paragraph">
-<p>Handles the following init parameters:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><keyHolderClass>: Sets the class of the KeyHolder object that will handle the cryptography functions,
-for example org.apache.james.security.SMIMEKeyHolder for SMIME.</p>
-</li>
-<li>
-<p><debug>: if <strong>true</strong> some useful information is logged.
-The default is <strong>false</strong>.</p>
-</li>
-<li>
-<p><keyStoreFileName>: the {@link java.security.KeyStore} full file name.</p>
-</li>
-<li>
-<p><keyStorePassword>: the <strong>KeyStore</strong> password.
-If given, it is used to check the integrity of the keystore data,
-otherwise, if null, the integrity of the keystore is not checked.</p>
-</li>
-<li>
-<p><keyAlias>: the alias name to use to search the Key using {@link java.security.KeyStore#getKey}.
-The default is to look for the first and only alias in the keystore;
-if zero or more than one is found a {@link java.security.KeyStoreException} is thrown.</p>
-</li>
-<li>
-<p><keyAliasPassword>: the alias password. The default is to use the <strong>KeyStore</strong> password.
-At least one of the passwords must be provided.</p>
-</li>
-<li>
-<p><keyStoreType>: the type of the keystore. The default will use {@link java.security.KeyStore#getDefaultType}.</p>
-</li>
-<li>
-<p><postmasterSigns>: if <strong>true</strong> the message will be signed even if the sender is the Postmaster. The default is <strong>true</strong>.</p>
-</li>
-<li>
-<p><rebuildFrom>: If <strong>true</strong> will modify the "From:" header. The default is <strong>true</strong>.</p>
-</li>
-<li>
-<p><signerName>: the name of the signer to be shown in the explanation text. The default is to use the "CN="
-property of the signing certificate.</p>
-</li>
-<li>
-<p><explanationText>. There is a default explanation string template in English, displaying
-also all the headers of the original message.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_spamassassin"><a class="anchor" href="#_spamassassin"></a>SpamAssassin</h3>
-<div class="paragraph">
-<p>Sends the message through daemonized SpamAssassin (spamd), visit
-<a href="http://spamassassin.apache.org">spamassassin.apache.org</a> for info
-on configuration. The header X-Spam-Status is added to every message, this
-contains the score and the threshold score for spam (usually 5.0). If the
-message exceeds the threshold, the header X-Spam-Flag will be added with the
-value of YES. The default host for spamd is localhost and the default port is
-783.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> org.apache.james.spamassassin.status - Holds the status
- org.apache.james.spamassassin.flag - Holds the flag</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Sample Configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet notmatch="SenderHostIsLocal" class="SpamAssassin">
- <spamdHost>localhost</spamdHost>
- <spamdPort>783</spamdPort>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_stripattachment"><a class="anchor" href="#_stripattachment"></a>StripAttachment</h3>
-<div class="paragraph">
-<p>Remove attachments from a Message. Supports simple removal, storing to file,
-or storing to mail attributes.</p>
-</div>
-<div class="paragraph">
-<p>Configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match=&quot;All&quot; class=&quot;StripAttachment&quot; >
- <pattern >.*\.xls </pattern> <!-- The regular expression that must be matched -- >
- <!-- notpattern >.*\.xls </notpattern--> <!-- The regular expression that must be matched -- >
- <mimeType>text/calendar</mimeType> <!-- The matching mimeType -- >
- <directory >c:\temp\james_attach </directory> <!-- The directory to save to -- >
- <remove >all </remove> <!-- either &quot;no&quot;, &quot;matched&quot;, &quot;all&quot; -- >
- <!-- attribute>my.attribute.name</attribute -->
-</mailet ></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>At least one of pattern, notpattern and mimeType is required.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_textcalendarbodytoattachment"><a class="anchor" href="#_textcalendarbodytoattachment"></a>TextCalendarBodyToAttachment</h3>
-<div class="paragraph">
-<p>This mailet converts Content-Type of MimeMessage from text/calendar to mulitpart/mixed</p>
-</div>
-<div class="paragraph">
-<p>The BodyPart should be retrieved from content of text/calendar with all the same "Content-*" headers from original message
-and those "Content-" header are removed from original message</p>
-</div>
-<div class="paragraph">
-<p>It does not takes any parameter</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="TextCalendarBodyToAttachment"/></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_toprocessor"><a class="anchor" href="#_toprocessor"></a>ToProcessor</h3>
-<div class="paragraph">
-<p>This mailet redirects the mail to the named processor</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="ToProcessor">
- <processor>spam</processor>
- <notice>Notice attached to the message (optional)</notice>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_torepository"><a class="anchor" href="#_torepository"></a>ToRepository</h3>
-<div class="paragraph">
-<p>Stores incoming Mail in the specified Repository.</p>
-</div>
-<div class="paragraph">
-<p>If the "passThrough" in conf is true the mail will be returned untouched in
-the pipe and may be processed by additional mailets. If false will be destroyed.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_tosenderdomainrepository"><a class="anchor" href="#_tosenderdomainrepository"></a>ToSenderDomainRepository</h3>
-<div class="paragraph">
-<p>Stores incoming Mail in a repository defined by the sender’s domain.<br></p>
-</div>
-<div class="paragraph">
-<p>Supported configuration parameters:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>"urlPrefix" mandatory: defines the prefix for the per sender’s domain repository. For example for the value
-'cassandra://var/mail/sendersRepositories/', a mail sent by '<a href="mailto:user@james.org">user@james.org</a>' will be stored
-in 'cassandra://var/mail/sendersRepositories/james.org'.</p>
-</li>
-<li>
-<p>"passThrough" optional, defaults to false. If true, the processing of the mail continues. If false it stops.</p>
-</li>
-<li>
-<p>"allowRepositoryCreation" optional, defaults to true. If true, non existing repository will be created. In case of
-misconfiguration, this might lead to arbitrary repository creation. If false, the incoming mails will be stored only
- in already existing repository. If not existing, the email will be dropped with an appropriate log warning (leading
- to potential data loss). In case, you want to create a repository manually, make a http PUT request to
- /mailRepositories/encodedUrlOfTheRepository from web admin api.
- For example <a href="http://ip:port/mailRepositories/file%3A%2F%2FmailRepo" class="bare">http://ip:port/mailRepositories/file%3A%2F%2FmailRepo</a></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="ToSenderDomainRepository">
- <urlPrefix>cassandra://var/mail/sendersRepositories/</urlPrefix>
- <passThrough>false</passThrough>
- <allowRepositoryCreation>true</allowRepositoryCreation>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_vacationmailet"><a class="anchor" href="#_vacationmailet"></a>VacationMailet</h3>
-<div class="paragraph">
-<p>This mailet uses <a href="https://jmap.io/spec-mail.html#vacation-response">JMAP VacationResponse</a> and
-sends back a vacation notice to the sender if needed.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_withpriority"><a class="anchor" href="#_withpriority"></a>WithPriority</h3>
-<div class="paragraph">
-<p>This mailet sets the priority of the incoming mail.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="WithPriority">
- <priority>7</priority>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_withstoragedirective"><a class="anchor" href="#_withstoragedirective"></a>WithStorageDirective</h3>
-<div class="paragraph">
-<p>WithStorageDirective position storage directive for the recipients of this email.</p>
-</div>
-<div class="paragraph">
-<p>These directives are used by <strong>LocalDelivery</strong> mailet when adding the email to the recipients mailboxes.</p>
-</div>
-<div class="paragraph">
-<p>The following storage directives can be set:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>targetFolderName: the folder to append the email in. (compulsory)</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="IsMarkedAsSpam" class="WithStorageDirective">
- <targetFolderName>Spam</targetFolderName>
-</mailet></pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_experimental_mailets"><a class="anchor" href="#_experimental_mailets"></a>Experimental mailets</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_addhabeaswarrantmark"><a class="anchor" href="#_addhabeaswarrantmark"></a>AddHabeasWarrantMark</h3>
-<div class="paragraph">
-<p>This matcher adds the Hebeas Warrant Mark to a message.</p>
-</div>
-<div class="paragraph">
-<p>For details see: <a href="http://www.hebeas.com</p>" class="bare">http://www.hebeas.com</p></a>;</p>
-</div>
-<div class="paragraph">
-<p>Usage:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="AddHabeasWarrantMark" />;</pre>
-</div>
-</div>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-note" title="Note"></i>
-</td>
-<td class="content">
-Although this mailet is covered by the Apache Software License,
-the Habeas Warrant Mark is copyright. A separate license from Habeas
-is required in order to legally attach the Habeas Warrant Mark to
-e-mail messages. Each James Administrator is responsible for
-ensuring that James is configured to attach the Habeas Warrant Mark
-only to e-mail covered by a suitable license received from Habeas.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>Because the Habeas Warrant Mark is copyright material, I have asked
-for and received the following explicit statement from Habeas:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>-----------------------------------
-From: Lindsey Pettit [mailto:support@habeas.com]
-Sent: Sunday, September 29, 2002 5:51
-To: Noel J. Bergman
-Subject: RE: Habeas and Apache James
-*
-Dear Noel,
-*
-> FURTHERMORE, if James is to be capable of sending Habeas SWE, I need
-> to write a Mailet that attaches the headers. As with any MTA, it
-> would be up to the administrator to properly configure James and make
-> sure that licenses are acquired. Since the Habeas Warrant Mark is
-> copyright, I believe that I require authorization from you for that
-> Mailet, especially since it attaches the Habeas Warrant Mark. For my
-> own protection, please show me why such authorization is unnecessary,
-> send me a digitally signed e-mail, or FAX a signed authorization
-*
-You do not yourself need the authorization to build the functionality
-into the [mailet]; what one needs authorization, in the form of a
-license, for, is to use the mark *in headers*, in outgoing email.
-However, please let me know if you would like something more
-formal, and I can try to have something faxed to you.
-*
-> The Mailet docs would reference the Habeas website, and inform
-> administrators that in order to USE the mailet, they need to ensure
-> that they have whatever licenses are required from you as appropriate
-> to your licensing terms.
-*
-That's absolutely perfect!
------------------------------------</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_clamavscan"><a class="anchor" href="#_clamavscan"></a>ClamAVScan</h3>
-<div class="paragraph">
-<p>Does an antivirus scan check using a ClamAV daemon (CLAMD)</p>
-</div>
-<div class="paragraph">
-<p>Interacts directly with the daemon using the "stream" method,
-which should have the lowest possible overhead.</p>
-</div>
-<div class="paragraph">
-<p>The CLAMD daemon will typically reside on <strong>localhost</strong>, but could reside on a
-different host.
-It may also consist on a set of multiple daemons, each residing on a different
-server and on different IP number.
-In such case a DNS host name with multiple IP addresses (round-robin load sharing)
-is supported by the mailet (but on the same port number).</p>
-</div>
-<div class="paragraph">
-<p>Handles the following init parameters:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong><debug></strong></p>
-</li>
-<li>
-<p><strong><host></strong>: the host name of the server where CLAMD runs. It can either be
-a machine name, such as
-"<strong>java.sun.com</strong>", or a textual representation of its
-IP address. If a literal IP address is supplied, only the
-validity of the address format is checked.
-If the machine name resolves to multiple IP addresses, <strong>round-robin load sharing</strong> will
-be used.
-The default is <strong>localhost</strong>.</p>
-</li>
-<li>
-<p><strong><port></strong>: the port on which CLAMD listens. The default is <strong>3310</strong>.</p>
-</li>
-<li>
-<p><strong><maxPings></strong>: the maximum number of connection retries during startup.
-If the value is <strong>0</strong> no startup test will be done.
-The default is <strong>6</strong>.</p>
-</li>
-<li>
-<p><strong><pingIntervalMilli></strong>: the interval (in milliseconds)
-between each connection retry during startup.
-The default is <strong>30000</strong> (30 seconds).</p>
-</li>
-<li>
-<p><strong><streamBufferSize></strong>: the BufferedOutputStream buffer size to use
-writing to the <strong>stream connection</strong>. The default is <strong>8192</strong>.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The actions performed are as follows:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>During initialization:</p>
-</li>
-<li>
-<p>Gets all <strong>config.xml</strong> parameters, handling the defaults;</p>
-</li>
-<li>
-<p>resolves the <strong><host></strong> parameter, creating the round-robin IP list;</p>
-</li>
-<li>
-<p>connects to CLAMD at the first IP in the round-robin list, on
-the specified <strong><port></strong>;</p>
-</li>
-<li>
-<p>if unsuccessful, retries every <strong><pingIntervalMilli></strong> milliseconds up to
-<strong><maxPings></strong> times;</p>
-</li>
-<li>
-<p>sends a <strong>PING</strong> request;</p>
-</li>
-<li>
-<p>waits for a <strong>PONG</strong> answer;</p>
-</li>
-<li>
-<p>repeats steps 3-6 for every other IP resolved.</p>
-</li>
-<li>
-<p>For every mail</p>
-</li>
-<li>
-<p>connects to CLAMD at the "next" IP in the round-robin list, on
-the specified <strong><port></strong>, and increments the "next" index;
-if the connection request is not accepted tries with the next one
-in the list unless all of them have failed;</p>
-</li>
-<li>
-<p>sends a "<strong>STREAM</strong>" request;</p>
-</li>
-<li>
-<p>parses the "<strong>PORT *streamPort</strong>*" answer obtaining the port number;</p>
-</li>
-<li>
-<p>makes a second connection (the <strong>stream connection</strong>) to CLAMD at the same host (or IP)
-on the <strong>streamPort</strong> just obtained;</p>
-</li>
-<li>
-<p>sends the mime message to CLAMD (using {@link MimeMessage#writeTo(java.io.OutputStream)})
-through the <strong>stream connection</strong>;</p>
-</li>
-<li>
-<p>closes the <strong>stream connection</strong>;</p>
-</li>
-<li>
-<p>gets the "<strong>OK</strong>" or "<strong>…​ FOUND</strong>" answer from the main connection;</p>
-</li>
-<li>
-<p>closes the main connection;</p>
-</li>
-<li>
-<p>sets the "<strong>org.apache.james.infected</strong>" <strong>mail attribute</strong> to either
-"<strong>true</strong>" or "<strong>false</strong>";</p>
-</li>
-<li>
-<p>adds the "<strong>X-MessageIsInfected</strong>" <strong>header</strong> to either
-"<strong>true</strong>" or "<strong>false</strong>";</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Some notes regarding <a href="http://www.clamav.net/">clamav.conf</a> :</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>LocalSocket</strong> must be commented out</p>
-</li>
-<li>
-<p><strong>TCPSocket</strong> must be set to a port# (typically 3310)</p>
-</li>
-<li>
-<p><strong>StreamMaxLength</strong> must be >= the James config.xml parameter
-<*maxmessagesize*> in SMTP <*handler*></p>
-</li>
-<li>
-<p><strong>MaxThreads</strong> should? be >= the James config.xml parameter
-<*threads*> in <*spoolmanager*></p>
-</li>
-<li>
-<p><strong>ScanMail</strong> must be uncommented</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Here follows an example of config.xml definitions deploying CLAMD on localhost,
-and handling the infected messages:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><!-- Do an antivirus scan -->
-<mailet match="All" class="ClamAVScan" onMailetException="ignore"/>
-
-<!-- If infected go to virus processor -->
-<mailet match="HasMailAttributeWithValue=org.apache.james.infected, true" class="ToProcessor">
- <processor> virus </processor>
-</mailet>
-
-<!-- Check attachment extensions for possible viruses -->
-<mailet match="AttachmentFileNameIs=-d -z *.exe *.com *.bat *.cmd *.pif *.scr *.vbs *.avi *.mp3 *.mpeg *.shs" class="ToProcessor">
- <processor> bad-extensions </processor>
-</mailet></pre>
-</div>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><!-- Messages containing viruses -->
-<processor name="virus">
- <!-- To avoid a loop while bouncing -->
- <mailet match="All" class="SetMailAttribute">
- <org.apache.james.infected>true, bouncing</org.apache.james.infected>
- </mailet>
-
- <mailet match="SMTPAuthSuccessful" class="Bounce">
- <sender>bounce-admin@xxx.com</sender>
- <inline>heads</inline>
- <attachment>none</attachment>
- <notice> Warning: We were unable to deliver the message below because it was found infected by virus(es). </notice>
- </mailet>
-
- <mailet match="All" class="ToRepository">
- <repositoryPath>file://var/mail/infected/</repositoryPath>
- </mailet>
-
- <mailet match="All" class="Null" />
-</processor></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_classifybounce"><a class="anchor" href="#_classifybounce"></a>ClassifyBounce</h3>
-<div class="paragraph">
-<p>Assesses the message to determine if it was a hard or soft bounce, and if it was a soft bounce, something of its nature..</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="ClassifyBounce">
- <headerName>X-MailetHeader</headerName>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_fromrepository"><a class="anchor" href="#_fromrepository"></a>FromRepository</h3>
-<div class="paragraph">
-<p>Re-spools Mail found in the specified Repository.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="RecipientIs=respool@localhost" class="FromRepository">
- <repositoryPath> *repository path* </repositoryPath>
- <processor> *target processor* </repositoryPath>
- <delete&t; [true|<b>false</b>] </delete>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_headerstohttp"><a class="anchor" href="#_headerstohttp"></a>HeadersToHTTP</h3>
-<div class="paragraph">
-<p>Serialise the email and pass it to an HTTP call</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="HeadersToHTTP">
- <url>http://192.168.0.252:3000/alarm</url>
- <parameterKey>Test</parameterKey>
- <parameterValue>ParameterValue</parameterValue>
- <passThrough>true</passThrough>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_onlytext"><a class="anchor" href="#_onlytext"></a>OnlyText</h3>
-<div class="paragraph">
-<p>Keep only the text part of a message.</p>
-</div>
-<div class="paragraph">
-<p>If the message is text only then it doesn’t touch it, if it is a multipart it
-transform it a in plain text message with the first text part found.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>text/plain</p>
-</li>
-<li>
-<p>text/html ⇒ with a conversion to text only</p>
-</li>
-<li>
-<p>text/* as is.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_recoverattachment"><a class="anchor" href="#_recoverattachment"></a>RecoverAttachment</h3>
-<div class="paragraph">
-<p>This mailet takes an attachment stored in an attribute and attach it back to
-the message</p>
-</div>
-<div class="paragraph">
-<p>This may be used to place back attachment stripped by StripAttachment and
-stored in the attribute
-<strong>org.apache.james.mailet.standard.mailets.StripAttachment.saved</strong></p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> <mailet match="All" class="RecoverAttachment" >
- <attribute>my.attribute.name</attribute>
- </mailet ></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_serialisetohttp"><a class="anchor" href="#_serialisetohttp"></a>SerialiseToHTTP</h3>
-<div class="paragraph">
-<p>Serialise the email and pass it to an HTTP call</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="SerialiseToHTTP">
- <name>URL</name> <value>url where serialised message will be posted</value>
- <name>ParameterKey</name> <value>An arbitrary parameter be added to the post</value>
- <name>ParameterValue</name> <value>A value for the arbitrary parameter</value>
- <name>MessageKeyName</name> <value>Field name for the serialised message</value>
- <name>passThrough</name> <value>true or false</value>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_servertime"><a class="anchor" href="#_servertime"></a>ServerTime</h3>
-<div class="paragraph">
-<p>Returns the current time for the mail server.</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="RecipientIs=time@cadenza.lokitech.com" class="ServerTime"/></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_spf"><a class="anchor" href="#_spf"></a>SPF</h3>
-<div class="paragraph">
-<p>Check the ip, sender, helo against SPF. Add the following attributes to the
-mail object:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> org.apache.james.transport.mailets.spf.explanation
- org.apache.james.transport.mailets.spf.result</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="SPF">
- <addHeader>true</addHeader>
- <debug>false</debug>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_tosenderfolder"><a class="anchor" href="#_tosenderfolder"></a>ToSenderFolder</h3>
-<div class="literalblock">
-<div class="content">
-<pre>Receives a Mail from the Queue and takes care to deliver the message
- to a defined folder of the sender.</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You have to define the folder name of the sender.</p>
-</div>
-<div class="paragraph">
-<p>The flag 'consume' will tell is the mail will be further</p>
-</div>
-<div class="paragraph">
-<p>processed by the upcoming processor mailets, or not.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="RecipientIsLocal" class="ToSenderFolder">
- <folder> *Sent Items* </folder>
- <consume> *false* </consume>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_unwraptext"><a class="anchor" href="#_unwraptext"></a>UnwrapText</h3>
-<div class="paragraph">
-<p>Remove (best effort to) the hardcoded wrapping from a message.</p>
-</div>
-<div class="paragraph">
-<p>If the text is "format=flowed" then deflows the text. Otherwise it forces a dewrap of the text.</p>
-</div>
-<div class="paragraph">
-<p>Parameters:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>quotewidth - when we try to dewrap e quoted text it helps knowing the original
-with, so we can reconstruct "wrapped wraps" created by multiple wrappings by clients with
-different original width or simply to the add of the heading ">" that increase the line
-length.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The value should be "WIDTH+X" if the original length is known, "-X" otherwise.</p>
-</div>
-<div class="paragraph">
-<p>In the latter case the length of the longer line will be used.</p>
-</div>
-<div class="paragraph">
-<p>X is the tollerance needed for the quoting chars: if the original width is known the suggested
-value for X is 2 (because of "> " prefix), otherwise it is suggested to increase it to a value
-like 10 (-10)</p>
-</div>
-<div class="paragraph">
-<p>In summary, if the original wrap is known (for example 76, for flowed messages) <strong>quotewidth = 78</strong></p>
-</div>
-<div class="paragraph">
-<p>Otherwise <strong>quotewidth = -10</strong></p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_useheaderrecipients"><a class="anchor" href="#_useheaderrecipients"></a>UseHeaderRecipients</h3>
-<div class="paragraph">
-<p>Mailet designed to process the recipients from the mail headers rather
-than the recipients specified in the SMTP message header. This can be
-useful if your mail is redirected on-route by a mail server that
-substitutes a fixed recipient address for the original.</p>
-</div>
-<div class="paragraph">
-<p>To use this, match against the redirection address using the
-<strong>RecipientIs</strong> matcher and set the mailet 'class' to
-<strong>UseHeaderRecipients</strong>. This will cause the email to be
-re-injected into the root process with the recipient substituted
-by all the recipients in the Mail-For, To and Cc headers
-of the message.</p>
-</div>
-<div class="paragraph">
-<p>e.g.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="RecipientIs=forwarded@myhost" class="UseHeaderRecipients">
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_wraptext"><a class="anchor" href="#_wraptext"></a>WrapText</h3>
-<div class="paragraph">
-<p>Convert a message to format=flowed</p>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/configure/mailrepositorystore.html b/james-project/3.6.0/servers/distributed/configure/mailrepositorystore.html
deleted file mode 100644
index e2f3e10..0000000
--- a/james-project/3.6.0/servers/distributed/configure/mailrepositorystore.html
+++ /dev/null
@@ -1,596 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — mailrepositorystore.xml :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item is-current-page" data-depth="5">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Core components</li>
- <li><a href="mailrepositorystore.html">mailrepositorystore.xml</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="mailrepositorystore.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/configure/mailrepositorystore.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — mailrepositorystore.xml</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>A <code>mail repository</code> allows storage of a mail as part of its
-processing. Standard configuration relies on the following mail
-repository.</p>
-</div>
-<div class="paragraph">
-<p>A mail repository is identified by its <strong>url</strong>, constituted of a <strong>protocol</strong> and a <strong>path</strong>.</p>
-</div>
-<div class="paragraph">
-<p>For instance in the url <code>cassandra://var/mail/error/</code> <code>cassandra</code> is the protocol and <code>var/mail/error</code> the path.</p>
-</div>
-<div class="paragraph">
-<p>The <strong>mailrepositorystore.xml</strong> file allows registration of available protocols, and their binding to actual MailRepository
-implementation. Note that extension developers can write their own MailRepository implementations, load them via the
-<code>extensions-jars</code> mechanism as documented in <a href="../extending/index.html" class="xref page">'writing your own extensions'</a>, and finally
-associated to a protocol in <strong>mailrepositorystore.xml</strong> for a usage in <strong>mailetcontainer.xml</strong>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_configuration"><a class="anchor" href="#_configuration"></a>Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/mailrepositorystore.xml">example</a>
-to get some examples and hints.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailrepositorystore>
- <defaultProtocol>cassandra</defaultProtocol>
- <mailrepositories>
- <mailrepository class="org.apache.james.mailrepository.cassandra.CassandraMailRepository">
- <protocols>
- <protocol>cassandra</protocol>
- </protocols>
- </mailrepository>
- </mailrepositories>
-</mailrepositorystore></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Only the <strong>CassandraMailRepository</strong> is available by default for the Distributed Server. Mails metadata are stored in
-Cassandra while the headers and bodies are stored within the <a href="#distributed/architecture.adoc#_blobstore" class="xref unresolved">BlobStore</a>.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/configure/matchers.html b/james-project/3.6.0/servers/distributed/configure/matchers.html
deleted file mode 100644
index f9ee983..0000000
--- a/james-project/3.6.0/servers/distributed/configure/matchers.html
+++ /dev/null
@@ -1,1489 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Matchers :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item is-current-page" data-depth="5">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Core components</li>
- <li><a href="matchers.html">Packaged Matchers</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="matchers.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/configure/matchers.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Matchers</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This documentation page lists and documents Matchers that can be used within the
-Distributed Server MailetContainer in order to write your own mail processing logic with out-of-the-box components.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_supported_matchers"><a class="anchor" href="#_supported_matchers"></a>Supported matchers</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_all"><a class="anchor" href="#_all"></a>All</h3>
-<div class="paragraph">
-<p>Matches all mail.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_atleastpriority"><a class="anchor" href="#_atleastpriority"></a>AtLeastPriority</h3>
-<div class="paragraph">
-<p>Numeric value. The priority of this mail should be at least the specified value to be matched.</p>
-</div>
-<div class="paragraph">
-<p>Inclusive.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_atmost"><a class="anchor" href="#_atmost"></a>AtMost</h3>
-<div class="paragraph">
-<p>Checks that a mail did at most X executions on a specific operation.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> If no executions have been performed previously for Y attribute, it will be set up.
- In the mail, every time the check succeeds, its counter will be incremented by one.
-The check fails when the defined X limit is reached.</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>X - count of how many times a specific operation is performed</p>
-</li>
-<li>
-<p>Y - name of attribute represented for specific operation executions, default value is: <strong>AT_MOST_EXECUTIONS</strong></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The example below will match a mail with at most 3 executions on the mailet
-with attribute name <strong>AT_MOST_EXECUTIONS</strong></p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="AtMost=AT_MOST_EXECUTIONS:3" class="<any-class>">
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_atmostpriority"><a class="anchor" href="#_atmostpriority"></a>AtMostPriority</h3>
-<div class="paragraph">
-<p>Numeric value. The priority of this mail should be at most the specified value to be matched.</p>
-</div>
-<div class="paragraph">
-<p>Inclusive.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_fetchedfrom"><a class="anchor" href="#_fetchedfrom"></a>FetchedFrom</h3>
-<div class="paragraph">
-<p>Matches mail with a header set by Fetchpop X-fetched-from</p>
-</div>
-<div class="paragraph">
-<p>fetchpop sets X-fetched-by to the "name" of the fetchpop fetch task.</p>
-</div>
-<div class="paragraph">
-<p>This is used to match all mail fetched from a specific pop account.</p>
-</div>
-<div class="paragraph">
-<p>Once the condition is met the header is stripped from the message to prevent looping if
-the mail is re-inserted into the spool.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_hasattachment"><a class="anchor" href="#_hasattachment"></a>HasAttachment</h3>
-<div class="paragraph">
-<p>Checks whether this message has an attachment</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_hasexception"><a class="anchor" href="#_hasexception"></a>HasException</h3>
-<div class="paragraph">
-<p>This Matcher determines if the exception specified in the condition or
-the subclasses of it has occured during the processing of the mail.
-If true, all recipients are returned, else null. This matcher presupposes
-that the exception has been captured as a Mail attribute
-org.apache.mailet.Mail#MAILET_ERROR_ATTRIBUTE_NAME in the process.</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="HasException=org.apache.james.managesieve.api.ManageSieveException" class="<any-class>"></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_hasheader"><a class="anchor" href="#_hasheader"></a>HasHeader</h3>
-<div class="paragraph">
-<p>use:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="HasHeader={<header>[=value]}+" class="..." /></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>This matcher checks if the header is present in the message (global) and per recipient (specific). It complements the AddHeader mailet.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_hasheaderwithprefix"><a class="anchor" href="#_hasheaderwithprefix"></a>HasHeaderWithPrefix</h3>
-<div class="paragraph">
-<p>Matches emails with headers having a given prefix.</p>
-</div>
-<div class="paragraph">
-<p>If a header with the given prefix is found in the message (global) all recipients will be matched.
-If a header with the given prefix is found per recipient (specific), only these will be matched.</p>
-</div>
-<div class="paragraph">
-<p>Otherwise, no recipient in returned.</p>
-</div>
-<div class="paragraph">
-<p>use:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="HasHeaderWithPrefix=PREFIX" class="..." /></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_hasmailattribute"><a class="anchor" href="#_hasmailattribute"></a>HasMailAttribute</h3>
-<div class="paragraph">
-<p>This Matcher determines if the mail contains the attribute specified in the
-condition, and returns all recipients if it is the case.</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="HasMailAttribute=whatever" class="<any-class>"></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_hasmailattributewithvalue"><a class="anchor" href="#_hasmailattributewithvalue"></a>HasMailAttributeWithValue</h3>
-<div class="paragraph">
-<p>This Matcher determines if the mail contains the attribute specified in
-the condition and if the value answered when the method toString() is
-invoked on the attribute is equal to the String value specified in the
-condition. If both tests are true, all recipients are returned, else null.</p>
-</div>
-<div class="paragraph">
-<p>Notes:</p>
-</div>
-<div class="paragraph">
-<p>The current matcher implementation expects a single String value to match
-on. This matcher requires two values, the attribute name and attribute
-value. This requires some implicit rules to govern how the single value
-supplied to the matcher is parsed into two values.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>In the match condition, the split between the attribute name and the
-attribute value is made at the first comma. Attribute names that include
-a comma will parse incorrectly and therefore are not supported by this
-matcher.</p>
-</li>
-<li>
-<p>Leading and trailing spaces are removed from both the attribute name and
-attribute value specified in the condition and the tested attribute value in
-the mail prior to matching. Therefore, "abc" , " abc", "abc " and " abc "
-are considered equivalent.</p>
-</li>
-<li>
-<p>To test for an empty string, do not specify an attribute value after the
-comma.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="HasMailAttributeWithValue=name, value" class="<any-class>"></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_hasmailattributewithvalueregex"><a class="anchor" href="#_hasmailattributewithvalueregex"></a>HasMailAttributeWithValueRegex</h3>
-<div class="paragraph">
-<p>This Matcher determines if the mail contains the attribute specified in the
-condition and that attribute matches the supplied regular expression,
-it returns all recipients if that is the case.</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="HasMailAttributeWithValueRegex=whatever,<regex>" class="<any-class>"></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note: as it is not possible to put arbitrary objects in the configuration,
-toString() is called on the attribute value, and that is the value matched against.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_hasmimetype"><a class="anchor" href="#_hasmimetype"></a>HasMimeType</h3>
-<div class="paragraph">
-<p>This matcher checks if the content type matches.</p>
-</div>
-<div class="paragraph">
-<p>use:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="HasMimeType=text/plain,text/html" class="..." /></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_hasmimetypeparameter"><a class="anchor" href="#_hasmimetypeparameter"></a>HasMimeTypeParameter</h3>
-<div class="paragraph">
-<p>This matcher checks if the content type parameters matches.</p>
-</div>
-<div class="paragraph">
-<p>use:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="HasMimeTypeParameter=report-type=disposition-notification,report-type=other" class="..." /></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_haspriority"><a class="anchor" href="#_haspriority"></a>HasPriority</h3>
-<div class="paragraph">
-<p>Numeric value. The priority of this mail should be equal to the specified value to be matched.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_hostis"><a class="anchor" href="#_hostis"></a>HostIs</h3>
-<div class="paragraph">
-<p>Matches mail to given hosts.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_hostislocal"><a class="anchor" href="#_hostislocal"></a>HostIsLocal</h3>
-<div class="paragraph">
-<p>Matches mail to Domains which are local</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_ismarkedasspam"><a class="anchor" href="#_ismarkedasspam"></a>IsMarkedAsSpam</h3>
-<div class="paragraph">
-<p>Matches mails having a <strong>org.apache.james.spamassassin.status</strong> per recipient header with a <strong>Yes</strong> value.</p>
-</div>
-<div class="paragraph">
-<p>As an example, here is a part of a mailet pipeline which can be used in your LocalDelivery processor:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><!-- SpamAssassing mailets pipeline -->
- <mailet match="RecipientIsLocal" class="SpamAssassin">
- <spamdHost>spamassassin</spamdHost>
- <spamdPort>783</spamdPort>
- </mailet>
- <mailet match="IsMarkedAsSpam" class="WithStorageDirective">
- <targetFolderName>Spam</targetFolderName>
- </mailet>
-<!-- End of SpamAssassing mailets pipeline --></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_isoverquota"><a class="anchor" href="#_isoverquota"></a>IsOverQuota</h3>
-<div class="paragraph">
-<p>This matcher will check if the incoming email will make recipients exceed their quotas.</p>
-</div>
-<div class="paragraph">
-<p>Here is a configuration example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="IsOverQuota" class="<any-class>"/></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_isremotedeliverypermanenterror"><a class="anchor" href="#_isremotedeliverypermanenterror"></a>IsRemoteDeliveryPermanentError</h3>
-<div class="paragraph">
-<p>Checks if the mail has a permanent remote delivery failure attribute</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="IsRemoteDeliveryPermanentError" class="<any-class>"/></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_isremotedeliverypermanenterror_2"><a class="anchor" href="#_isremotedeliverypermanenterror_2"></a>IsRemoteDeliveryPermanentError</h3>
-<div class="paragraph">
-<p>Checks if the mail has a temporary remote delivery failure attribute set to false (meaning it’s a temporary error)</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="IsRemoteDeliveryTemporaryError" class="<any-class>"/></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_issenderinrrtloop"><a class="anchor" href="#_issenderinrrtloop"></a>IsSenderInRRTLoop</h3>
-<div class="paragraph">
-<p>This matcher allow you to know if the sender of an email is part of a RRT loop.</p>
-</div>
-<div class="paragraph">
-<p>This is useful when bouncing upon RRT execution issues: we don’t want to create a bouncing loop
-(as the execution of that RRT loop will fail).</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="IsSenderInRRTLoop" class="<any-class>"/></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_issinglerecipient"><a class="anchor" href="#_issinglerecipient"></a>IsSingleRecipient</h3>
-<div class="paragraph">
-<p>Matches mail where the number of recipients is exactly one.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_issmimeencrypted"><a class="anchor" href="#_issmimeencrypted"></a>IsSMIMEEncrypted</h3>
-<div class="paragraph">
-<p>Checks if a mail is smime encrypted.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_issmimesigned"><a class="anchor" href="#_issmimesigned"></a>IsSMIMESigned</h3>
-<div class="paragraph">
-<p>Checks if a mail is smime encrypted.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_isx509certificatesubject"><a class="anchor" href="#_isx509certificatesubject"></a>IsX509CertificateSubject</h3>
-<div class="paragraph">
-<p>Checks if the subject of a X509Certificate contains the supplied string. The
-certificate is read from the specified mail attribute.</p>
-</div>
-<div class="paragraph">
-<p>If the specified attribute contains more than one certificate the matcher matches if at
-least one of the certificates contains the given string.</p>
-</div>
-<div class="paragraph">
-<p>Configuration string:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>mailAttribute;string</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_recipientdomainis"><a class="anchor" href="#_recipientdomainis"></a>RecipientDomainIs</h3>
-<div class="paragraph">
-<p>This will return recipients matching a configured domain.</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="RecipientDomainIs=<domain.com>" class="<any-class>"/></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_recipientis"><a class="anchor" href="#_recipientis"></a>RecipientIs</h3>
-<div class="paragraph">
-<p>This matcher matches a specific recipient (in the envelope of the mail), passed as a condition to
-this matcher.</p>
-</div>
-<div class="paragraph">
-<p>The example below will match only the recipient user@domain</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match=&quot;RecipientIs=user@domain&quot; class=&quot;<any-class>&quot;>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_recipientislocal"><a class="anchor" href="#_recipientislocal"></a>RecipientIsLocal</h3>
-<div class="paragraph">
-<p>Matches mail where the recipient is local.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_recipientisregex"><a class="anchor" href="#_recipientisregex"></a>RecipientIsRegex</h3>
-<div class="paragraph">
-<p>Matches recipients whose address matches a regular expression.</p>
-</div>
-<div class="paragraph">
-<p>Is equivalent to the SenderIsRegex matcher but matching on the recipient.</p>
-</div>
-<div class="paragraph">
-<p>Configuration string: a regular expression.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="RecipientIsRegex=<regular-expression>" class="<any-class>"></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The example below will match any recipient in the format user@log.anything</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="RecipientIsRegex=(.*)@log\.(.*)" class="<any-class>">
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_relaylimit"><a class="anchor" href="#_relaylimit"></a>RelayLimit</h3>
-<div class="paragraph">
-<p>Matches mail which has been relayed more than a given number of times.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_remoteaddrinnetwork"><a class="anchor" href="#_remoteaddrinnetwork"></a>RemoteAddrInNetwork</h3>
-<div class="paragraph">
-<p>Checks the IP address of the sending server against a comma- delimited list
-of IP addresses, domain names or sub-nets.</p>
-</div>
-<div class="paragraph">
-<p>See AbstractNetworkMatcher for details on how to specify entries.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_remoteaddrinnetwork_2"><a class="anchor" href="#_remoteaddrinnetwork_2"></a>RemoteAddrInNetwork</h3>
-<div class="paragraph">
-<p>Checks the IP address of the sending server against a comma- delimited list
-of IP addresses, domain names or sub-nets.</p>
-</div>
-<div class="paragraph">
-<p>See AbstractNetworkMatcher for details on how to specify entries.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_remotedeliveryfailedwithsmtpcode"><a class="anchor" href="#_remotedeliveryfailedwithsmtpcode"></a>RemoteDeliveryFailedWithSMTPCode</h3>
-<div class="paragraph">
-<p>Checks the SMTP error code attached to remote delivery failures</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_senderdomainis"><a class="anchor" href="#_senderdomainis"></a>SenderDomainIs</h3>
-<div class="paragraph">
-<p>SenderDomainIs will look at the envelope sender’s domain. If equal to
-configured value, then all recipients will be returned. Otherwise an empty
-list will be returned.</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="SenderDomainIs=<domain.com>" class="<any-class>"></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_senderhostis"><a class="anchor" href="#_senderhostis"></a>SenderHostIs</h3>
-<div class="paragraph">
-<p>Checks the sender’s displayed domain name against a supplied list.</p>
-</div>
-<div class="paragraph">
-<p>Sample configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="SenderHostIs=domain.com" class="ToProcessor">
- <processor> spam </processor>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_senderis"><a class="anchor" href="#_senderis"></a>SenderIs</h3>
-<div class="paragraph">
-<p>This matcher matches a specific sender, passed as a condition to this matcher.</p>
-</div>
-<div class="paragraph">
-<p>The example below will match mail with a sender being user@domain</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="SenderIs=user@domain" class="<any-class>">
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_senderislocal"><a class="anchor" href="#_senderislocal"></a>SenderIsLocal</h3>
-<div class="paragraph">
-<p>Matches mail where the sender is local.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_senderisnull"><a class="anchor" href="#_senderisnull"></a>SenderIsNull</h3>
-<div class="paragraph">
-<p>Matches mails that are sent by a null sender.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="SenderIsNull" class="<any-class>"></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_senderisregex"><a class="anchor" href="#_senderisregex"></a>SenderIsRegex</h3>
-<div class="paragraph">
-<p>Matches mails that are sent by a sender whose address matches a regular expression.</p>
-</div>
-<div class="paragraph">
-<p>Is equivalent to the RecipientIsRegex matcher but matching on the sender.</p>
-</div>
-<div class="paragraph">
-<p>Configuration string: a regular expression.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="SenderIsRegex=<regular-expression>" class="<any-class>"></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The example below will match any sender in the format user@log.anything</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="SenderIsRegex=(.*)@log\.(.*)" class="<any-class>">
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Another example below will match any sender having some variations of the string
-<strong>mp3</strong> inside the username part.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="SenderIsRegex=(.*)(mp3|emmepitre)(.*)@" class="<any-class>">
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_sentbyjmap"><a class="anchor" href="#_sentbyjmap"></a>SentByJmap</h3>
-<div class="paragraph">
-<p>Matches mails sent via the JMAP protocol.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_sentbymailet"><a class="anchor" href="#_sentbymailet"></a>SentByMailet</h3>
-<div class="paragraph">
-<p>This matcher matches email sent automatically by mailets.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="SentByMailetAny" class="<any-class>"/></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>This matcher allows you, for instance, to enable/disable routing automatically generated emails out of your server.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_sizegreaterthan"><a class="anchor" href="#_sizegreaterthan"></a>SizeGreaterThan</h3>
-<div class="paragraph">
-<p>Checks whether the message (entire message, not just content) is greater
-than a certain number of bytes. You can use 'k' and 'm' as optional postfixes.</p>
-</div>
-<div class="paragraph">
-<p>In other words, "1m" is the same as writing "1024k", which is the same as
-"1048576".</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_smtpauthsuccessful"><a class="anchor" href="#_smtpauthsuccessful"></a>SMTPAuthSuccessful</h3>
-<div class="paragraph">
-<p>Matches mails that are sent by an SMTP authenticated user.</p>
-</div>
-<div class="paragraph">
-<p>If the sender was not authenticated it will not match.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="SMTPAuthSuccessful" class="<any-class>"></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_smtpauthuseris"><a class="anchor" href="#_smtpauthuseris"></a>SMTPAuthUserIs</h3>
-<div class="paragraph">
-<p>Matches mails that are sent by an SMTP authenticated user present in a supplied list.</p>
-</div>
-<div class="paragraph">
-<p>If the sender was not authenticated it will not match.</p>
-</div>
-<div class="paragraph">
-<p>Configuration string: a comma, tab or space separated list of James users.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="SMTPAuthUserIs=<list-of-user-names>" class="<any-class>"></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_smtpisauthnetwork"><a class="anchor" href="#_smtpisauthnetwork"></a>SMTPIsAuthNetwork</h3>
-<div class="paragraph">
-<p>Matches mails that are sent by an client which is allowed to relay.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="SMTPIsAuthNetwork" class="<any-class>"></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_subjectis"><a class="anchor" href="#_subjectis"></a>SubjectIs</h3>
-<div class="paragraph">
-<p>Matches mail where the subject is contained in a configurable list.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_subjectis_2"><a class="anchor" href="#_subjectis_2"></a>SubjectIs</h3>
-<div class="paragraph">
-<p>Matches mail where the subject starts with a given phrase.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_toomanyrecipients"><a class="anchor" href="#_toomanyrecipients"></a>TooManyRecipients</h3>
-<div class="paragraph">
-<p>This matcher matches emails that have too many recipients.</p>
-</div>
-<div class="paragraph">
-<p>The example below will reject any email with more than 5 recipients</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="TooManyRecipients=5" class="<any-class&gt;"></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_useris"><a class="anchor" href="#_useris"></a>UserIs</h3>
-<div class="paragraph">
-<p>Matches mail where the user is contained in a configurable list.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_xoriginatingipinnetwork"><a class="anchor" href="#_xoriginatingipinnetwork"></a>XOriginatingIpInNetwork</h3>
-<div class="paragraph">
-<p>Checks the first X_ORIGINATING_IP IP address against a comma-delimited list
-of IP addresses, domain names or sub-nets.</p>
-</div>
-<div class="paragraph">
-<p>See AbstractNetworkMatcher for details on how to specify entries.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_experimental_matchers"><a class="anchor" href="#_experimental_matchers"></a>Experimental matchers</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_attachmentfilenameis"><a class="anchor" href="#_attachmentfilenameis"></a>AttachmentFileNameIs</h3>
-<div class="paragraph">
-<p>Checks if at least one attachment has a file name which matches any
-element of a comma-separated or space-separated list of file name masks.</p>
-</div>
-<div class="paragraph">
-<p>Syntax: <strong>match="AttachmentFileNameIs=[-d] [-z] masks"</strong></p>
-</div>
-<div class="paragraph">
-<p>The match is case insensitive.</p>
-</div>
-<div class="paragraph">
-<p>File name masks may start with a wildcard '\*'.</p>
-</div>
-<div class="paragraph">
-<p>Multiple file name masks can be specified, e.g.: '*.scr,\*.bat'.</p>
-</div>
-<div class="paragraph">
-<p>If '<strong>-d</strong>' is coded, some debug info will be logged.</p>
-</div>
-<div class="paragraph">
-<p>If '<strong>-z</strong>' is coded, the check will be non-recursively applied
-to the contents of any attached '*.zip' file.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_commandforlistserv"><a class="anchor" href="#_commandforlistserv"></a>CommandForListserv</h3>
-<div class="paragraph">
-<p>Returns positive if the recipient is a command for a listserv. For example,
-if my listserv is <a href="mailto:james@list.working-dogs.com">james@list.working-dogs.com</a>, this matcher will return true
-for <a href="mailto:james-on@list.working-dogs.com">james-on@list.working-dogs.com</a> and <a href="mailto:james-off@list.working-dogs.com">james-off@list.working-dogs.com</a>.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_commandlistservmatcher"><a class="anchor" href="#_commandlistservmatcher"></a>CommandListservMatcher</h3>
-<div class="paragraph">
-<p>CommandListservMatcher is the matcher that pairs with the CommandListservManager
-It checks to see if the request is intended for the ListservManager, but doesn’t guarantee that it is a valid command.</p>
-</div>
-<div class="paragraph">
-<p>To configure, insert this into the config.xml inside of the root processor block.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="CommandListservMatcher=announce@localhost" class="CommandListservManager">
-...
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_comparenumericheadervalue"><a class="anchor" href="#_comparenumericheadervalue"></a>CompareNumericHeaderValue</h3>
-<div class="paragraph">
-<p>Matches mails containing a header with a numeric value whose comparison with the specified value is true.</p>
-</div>
-<div class="paragraph">
-<p>If the header is missing in the message, there will be <strong>no match</strong></p>
-</div>
-<div class="paragraph">
-<p>Configuration string: The headerName, a comparison operator and the numeric headerValue
-to compare with, <strong>space or tab delimited</strong>.</p>
-</div>
-<div class="paragraph">
-<p>The comparison operators are: <strong><, ⇐, ==, >=, ></strong>;
-another set of operators is: <strong>LT, LE, EQ, GE, GT</strong>.</p>
-</div>
-<div class="paragraph">
-<p>Also the following operators are accepted: <strong>=<, =, ⇒</strong>.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="CompareNumericHeaderValue=X-MessageIsSpamProbability > 0.9" class="ToProcessor">
- <processor> spam </processor>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_fileregexmatcher"><a class="anchor" href="#_fileregexmatcher"></a>FileRegexMatcher</h3>
-<div class="paragraph">
-<p>Initializes RegexMatcher with regular expressions from a file.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_hashabeaswarrantmark"><a class="anchor" href="#_hashabeaswarrantmark"></a>HasHabeasWarrantMark</h3>
-<div class="paragraph">
-<p>This matcher tests for the Hebeas Warrant Mark.
-For details see: <a href="http://www.hebeas.com" class="bare">http://www.hebeas.com</a></p>
-</div>
-<div class="paragraph">
-<p>Usage: Place this matcher</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="HasHabeasWarrantMark" class="ToProcessor">
- <processor> transport </processor>
-</mailet></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>in the root processs before the DNSRBL block lists (the InSpammerBlacklist matcher).</p>
-</div>
-<div class="paragraph">
-<p>Because the Habeas Warrant Mark is copyright material, I have asked for and
-received the following explicit statement from Habeas:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>-----------------------------------
-From: Lindsey Pettit [mailto:support@habeas.com]
-Sent: Sunday, September 29, 2002 5:51
-To: Noel J. Bergman
-Subject: RE: Habeas and Apache James
-
-Dear Noel,
-
-> I guess that since your Warrant Mark is copyright, I should ask for
-> something from you to explicitly authorize that Hebeas will permit
-> this code to be included and distributed as part of Apache James
-> under the Apache Software License. As we have established, the use
-> of the Habeas Warrant Mark for filtering is not restricted, but I
-> would like something to confirm that, so that Apache will be happy.
-
-I can hereby confirm to you that there is no license necessary in
-order to use the Habeas mark for filtering. That said, however, we
-do insist that it not ever be used as a basis for rejecting email which
-bears the Habeas mark.
------------------------------------</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_inspammerblacklist"><a class="anchor" href="#_inspammerblacklist"></a>InSpammerBlacklist</h3>
-<div class="paragraph">
-<p>Checks the network IP address of the sending server against a blacklist of
-spammers. There are 3 lists that support this…​</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>blackholes.mail-abuse.org</strong>: Rejected - see <a href="http://www.mail-abuse.org/rbl/" class="bare">http://www.mail-abuse.org/rbl/</a></p>
-</li>
-<li>
-<p><strong>dialups.mail-abuse.org</strong>: Dialup - see <a href="http://www.mail-abuse.org/dul/" class="bare">http://www.mail-abuse.org/dul/</a></p>
-</li>
-<li>
-<p><strong>relays.mail-abuse.org</strong>: Open spam relay - see <a href="http://www.mail-abuse.org/rss/" class="bare">http://www.mail-abuse.org/rss/</a></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="InSpammerBlacklist=blackholes.mail-abuse.org." class="ToProcessor">
- <processor>spam</processor>
-</mailet></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_nesspamcheck"><a class="anchor" href="#_nesspamcheck"></a>NESSpamCheck</h3>
-<div class="paragraph">
-<p>This is based on a sample filter.cfg for a Netscape Mail Server to stop
-spam.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_senderinfakedomain"><a class="anchor" href="#_senderinfakedomain"></a>SenderInFakeDomain</h3>
-<div class="paragraph">
-<p>Does a DNS lookup (MX and A/CNAME records) on the sender’s domain. If there
-are no entries, the domain is considered fake and the match is successful.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_composite_matchers"><a class="anchor" href="#_composite_matchers"></a>Composite matchers</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>It is possible to combine together matchers in order to create a composite matcher, thus simplifying your
-Mailet Container logic.</p>
-</div>
-<div class="paragraph">
-<p>Here are the available logical operations:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>And</strong> : This matcher performs And conjunction between the two matchers: recipients needs to match both matcher in order to
-match the composite matcher.</p>
-</li>
-<li>
-<p><strong>Or</strong> : This matcher performs Or conjunction between the two matchers: consider it to be a union of the results.
-It returns recipients from the Or composition results of the child matchers.</p>
-</li>
-<li>
-<p><strong>Not</strong> : It returns recipients from the negated composition of the child Matcher(s). Consider what wasn’t
-in the result set of each child matcher. Of course it is easier to understand if it only
-includes one matcher in the composition, the normal recommended use.</p>
-</li>
-<li>
-<p><strong>Xor</strong> : It returns Recipients from the Xor composition of the child matchers. Consider it to be the inequality
-operator for recipients. If any recipients match other matcher results
-then the result does not include that recipient.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Here is the syntax to adopt in <strong>mailetcontainer.xml</strong>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><processor state="transport" enableJmx="true">
- <matcher name="relay-allowed" match="org.apache.james.mailetcontainer.impl.matchers.Or">
- <matcher match="SMTPAuthSuccessful"/>
- <matcher match="SentByMailet"/>
- <matcher match="org.apache.james.jmap.mailet.SentByJmap"/>
- <matcher match="RemoteAddrInNetwork=127.0.0.1, 10.2.*, 193.50.151.*"/>
- </matcher>
-
- <!-- ... -->
-
- <mailet match="relay-allowed" class="ToProcessor">
- <processor>relay</processor>
- </mailet>
-</processor></pre>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/configure/pop3.html b/james-project/3.6.0/servers/distributed/configure/pop3.html
deleted file mode 100644
index 18bcde6..0000000
--- a/james-project/3.6.0/servers/distributed/configure/pop3.html
+++ /dev/null
@@ -1,626 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — pop3server.xml :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item is-current-page" data-depth="5">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Protocols</li>
- <li><a href="pop3.html">pop3server.xml</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="pop3.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/configure/pop3.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — pop3server.xml</h1>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/pop3server.xml">example</a>
-to get some examples and hints.</p>
-</div>
-<div class="paragraph">
-<p>The POP3 service is controlled by a configuration block in the pop3server.xml.
-The pop3server tag defines the boundaries of the configuration block. It encloses
-all the relevant configuration for the POP3 server. The behavior of the POP service is
-controlled by the attributes and children of this tag.</p>
-</div>
-<div class="paragraph">
-<p>This tag has an optional boolean attribute - <strong>enabled</strong> - that defines whether the service is active or not.
-The value defaults to "true" if not present.</p>
-</div>
-<div class="paragraph">
-<p>The standard children of the pop3server tag are:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. jmx.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">bind</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure this to bind to a specific inetaddress. This is an optional integer value.
-This value is the port on which this POP3 server is configured
-to listen. If the tag or value is absent then the service
-will bind to all network interfaces for the machine If the tag or value is omitted,
-the value will default to the standard POP3 port, 11
-port 995 is the well-known/IANA registered port for POP3S ie over SSL/TLS
-port 110 is the well-known/IANA registered port for Standard POP3</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connectionBacklog</p></td>
-<td class="tableblock halign-left valign-top"></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tls</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set to true to support STARTTLS or SSL for the Socket.
-To create a new keystore execute:
-<code>keytool -genkey -alias james -keyalg RSA -keystore /path/to/james/conf/keystore</code>
-Please note that each POP3 server exposed on different port can specify its own keystore, independently from any other
-TLS based protocols. Read <a href="ssl.html" class="xref page">SSL configuration page</a> for more information.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">handler.helloName</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">This is the name used by the server to identify itself in the POP3
-protocol. If autodetect is TRUE, the server will discover its
-own host name and use that in the protocol. If discovery fails,
-the value of 'localhost' is used. If autodetect is FALSE, James
-will use the specified value.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">handler.connectiontimeout</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Connection timeout in seconds</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">handler.connectionLimit</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum simultaneous incoming connections for this service</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">handler.connectionLimitPerIP</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum simultaneous incoming connections per IP for this service</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">handler.handlerchain</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">This loads the core CommandHandlers. Only remove this if you really know what you are doing.</p></td>
-</tr>
-</tbody>
-</table>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/configure/rabbitmq.html b/james-project/3.6.0/servers/distributed/configure/rabbitmq.html
deleted file mode 100644
index 3cf42ef..0000000
--- a/james-project/3.6.0/servers/distributed/configure/rabbitmq.html
+++ /dev/null
@@ -1,748 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — rabbitmq.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item is-current-page" data-depth="5">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Storage dependencies</li>
- <li><a href="rabbitmq.html">rabbitmq.properties</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="rabbitmq.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/configure/rabbitmq.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — rabbitmq.properties</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This configuration helps you configure components using RabbitMQ.</p>
-</div>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/rabbitmq.properties">example</a>
-to get some examples and hints.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_rabbitmq_configuration"><a class="anchor" href="#_rabbitmq_configuration"></a>RabbitMQ Configuration</h2>
-<div class="sectionbody">
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. rabbitmq.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">uri</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">the amqp URI pointing to RabbitMQ server. Details about amqp URI format is in <a href="https://www.rabbitmq.com/uri-spec.html">RabbitMQ URI Specification</a></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">management.uri</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">the URI pointing to RabbitMQ Management Service. James need to retrieve some information about listing queues
-from this service in runtime.
-Details about URI format is in <a href="https://www.rabbitmq.com/management.html#usage-ui">RabbitMQ Management URI</a></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">management.user</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">username used to access management service</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">management.password</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">password used to access management service</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connection.pool.retries</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure retries count to retrieve a connection. Exponential backoff is performed between each retries.
-Optional integer, defaults to 10</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connection.pool.min.delay.ms</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure initial duration (in ms) between two connection retries. Exponential backoff is performed between each retries.
-Optional integer, defaults to 100</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">channel.pool.retries</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure retries count to retrieve a channel. Exponential backoff is performed between each retries.
-Optional integer, defaults to 3</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">channel.pool.min.delay.ms</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure initial duration (in ms) between two channel retries. Exponential backoff is performed between each retries.
-Optional integer, defaults to 50</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">channel.pool.size</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure the size of the channel pool.
-Optional integer, defaults to 3</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ssl.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Is using ssl enabled
-Optional boolean, defaults to false</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ssl.management.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Is using ssl on management api enabled
-Optional boolean, defaults to false</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ssl.validation.strategy</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure the validation strategy used for rabbitmq connections. Possible values are default, ignore and override.
-Optional string, defaults to using systemwide ssl configuration</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ssl.truststore</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Points to the truststore (PKCS12) used for verifying rabbitmq connection. If configured then "ssl.truststore.password" must also be configured,
-Optional string, defaults to systemwide truststore. "ssl.validation.strategy: override" must be configured if you want to use this</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ssl.truststore.password</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure the truststore password. If configured then "ssl.truststore" must also be configured,
-Optional string, defaults to empty string. "ssl.validation.strategy: override" must be configured if you want to use this</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ssl.hostname.verifier</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure host name verification. Possible options are default and accept_any_hostname
-Optional string, defaults to subject alternative name host verifier</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ssl.keystore</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Points to the keystore(PKCS12) used for client certificate authentication. If configured then "ssl.keystore.password" must also be configured,
-Optional string, defaults to empty string</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ssl.keystore.password</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Configure the keystore password. If configured then "ssl.keystore" must also be configured,
-Optional string, defaults to empty string</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_rabbitmq_mailqueue_configuration"><a class="anchor" href="#_rabbitmq_mailqueue_configuration"></a>RabbitMQ MailQueue Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>James mail queue is a component acting like a queue where it can enqueue and dequeue mails.
-Beside of the basic features, it also allows some extra operations like getting size, browsing all items in the mail queue…​
-One of the mailqueue implementation is using RabbitMQ.
-As RabbitMQ doesn’t offer enough features to implement efficiently all mailqueue operations,
-this implementation relies on Cassandra.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 2. rabbitmq.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailqueue.view.sliceWindow</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">James divides the view into slices, each slice contains data for a given period, sliceWindow parameter controls this period.
-This dividing of periods allows faster browsing of the mail queue. Tips for choosing sliceWindow are explained in
-<a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/rabbitmq.properties">rabbitmq.properties</a></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailqueue.view.bucketCount</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Mails in a mail queue are distributed across the underlying storage service.
-BucketCount describes how to be distributing mails to fit with your James setup
-Tips for choosing bucketCount are explained in
-<a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/rabbitmq.properties">rabbitmq.properties</a></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailqueue.view.updateBrowseStartPace</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">To browse, James needs a starting point and to continuously update that point in runtime.
-UpdateBrowseStartPace describes the probability to update the starting point.
-Tips for choosing updateBrowseStartPace are explained in
-<a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/rabbitmq.properties">rabbitmq.properties</a></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mailqueue.size.metricsEnabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">By default, the metrics are disabled for the mail queue size.
-As computing the size of the mail queue is currently implemented on top of browse operation and thus has a linear complexity,
-sometimes it can get too big, making it impossible for the ES reporter to handle it correctly without crashing.
-It can be useful then to disable it.
-Tips for choosing metricsEnabled are explained in
-<a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/rabbitmq.properties">rabbitmq.properties</a></p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_rabbitmq_tasks_configuration"><a class="anchor" href="#_rabbitmq_tasks_configuration"></a>RabbitMQ Tasks Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Tasks are WebAdmin triggered long running jobs. RabbitMQ is used to organise their execution in a work queue,
-with an exclusive consumer.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 3. rabbitmq.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">task.consumption.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Whether to enable task consumption on this node.
-Disable with caution (this only makes sense in a distributed setup where other nodes consume tasks).
-Defaults to true.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/configure/recipientrewritetable.html b/james-project/3.6.0/servers/distributed/configure/recipientrewritetable.html
deleted file mode 100644
index fec5924..0000000
--- a/james-project/3.6.0/servers/distributed/configure/recipientrewritetable.html
+++ /dev/null
@@ -1,578 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — recipientrewritetable.xml :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item is-current-page" data-depth="5">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Core components</li>
- <li><a href="recipientrewritetable.html">recipientrewritetable.xml</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="recipientrewritetable.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/configure/recipientrewritetable.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — recipientrewritetable.xml</h1>
-<div class="paragraph">
-<p>Here are explanations on the different kinds about <a href="#distributed/architecture.adoc#_recipient_rewrite_tables" class="xref unresolved">recipient rewritting</a>.</p>
-</div>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/recipientrewritetable.xml">example</a>
-to get some examples and hints.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. recipientrewritetable.xml</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">recursiveMapping</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">If set to false only the first mapping will get processed - Default true.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">mappingLimit</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">By setting the mappingLimit you can specify how much mapping will get processed before a bounce will send. This avoids infinity loops. Default 10.</p></td>
-</tr>
-</tbody>
-</table>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/configure/remote-delivery-error-handling.html b/james-project/3.6.0/servers/distributed/configure/remote-delivery-error-handling.html
deleted file mode 100644
index f868cea..0000000
--- a/james-project/3.6.0/servers/distributed/configure/remote-delivery-error-handling.html
+++ /dev/null
@@ -1,732 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — About RemoteDelivery error handling :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item is-current-page" data-depth="5">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Extensions</li>
- <li><a href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="remote-delivery-error-handling.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/configure/remote-delivery-error-handling.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — About RemoteDelivery error handling</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>The advanced server mailQueue implemented by combining RabbitMQ for messaging and Cassandra for administrative operation
-does not support delays.</p>
-</div>
-<div class="paragraph">
-<p>Delays are an important feature for Mail Exchange servers, allowing to defer in time the retries, potentially letting the
-time for the remote server to recover. Furthermore, they enable implementation of advanced features like throttling and
-rate limiting of emails sent to a given domain.</p>
-</div>
-<div class="paragraph">
-<p>As such, the use of the distributed server as a Mail Exchange server is currently discouraged.</p>
-</div>
-<div class="paragraph">
-<p>However, for operators willing to inter-operate with a limited set of well-identified, trusted remote mail servers, such
-limitation can be reconsidered. The main concern then become error handling for remote mail server failures. The following
-document will present a well tested strategy for Remote Delivery error handling leveraging standards Mail Processing components
-and mechanisms.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_expectations"><a class="anchor" href="#_expectations"></a>Expectations</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Such a solution should:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Attempt delivery a single time</p>
-</li>
-<li>
-<p>Store transient and permanent failure in different mail repositories</p>
-</li>
-<li>
-<p>After a given number of tries, transient failures should be considered permanent</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_design"><a class="anchor" href="#_design"></a>Design</h2>
-<div class="sectionbody">
-<div class="imageblock">
-<div class="content">
-<img src="../../_images/remote-delivery-error-handling.png" alt="Schema detailing the proposed solution">
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Remote Delivery is configured for performing a single retry.</p>
-</li>
-<li>
-<p>Remote Delivery attaches the error code and if the failure is permanent/temporary when transferring failed emails to the
-bounce processor.</p>
-</li>
-<li>
-<p>The specified bounce processor will categorise the failure, and store temporary and permanent failures in different
-mail repositories.</p>
-</li>
-<li>
-<p>A reprocessing of the temporary delivery errors mailRepository needs to be scheduled in a recurring basis. For
-instance via a CRON job calling the right webadmin endpoint.</p>
-</li>
-<li>
-<p>A counter ensures that a configured number of delivery tries is not exceeded.</p>
-</li>
-</ul>
-</div>
-<div class="sect2">
-<h3 id="_limitation"><a class="anchor" href="#_limitation"></a>Limitation</h3>
-<div class="paragraph">
-<p>MailRepositories are not meant for transient data storage, and thus are prone to tombstone issues.</p>
-</div>
-<div class="paragraph">
-<p>This might be acceptable if you need to send mail to well-known peers. For instance handling your mail gateway failures.
-However a Mail Exchange server doing relay on the internet would quickly hit this limitation.</p>
-</div>
-<div class="paragraph">
-<p>Also note that external triggering of the retry process is needed.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_operation"><a class="anchor" href="#_operation"></a>Operation</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Here is an example of configuration achieving the proposed solution:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> <processor state="relay" enableJmx="true">
- <!-- Perform at most 5 RemoteDelivery attemps -->
- <mailet match="AtMost=5" class="RemoteDelivery">
- <outgoingQueue>outgoing</outgoingQueue>
- <maxRetries>0</maxRetries>
- <maxDnsProblemRetries>0</maxDnsProblemRetries>
- <deliveryThreads>10</deliveryThreads>
- <sendpartial>true</sendpartial>
- <!-- Use a custom processor for error handling -->
- <bounceProcessor>remote-delivery-error</bounceProcessor>
- </mailet>
- <!-- When retries are exceeded, consider the mail as a permanent failure -->
- <mailet match="All" class="ToRepository">
- <repositoryPath>cassandra://var/mail/error/remote-delivery/permanent/</repositoryPath>
- </mailet>
- </processor>
-
- <processor state="remote-delivery-error" enableJmx="true">
- <!-- Store temporary failures separately for later retries -->
- <mailet match="IsRemoteDeliveryTemporaryError" class="ToRepository">
- <repositoryPath>cassandra://var/mail/error/remote-delivery/temporary/</repositoryPath>
- </mailet>
- <!-- Store permanent failures for audit -->
- <mailet match="IsRemoteDeliveryPermanentError" class="ToRepository">
- <repositoryPath>cassandra://var/mail/error/remote-delivery/permanent/</repositoryPath>
- </mailet>
- <!-- Mail getting that far were not processed by remote delivery.
- Likely a configuration error. -->
- <mailet match="All" class="ToRepository">
- <repositoryPath>cassandra://var/mail/error/</repositoryPath>
- </mailet>
- </processor></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>The <strong>relay</strong> processor holds a RemoteDelivery mailet configured to do a single try, at most 5 times (see the AtMost matcher).
-Mails exceeding the AtMost condition are considered as permanent delivery errors. Delivery errors are sent to the
-<strong>remote-delivery-error</strong> processor.</p>
-</li>
-<li>
-<p>The <strong>remote-delivery-error</strong> stores temporary and permanent errors.</p>
-</li>
-<li>
-<p>Permanent relay errors are stored in <code>cassandra://var/mail/error/remote-delivery/permanent/</code>.</p>
-</li>
-<li>
-<p>Temporary relay errors are stored in <code>cassandra://var/mail/error/remote-delivery/temporary/</code>.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>In order to retry the relay of temporary failed emails, operators will have to configure a cron job for reprocessing
-emails from <strong>cassandra://var/mail/error/remote-delivery/temporary/</strong> mailRepository into the <strong>relay</strong> processor.</p>
-</div>
-<div class="paragraph">
-<p>This can be achieved via the following webAdmin call :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPATCH 'http://ip:8000/mailRepositories/cassandra%3A%2F%2Fvar%2Fmail%2Ferror%2Fremote-delivery%2Ftemporary%2F/mails?action=reprocess&processor=relay'</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>See <a href="../operate/webadmin.html#_reprocessing_mails_from_a_mail_repository" class="xref page">the documentation</a>.</p>
-</div>
-<div class="paragraph">
-<p>Administrators need to keep a close eye on permanent errors (that might require audit, and potentially contacting the remote
-service supplier).</p>
-</div>
-<div class="paragraph">
-<p>To do so, one should regularly audit the content of <strong>cassandra://var/mail/error/remote-delivery/permanent/</strong>. This can be done
-via webAdmin calls:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET 'http://ip:8000/mailRepositories/cassandra%3A%2F%2Fvar%2Fmail%2Ferror%2Fremote-delivery%2Ftemporary%2F/mails'</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>See <a href="../operate/webadmin.html#_listing_mails_contained_in_a_mail_repository" class="xref page">the documentation</a>.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/configure/smtp-hooks.html b/james-project/3.6.0/servers/distributed/configure/smtp-hooks.html
deleted file mode 100644
index 8c23d30..0000000
--- a/james-project/3.6.0/servers/distributed/configure/smtp-hooks.html
+++ /dev/null
@@ -1,960 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — SMTP Hooks :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item is-current-page" data-depth="5">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Protocols</li>
- <li><a href="smtp-hooks.html">Packaged SMTP hooks</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="smtp-hooks.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/configure/smtp-hooks.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — SMTP Hooks</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This documentation page lists and documents SMTP hooks that can be used within the
-Distributed Server SMTP protocol stack in order to customize the way your SMTP server
-behaves with out of the box components.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_dnsrblhandler"><a class="anchor" href="#_dnsrblhandler"></a>DNSRBLHandler</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This command handler check against <a href="https://www.wikiwand.com/en/Domain_Name_System-based_Blackhole_List">RBL-Lists</a>
-(Real-time Blackhole List).</p>
-</div>
-<div class="paragraph">
-<p>If getDetail is set to true it try to retrieve information from TXT Record
-why the ip was blocked. Default to false.</p>
-</div>
-<div class="paragraph">
-<p>before you enable out the DNS RBL handler documented as an example below,
-please take a moment to review each block in the list.
-We have included some that various JAMES committers use,
-but you must decide which, if any, are appropriate
-for your environment.</p>
-</div>
-<div class="paragraph">
-<p>The mail servers hosting
-@apache.org mailing lists, for example, use a
-slightly different list than we have included below.
-And it is likely that most JAMES committers also have
-slightly different sets of lists.</p>
-</div>
-<div class="paragraph">
-<p>The SpamAssassin user’s list would be one good place to discuss the
-measured quality of various block lists.</p>
-</div>
-<div class="paragraph">
-<p>NOTA BENE: the domain names, below, are terminated
-with '.' to ensure that they are absolute names in
-DNS lookups. Under some circumstances, names that
-are not explicitly absolute could be treated as
-relative names, leading to incorrect results. This
-has been observed on *nix and MS-Windows platforms
-by users of multiple mail servers, and is not JAMES
-specific. If you are unsure what this means for you,
-please speak with your local system/network admins.</p>
-</div>
-<div class="paragraph">
-<p>This handler should be considered experimental.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><handlerchain>
- <!-- ... -->
- <handler class="org.apache.james.smtpserver.fastfail.DNSRBLHandler">
- <getDetail>false</getDetail>
- <rblservers>
- <whitelist>query.bondedsender.org.</whitelist>
- <blacklist>sbl-xbl.spamhaus.org.</blacklist>
- <blacklist>dul.dnsbl.sorbs.net.</blacklist>
- <blacklist>list.dsbl.org.</blacklist>
- </rblservers>
- </handler>
-</handlerchain></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_dsn_hooks"><a class="anchor" href="#_dsn_hooks"></a>DSN hooks</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The Distributed server has optional support for DSN (<a href="https://tools.ietf.org/html/rfc3461">RFC-3461</a>)</p>
-</div>
-<div class="paragraph">
-<p>Please read carefully <a href="dsn.html" class="xref page">this page</a>.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><smtpserver enabled="true">
- <...> <!-- The rest of your SMTP configuration, unchanged -->
- <handlerchain>
- <handler class="org.apache.james.smtpserver.dsn.DSNEhloHook"/>
- <handler class="org.apache.james.smtpserver.dsn.DSNMailParameterHook"/>
- <handler class="org.apache.james.smtpserver.dsn.DSNRcptParameterHook"/>
- <handler class="org.apache.james.smtpserver.dsn.DSNMessageHook"/>
- <...> <!-- other handlers, like: -->
- <handler class="org.apache.james.smtpserver.CoreCmdHandlerLoader"/> <!-- for instance -->
- </handlerchain>
-</smtpserver></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note that a specific configuration of <a href="mailetcontainer.html" class="xref page">mailetcontainer.xml</a> is
-required as well to be spec compliant.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_mailpriorityhandler"><a class="anchor" href="#_mailpriorityhandler"></a>MailPriorityHandler</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This handler can add a hint to the mail which tells the MailQueue which email should get processed first.</p>
-</div>
-<div class="paragraph">
-<p>Normally the MailQueue will just handles Mails in FIFO manner.</p>
-</div>
-<div class="paragraph">
-<p>Valid priority values are 1,5,9 where 9 is the highest.</p>
-</div>
-<div class="paragraph">
-<p>This handler should be considered experimental.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><handlerchain>
- <!-- ... -->
- <handler class="org.apache.james.smtpserver.MailPriorityHandler">
- <priorityEntries>
- <priorityEntry>
- <domain>yourdomain1</domain>
- <priority>1</priority>
- </priorityEntry>
- <priorityEntry>
- <domain>yourdomain2</domain>
- <priority>9</priority>
- </priorityEntry>
- <priorityEntries>
- </handler>
-</handlerchain></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_maxrcpthandler"><a class="anchor" href="#_maxrcpthandler"></a>MaxRcptHandler</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>If activated you can limit the maximal recipients.</p>
-</div>
-<div class="paragraph">
-<p>This handler should be considered experimental.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><handlerchain>
- <!-- ... -->
- <handler class="org.apache.james.smtpserver.fastfail.MaxRcptHandler">
- <maxRcpt>10</maxRcpt>
- </handler>
-</handlerchain></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_pop3beforesmtphandler"><a class="anchor" href="#_pop3beforesmtphandler"></a>POP3BeforeSMTPHandler</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This connect handler can be used to enable POP3 before SMTP support.</p>
-</div>
-<div class="paragraph">
-<p>Please note that only the ip get stored to identify an authenticated client.</p>
-</div>
-<div class="paragraph">
-<p>The expireTime is the time after which an ipAddress is handled as expired.</p>
-</div>
-<div class="paragraph">
-<p>This handler should be considered as unsupported.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><handlerchain>
- <!-- ... -->
- <handler class="org.apache.james.smtpserver.POP3BeforeSMTPHandler">
- <expireTime>1 hour</expireTime>
- </handler>
-</handlerchain></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_resolvableehlohelohandler"><a class="anchor" href="#_resolvableehlohelohandler"></a>ResolvableEhloHeloHandler</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Checks for resolvable HELO/EHLO before accept the HELO/EHLO.</p>
-</div>
-<div class="paragraph">
-<p>If checkAuthNetworks is set to true sender domain will be checked also for clients that
-are allowed to relay. Default is false.</p>
-</div>
-<div class="paragraph">
-<p>This handler should be considered experimental.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><handlerchain>
- <!-- ... -->
- <handler class="org.apache.james.smtpserver.fastfail.ResolvableEhloHeloHandler"/>
-</handlerchain></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_reverseequalsehlohelohandler"><a class="anchor" href="#_reverseequalsehlohelohandler"></a>ReverseEqualsEhloHeloHandler</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Checks HELO/EHLO is equal the reverse of the connecting client before accept it
-If checkAuthNetworks is set to true sender domain will be checked also for clients that
-are allowed to relay. Default is false.</p>
-</div>
-<div class="paragraph">
-<p>This handler should be considered experimental.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><handlerchain>
- <!-- ... -->
- <handler class="org.apache.james.smtpserver.fastfail.ReverseEqualsEhloHeloHandler"/>
-</handlerchain></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_setmimeheaderhandler"><a class="anchor" href="#_setmimeheaderhandler"></a>SetMimeHeaderHandler</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This handler allows you to add mime headers to the processed mails.</p>
-</div>
-<div class="paragraph">
-<p>This handler should be considered experimental.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><handlerchain>
- <!-- ... -->
- <handler class="org.apache.james.smtpserver.SetMimeHeaderHandler">
- <headername>SPF-test</headername>
- <headervalue>passed</headervalue>
- </handler>
-</handlerchain></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_spamassassinhandler"><a class="anchor" href="#_spamassassinhandler"></a>SpamAssassinHandler</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This MessageHandler could be used to check message against spamd before
-accept the email. So its possible to reject a message on smtplevel if a
-configured hits amount is reached.</p>
-</div>
-<div class="paragraph">
-<p>This handler should be considered experimental.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><handlerchain>
- <!-- ... -->
- <handler class="org.apache.james.smtpserver.fastfail.SpamAssassinHandler">
- <spamdHost>127.0.0.1</spamdHost>
- <spamdPort>783</spamdPort>
- <spamdRejectionHits>10</spamdRejectionHits>
- </handler>
-</handlerchain></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_spfhandler"><a class="anchor" href="#_spfhandler"></a>SPFHandler</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This command handler can be used to reject emails with not match the SPF record of the sender domain.</p>
-</div>
-<div class="paragraph">
-<p>If checkAuthNetworks is set to true sender domain will be checked also for clients that
-are allowed to relay. Default is false.</p>
-</div>
-<div class="paragraph">
-<p>This handler should be considered experimental.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><handlerchain>
- <!-- ... -->
- <handler class="org.apache.james.smtpserver.fastfail.SPFHandler">
- <blockSoftFail>false</blockSoftFail>
- <blockPermError>true</blockPermError>
- </handler>
-</handlerchain></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_urirblhandler"><a class="anchor" href="#_urirblhandler"></a>URIRBLHandler</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This MessageHandler could be used to extract domain out of the message and check
-this domains against uriRbllists. See <a href="http://www.surbl.org" class="bare">http://www.surbl.org</a> for more information.
-The message get rejected if a domain matched.</p>
-</div>
-<div class="paragraph">
-<p>This handler should be considered experimental.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><handlerchain>
- <!-- ... -->
- <handler class="org.apache.james.smtpserver.fastfail.URIRBLHandler">
- <action>reject</action>
- <getDetail>true</getDetail>
- <uriRblServers>
- <server>multi.surbl.org</server>
- </uriRblServers>
- </handler>
-</handlerchain></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_validrcpthandler"><a class="anchor" href="#_validrcpthandler"></a>ValidRcptHandler</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>With ValidRcptHandler, all email will get rejected which has no valid user.</p>
-</div>
-<div class="paragraph">
-<p>You need to add the recipient to the validRecipient list if you want
-to accept email for a recipient which not exist on the server.</p>
-</div>
-<div class="paragraph">
-<p>If you want James to act as a spamtrap or honeypot, you may comment ValidRcptHandler
-and implement the needed processors in spoolmanager.xml.</p>
-</div>
-<div class="paragraph">
-<p>This handler should be considered stable.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><handlerchain>
- <!-- ... -->
- <handler class="org.apache.james.smtpserver.fastfail.ValidRcptHandler"/>
-</handlerchain></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_validsenderdomainhandler"><a class="anchor" href="#_validsenderdomainhandler"></a>ValidSenderDomainHandler</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>If activated mail is only accepted if the sender contains
-a resolvable domain having a valid MX Record or A Record associated!</p>
-</div>
-<div class="paragraph">
-<p>If checkAuthNetworks is set to true sender domain will be checked also for clients that
-are allowed to relay. Default is false.</p>
-</div>
-<div class="paragraph">
-<p>Example configuration:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><handlerchain>
- <!-- ... -->
- <handler class="org.apache.james.smtpserver.fastfail.ValidSenderDomainHandler"/>
-</handlerchain></pre>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/configure/smtp.html b/james-project/3.6.0/servers/distributed/configure/smtp.html
deleted file mode 100644
index db719bf..0000000
--- a/james-project/3.6.0/servers/distributed/configure/smtp.html
+++ /dev/null
@@ -1,782 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — smtpserver.xml :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item is-current-page" data-depth="5">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Protocols</li>
- <li><a href="smtp.html">smtpserver.xml & lmtpserver.xml</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="smtp.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/configure/smtp.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — smtpserver.xml</h1>
-<div class="sect1">
-<h2 id="_incoming_smtp"><a class="anchor" href="#_incoming_smtp"></a>Incoming SMTP</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/smtpserver.xml">example</a>
-to get some examples and hints.</p>
-</div>
-<div class="paragraph">
-<p>The SMTP service is controlled by a configuration block in the smptserver.xml.
-The smtpserver tag defines the boundaries of the configuration block. It encloses
-all the relevant configuration for the SMTP server. The behavior of the SMTP service is
-controlled by the attributes and children of this tag.</p>
-</div>
-<div class="paragraph">
-<p>This tag has an optional boolean attribute - <strong>enabled</strong> - that defines whether the service is active or not. The value defaults to "true" if
-not present.</p>
-</div>
-<div class="paragraph">
-<p>The standard children of the smtpserver tag are:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. smtpserver.xml content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">bind</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A list of address:port separed by comma - This is an optional value. If present, this value is a string describing
-the IP address to which this service should be bound. If the tag or value is absent then the service
-will bind to all network interfaces for the machine on port 25. Port 25 is the well-known/IANA registered port for SMTP.
-Port 465 is the well-known/IANA registered port for SMTP over TLS.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connectBacklog</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The IP address (host name) the MBean Server will bind/listen to.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tls</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set to true to support STARTTLS or SSL for the Socket.
-To use this you need to copy sunjce_provider.jar to /path/james/lib directory. To create a new keystore execute:
-<code>keytool -genkey -alias james -keyalg RSA -keystore /path/to/james/conf/keystore</code>.
-The algorithm is optional and only needs to be specified when using something other
-than the Sun JCE provider - You could use IbmX509 with IBM Java runtime.
-Please note that each SMTP/LMTP server exposed on different port can specify its own keystore, independently from any other
-TLS based protocols.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">helloName</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">This is a required tag with an optional body that defines the server name
-used in the initial service greeting. The tag may have an optional attribute - <strong>autodetect</strong>. If
-the autodetect attribute is present and true, the service will use the local hostname
-returned by the Java libraries. If autodetect is absent or false, the body of the tag will be used. In
-this case, if no body is present, the value "localhost" will be used.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connectionTimeout</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">This is an optional tag with a non-negative integer body. Connection timeout in seconds.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connectionLimit</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum simultaneous incoming connections for this service.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connectionLimitPerIP</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set the maximum simultaneous incoming connections per IP for this service.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">handler.authRequired</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">This is an optional tag with a boolean body. If true, then the server will
-require authentication before delivering mail to non-local email addresses. If this tag is absent, or the value
-is false then the client will not be prompted for authentication. Only simple user/password authentication is
-supported at this time. supported values:</p>
-<p class="tableblock">* true: required but announced only to not authorizedAddresses
-* false: don’t use AUTH
-* announce: like true, but always announce AUTH capability to clients</p>
-<p class="tableblock">The correct behaviour per RFC value would be false or announce
-but we still support true for backward compatibility and because
-some webmail client fails when AUTH is announced but no authentication
-information has been provided</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">authorizedAddresses</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Authorize specific addresses/networks.</p>
-<p class="tableblock">If you use SMTP AUTH, addresses that match those specified here will
-be permitted to relay without SMTP AUTH. If you do not use SMTP
-AUTH, and you specify addreses here, then only addresses that match
-those specified will be permitted to relay.</p>
-<p class="tableblock">Addresses may be specified as a an IP address or domain name, with an
-optional netmask, e.g.,</p>
-<p class="tableblock">127.*, 127.0.0.0/8, 127.0.0.0/255.0.0.0, and localhost/8 are all the same</p>
-<p class="tableblock">See also the RemoteAddrNotInNetwork matcher in the transport processor.
-You would generally use one OR the other approach.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">verifyIdentity</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">This is an optional tag with a boolean body. This option can only be used
-if SMTP authentication is required. If the parameter is set to true then the sender address for the submitted message
-will be verified against the authenticated subject. Verify sender addresses, ensuring that
-the sender address matches the user who has authenticated.
-It will verify that the sender address matches the address of the user or one of its alias (from user or domain aliases).
-This prevents a user of your mail server from acting as someone else
-If unspecified, default value is true.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">maxmessagesize</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">This is an optional tag with a non-negative integer body. It specifies the maximum
-size, in kbytes, of any message that will be transmitted by this SMTP server. It is a service-wide, as opposed to
-a per user, limit. If the value is zero then there is no limit. If the tag isn’t specified, the service will
-default to an unlimited message size.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">heloEhloEnforcement</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">This sets whether to enforce the use of HELO/EHLO salutation before a
-MAIL command is accepted. If unspecified, the value defaults to true.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">smtpGreeting</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">This sets the SMTPGreeting which will be used when connect to the smtpserver
-If none is specified a default is generated</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">handlerchain</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The configuration handler chain. See <a href="smtp-hooks.html" class="xref page">this page</a> for configuring out-of the
-box extra SMTP handlers and hooks.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_about_open_relays"><a class="anchor" href="#_about_open_relays"></a>About open relays</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Authenticated SMTP is a method of securing your SMTP server. With SMTP AUTH enabled senders who wish to
-relay mail through the SMTP server (that is, send mail that is eventually to be delivered to another SMTP
-server) must authenticate themselves to Apache James Server before sending their message. Mail that is to be delivered
-locally does not require authentication. This method ensures that spammers cannot use your SMTP server
-to send unauthorized mail, while still enabling users who may not have fixed IP addresses to send their
-messages.</p>
-</div>
-<div class="paragraph">
-<p>Mail servers that allow spammers to send unauthorized email are known as open relays. So SMTP AUTH
-is a mechanism for ensuring that your server is not an open relay.</p>
-</div>
-<div class="paragraph">
-<p>It is extremely important that your server not be configured as an open relay. Aside from potential
-costs associated with usage by spammers, connections from servers that are determined to be open relays
-are routinely rejected by SMTP servers. This can severely impede the ability of your mail server to
-send mail.</p>
-</div>
-<div class="paragraph">
-<p>At this time Apache James Server only supports simple user name / password authentication.</p>
-</div>
-<div class="paragraph">
-<p>As mentioned above, SMTP AUTH requires that Apache James Server be able to distinguish between mail intended
-for local delivery and mail intended for remote delivery. Apache James Server makes this determination by matching the
-domain to which the mail was sent against the <strong>DomainList</strong> component, configured by
-<a href="domainlist.html" class="xref page"><strong>domainlist.xml</strong></a>.</p>
-</div>
-<div class="paragraph">
-<p>The Distributed Server is configured out of the box so as to not serve as an open relay for spammers. This is done
-by relayed emails originate from a trusted source. This includes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Authenticated SMTP/JMAP users</p>
-</li>
-<li>
-<p>Mails generated by the server (eg: bounces)</p>
-</li>
-<li>
-<p>Mails originating froma trusted network as configured in <strong>smtpserver.xml</strong></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>If you wish to ensure that authenticated users can only send email from their own account, you may
-optionally set the verifyIdentity element of the smtpserver configuration block to "true".</p>
-</div>
-<div class="sect2">
-<h3 id="_verification"><a class="anchor" href="#_verification"></a>Verification</h3>
-<div class="paragraph">
-<p>Verify that you have not inadvertently configured your server as an open relay. This is most easily
-accomplished by using the service provided at <a href="https://mxtoolbox.com/diagnostic.aspx">mxtoolbox.com</a>. mxtoolbox.com will
-check your mail server and inform you if it is an open relay. This tool further more verifies additional propertiess like:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Your DNS condifuration, especially that you mail server IP has a valid reverse DNS entry</p>
-</li>
-<li>
-<p>That your SMTP connection is secured</p>
-</li>
-<li>
-<p>That you are not an OpenRelay</p>
-</li>
-<li>
-<p>This website also allow a quick lookup to ensure your mail server is not in public blacklists.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Of course it is also necessary to confirm that users and log in and send
-mail through your server. This can be accomplished using any standard mail client (i.e. Thunderbird, Outlook,
-Eudora, Evolution).</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_lmtp_configuration"><a class="anchor" href="#_lmtp_configuration"></a>LMTP Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/lmtpserver.xml">example</a>
-to get some examples and hints.</p>
-</div>
-<div class="paragraph">
-<p>The configuration is the same of for SMTP.</p>
-</div>
-<div class="paragraph">
-<p>By default, it is deactivated. You can activate it alongside SMTP and bind for example on port 24.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/configure/spam.html b/james-project/3.6.0/servers/distributed/configure/spam.html
deleted file mode 100644
index 1fd4047..0000000
--- a/james-project/3.6.0/servers/distributed/configure/spam.html
+++ /dev/null
@@ -1,690 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Anti-Spam configuration :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item is-current-page" data-depth="5">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Extensions</li>
- <li><a href="spam.html">Anti-Spam setup</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="spam.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/configure/spam.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Anti-Spam configuration</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>Anti-Spam system can be configured via two main different mechanisms:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>SMTP Hooks;</p>
-</li>
-<li>
-<p>Mailets;</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_antispam_smtp_hooks"><a class="anchor" href="#_antispam_smtp_hooks"></a>AntiSpam SMTP Hooks</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>"FastFail" SMTP Hooks acts to reject before spooling
-on the SMTP level. SpamAssasin hook can be used as a fastfail hook, therefore
-SpamAssassin must run as a server on the same machine as the Apache James Server.</p>
-</div>
-<div class="paragraph">
-<p>SMTP Hooks for non-existent users, DSN filter, domains with invalid MX record,
-can also be configured.</p>
-</div>
-<div class="paragraph">
-<p><strong>SpamAssassinHandler</strong> (experimental) also enables to classify the messages as spam or not
-with an configurable score threshold (<code>0.0</code>, non configurable). Only a global database is supported. Per user spam
-detection is not supported by this hook.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_antispam_mailets"><a class="anchor" href="#_antispam_mailets"></a>AntiSpam Mailets</h2>
-<div class="sectionbody">
-<div class="ulist">
-<ul>
-<li>
-<p><strong>SpamAssassin</strong> Mailet is designed to classify the messages as spam or not
-with an configurable score threshold. Usually a message will only be
-considered as spam if it matches multiple criteria; matching just a single test
-will not usually be enough to reach the threshold. Note that this mailet is executed on a per-user basis.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Here is an example of mailet pipeline conducting out SpamAssassin execution:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailet match="All" class="SpamAssassin">
- <onMailetException>ignore</onMailetException>
- <spamdHost>spamassassin</spamdHost>
- <spamdPort>783</spamdPort>
-</mailet>
-<mailet match="All" class="MailAttributesToMimeHeaders">
- <!-- This mailet is not required, but useful to have SpamAssassin score in headers-->
- <simplemapping>org.apache.james.spamassassin.status; X-JAMES-SPAMASSASSIN-STATUS</simplemapping>
- <simplemapping>org.apache.james.spamassassin.flag; X-JAMES-SPAMASSASSIN-FLAG</simplemapping>
-</mailet>
-<mailet match="IsMarkedAsSpam" class="WithStorageDirective">
- <targetFolderName>Spam</targetFolderName>
-</mailet></pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>BayesianAnalysis</strong> (unsupported) in the Mailet uses Bayesian probability to classify mail as
-spam or not spam. It relies on the training data coming from the users’ judgment.
-Users need to manually judge as spam and send to <a href="mailto:spam@thisdomain.com">spam@thisdomain.com</a>, oppositely,
-if not spam they then send to <a href="mailto:not.spam@thisdomain.com">not.spam@thisdomain.com</a>. BayesianAnalysisfeeder learns
-from this training dataset, and build predictive models based on Bayesian probability.
-There will be a certain table for maintaining the frequency of Corpus for keywords
-in the database. Every 10 mins a thread in the BayesianAnalysis will check and update
-the table. Also, the correct approach is to send the original spam or non-spam
-as an attachment to another message sent to the feeder in order to avoid bias from the
-current sender’s email header.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_feedback_for_spamassassin"><a class="anchor" href="#_feedback_for_spamassassin"></a>Feedback for SpamAssassin</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>If enabled, the <code>SpamAssassinListener</code> will asynchronously report users mails moved to the <code>Spam</code> mailbox as Spam,
-and other mails as <code>Ham</code>, effectively populating the user database for per user spam detection. This enables a per-user
-Spam categorization to be conducted out by the SpamAssassin mailet, the SpamAssassin hook being unaffected.</p>
-</div>
-<div class="paragraph">
-<p>The SpamAssassin listener requires an extra configuration file <code>spamassassin.properties</code> to configure SpamAssassin connection (optional):</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. spamassassin.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">spamassassin.host</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Hostname of the SpamAssassin server. Defaults to 127.0.0.1.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">spamassassin.port</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Port of the SpamAssassin server. Defaults to 783.</p></td>
-</tr>
-</tbody>
-</table>
-<div class="paragraph">
-<p>Note that this configuration file only affects the listener, and not the hook or mailet.</p>
-</div>
-<div class="paragraph">
-<p>The SpamAssassin listener needs to explicitly be registered with <a href="listeners.html" class="xref page">listeners.xml</a>.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><listeners>
- <listener>
- <class>org.apache.james.mailbox.spamassassin.SpamAssassinListener</class>
- <async>true</async>
- </listener>
-</listeners></pre>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/configure/ssl.html b/james-project/3.6.0/servers/distributed/configure/ssl.html
deleted file mode 100644
index 43dafa5..0000000
--- a/james-project/3.6.0/servers/distributed/configure/ssl.html
+++ /dev/null
@@ -1,768 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — SSL & TLS configuration :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item is-current-page" data-depth="5">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Protocols</li>
- <li><a href="ssl.html">SSL & TLS</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="ssl.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/configure/ssl.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — SSL & TLS configuration</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This document explains how to enable James 3.0 servers to use Transport Layer Security (TLS)
-for encrypted client-server communication.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_configure_a_server_to_use_ssltls"><a class="anchor" href="#_configure_a_server_to_use_ssltls"></a>Configure a Server to Use SSL/TLS</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Each of the servers <a href="smtp.html" class="xref page">SMTP - LMTP</a>,
-<a href="pop3.html" class="xref page">POP3</a> and <a href="imap.html" class="xref page">IMAP</a>
-supports use of SSL/TLS.</p>
-</div>
-<div class="paragraph">
-<p>TLS (Transport Layer Security) and SSL (Secure Sockets Layer) are protocols that provide
-data encryption and authentication between applications in scenarios where that data is
-being sent across an insecure network, such as checking your email
-(How does the Secure Socket Layer work?). The terms SSL and TLS are often used
-interchangeably or in conjunction with each other (TLS/SSL),
-but one is in fact the predecessor of the other — SSL 3.0 served as the basis
-for TLS 1.0 which, as a result, is sometimes referred to as SSL 3.1.</p>
-</div>
-<div class="paragraph">
-<p>You need to add a block in the corresponding configuration file (smtpserver.xml, pop3server.xml, imapserver.xml,..)</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><tls socketTLS="false" startTLS="false">
- <keystore>file://conf/keystore</keystore>
- <secret>yoursecret</secret>
- <provider>org.bouncycastle.jce.provider.BouncyCastleProvider</provider>
-</tls></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Each of these block has an optional boolean configuration element <b>socketTLS</b> and <b>startTLS</b> which is used to toggle
-use of SSL or TLS for the service.</p>
-</div>
-<div class="paragraph">
-<p>With socketTLS (SSL/TLS in Thunderbird), all the communication is encrypted.</p>
-</div>
-<div class="paragraph">
-<p>With startTLS (STARTTLS in Thunderbird), the preamble is readable, but the rest is encrypted.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>* OK JAMES IMAP4rev1 Server Server 192.168.1.4 is ready.
-* CAPABILITY IMAP4rev1 LITERAL+ CHILDREN WITHIN STARTTLS IDLE NAMESPACE UIDPLUS UNSELECT AUTH=PLAIN
-1 OK CAPABILITY completed.
-2 OK STARTTLS Begin TLS negotiation now.
-... rest is encrypted...</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can only enable one of the both at the same time for a service.</p>
-</div>
-<div class="paragraph">
-<p>It is also recommended to change the port number on which the service will listen:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>POP3 - port 110, Secure POP3 - port 995</p>
-</li>
-<li>
-<p>IMAP - port 143, Secure IMAP4 - port 993</p>
-</li>
-<li>
-<p>SMTP - port 25, Secure SMTP - port 465</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>You will now need to create your certificate store and place it in the james/conf/ folder with the name you defined in the keystore tag.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_certificate_keystores"><a class="anchor" href="#_certificate_keystores"></a>Certificate Keystores</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>To use TLS/SSL inside James you will need a certificate keystore.</p>
-</div>
-<div class="sect2">
-<h3 id="_creating_your_own_certificate_keystore"><a class="anchor" href="#_creating_your_own_certificate_keystore"></a>Creating your own Certificate Keystore</h3>
-<div class="paragraph">
-<p>(Adapted from the Tomcat 4.1 documentation)</p>
-</div>
-<div class="paragraph">
-<p>James currently operates only on JKS format keystores. This is Java’s standard "Java KeyStore" format, and is the format
-created by the keytool command-line utility. This tool is included in the JDK.</p>
-</div>
-<div class="paragraph">
-<p>To import an existing certificate into a JKS keystore, please read the documentation (in your JDK documentation package)
-about keytool.</p>
-</div>
-<div class="paragraph">
-<p>To create a new keystore from scratch, containing a single self-signed Certificate, execute the following from a terminal
-command line:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>keytool -genkey -alias james -keyalg RSA -keystore your_keystore_filename</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>(The RSA algorithm should be preferred as a secure algorithm, and this also ensures general compatibility with other
-servers and components.)</p>
-</div>
-<div class="paragraph">
-<p>As a suggested standard, create the keystore in the james/conf directory, with a name like james.keystore.</p>
-</div>
-<div class="paragraph">
-<p>After executing this command, you will first be prompted for the keystore password.</p>
-</div>
-<div class="paragraph">
-<p>Next, you will be prompted for general information about this Certificate, such as company, contact name, and so on.
-This information may be displayed to users when importing into the certificate store of the client, so make sure that
-the information provided here matches what they will expect.</p>
-</div>
-<div class="paragraph">
-<p>Important: in the "distinguished name", set the "common name" (CN) to the DNS name of your James server, the one
-you will use to access it from your mail client (like "mail.xyz.com").</p>
-</div>
-<div class="paragraph">
-<p>Finally, you will be prompted for the key password, which is the password specifically for this Certificate
-(as opposed to any other Certificates stored in the same keystore file).</p>
-</div>
-<div class="paragraph">
-<p>If everything was successful, you now have a keystore file with a Certificate that can be used by your server.</p>
-</div>
-<div class="paragraph">
-<p>You MUST have only one certificate in the keystore file used by James.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_installing_a_certificate_provided_by_a_certificate_authority"><a class="anchor" href="#_installing_a_certificate_provided_by_a_certificate_authority"></a>Installing a Certificate provided by a Certificate Authority</h3>
-<div class="paragraph">
-<p>(Adapted from the Tomcat 4.1 documentation</p>
-</div>
-<div class="paragraph">
-<p>To obtain and install a Certificate from a Certificate Authority (like verisign.com, thawte.com or trustcenter.de)
-you should have read the previous section and then follow these instructions:</p>
-</div>
-<div class="sect3">
-<h4 id="_create_a_local_certificate_signing_request_csr"><a class="anchor" href="#_create_a_local_certificate_signing_request_csr"></a>Create a local Certificate Signing Request (CSR)</h4>
-<div class="paragraph">
-<p>In order to obtain a Certificate from the Certificate Authority of your choice you have to create a so called
-Certificate Signing Request (CSR). That CSR will be used by the Certificate Authority to create a Certificate
-that will identify your James server as "secure". To create a CSR follow these steps:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Create a local Certificate as described in the previous section.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The CSR is then created with:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> keytool -certreq -keyalg RSA -alias james -file certreq.csr -keystore your_keystore_filename</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Now you have a file called certreq.csr. The file is encoded in PEM format. You can submit it to the Certificate Authority
-(look at the documentation of the Certificate Authority website on how to do this). In return you get a Certificate.</p>
-</div>
-<div class="paragraph">
-<p>Now that you have your Certificate you can import it into you local keystore. First of all you may have to import a so
-called Chain Certificate or Root Certificate into your keystore (the major Certificate Authorities are already in place,
-so it’s unlikely that you will need to perform this step). After that you can procede with importing your Certificate.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_optionally_importing_a_so_called_chain_certificate_or_root_certificate"><a class="anchor" href="#_optionally_importing_a_so_called_chain_certificate_or_root_certificate"></a>Optionally Importing a so called Chain Certificate or Root Certificate</h4>
-<div class="paragraph">
-<p>Download a Chain Certificate from the Certificate Authority you obtained the Certificate from.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>For Verisign.com go to: <a href="http://www.verisign.com/support/install/intermediate.html" class="bare">http://www.verisign.com/support/install/intermediate.html</a></p>
-</li>
-<li>
-<p>For Trustcenter.de go to: <a href="http://www.trustcenter.de/certservices/cacerts/en/en.htm#server" class="bare">http://www.trustcenter.de/certservices/cacerts/en/en.htm#server</a></p>
-</li>
-<li>
-<p>For Thawte.com go to: <a href="http://www.thawte.com/certs/trustmap.html" class="bare">http://www.thawte.com/certs/trustmap.html</a> (seems no longer valid)</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_import_the_chain_certificate_into_you_keystore"><a class="anchor" href="#_import_the_chain_certificate_into_you_keystore"></a>Import the Chain Certificate into you keystore</h4>
-<div class="literalblock">
-<div class="content">
-<pre>keytool -import -alias root -keystore your_keystore_filename -trustcacerts -file filename_of_the_chain_certificate</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>And finally import your new Certificate (It must be in X509 format):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>keytool -import -alias james -keystore your_keystore_filename -trustcacerts -file your_certificate_filename</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>See also <a href="http://www.agentbob.info/agentbob/79.html">this page</a></p>
-</div>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/configure/tika.html b/james-project/3.6.0/servers/distributed/configure/tika.html
deleted file mode 100644
index 9b43782..0000000
--- a/james-project/3.6.0/servers/distributed/configure/tika.html
+++ /dev/null
@@ -1,619 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — tika.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item is-current-page" data-depth="5">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Storage dependencies</li>
- <li><a href="tika.html">tika.properties</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="tika.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/configure/tika.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — tika.properties</h1>
-<div class="paragraph">
-<p>When using ElasticSearch, you can configure an external Tika server for extracting and indexing text from attachments.
-Thus you can significantly improve user experience upon text searches.</p>
-</div>
-<div class="paragraph">
-<p>Note: You can launch a tika server using this command line:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>docker run --name tika linagora/docker-tikaserver:1.24</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Here are the different properties:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. elasticsearch.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tika.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Should Tika text extractor be used?
-If true, the TikaTextExtractor will be used behind a cache.
-If false, the DefaultTextExtractor will be used (naive implementation only supporting text).
-Defaults to false.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tika.host</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">IP or domain name of your Tika server. The default value is 127.0.0.1</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tika.port</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Port of your tika server. The default value is 9998</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tika.timeoutInMillis</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Timeout when issuing request to the tika server. The default value is 3 seconds.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tika.cache.eviction.period</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A cache is used to avoid, when possible, query Tika multiple time for the same attachments.
-This entry determines how long after the last read an entry vanishes.
-Please note that units are supported (ms - millisecond, s - second, m - minute, h - hour, d - day). Default unit is seconds.
-Default value is <strong>1 day</strong></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tika.cache.enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Should the cache be used? False by default</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tika.cache.weight.max</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Maximum weight of the cache.
-A value of <strong>0</strong> disables the cache
-Please note that units are supported (K for KB, M for MB, G for GB). Defaults is no units, so in bytes.
-Default value is <strong>100 MB</strong>.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tika.contentType.blacklist</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Blacklist of content type is known-to-be-failing with Tika. Specify the list with comma separator.</p></td>
-</tr>
-</tbody>
-</table>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/configure/usersrepository.html b/james-project/3.6.0/servers/distributed/configure/usersrepository.html
deleted file mode 100644
index a0cfda9..0000000
--- a/james-project/3.6.0/servers/distributed/configure/usersrepository.html
+++ /dev/null
@@ -1,648 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — usersrepository.xml :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item is-current-page" data-depth="5">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Core components</li>
- <li><a href="usersrepository.html">usersrepository.xml</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="usersrepository.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/configure/usersrepository.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — usersrepository.xml</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>User repositories are required to store James user information and authentication data.</p>
-</div>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/usersrepository.xml">example</a>
-to get some examples and hints.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_the_user_data_model"><a class="anchor" href="#_the_user_data_model"></a>The user data model</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>A user has two attributes: username and password.</p>
-</div>
-<div class="paragraph">
-<p>A valid user should satisfy these criteria:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>username and password cannot be null or empty</p>
-</li>
-<li>
-<p>username should not be longer than 255 characters</p>
-</li>
-<li>
-<p>username can not contain '/'</p>
-</li>
-<li>
-<p>username can not contain multiple domain delimiter('@')</p>
-</li>
-<li>
-<p>A username can have only a local part when virtualHosting is disabled. E.g.'myUser'</p>
-</li>
-<li>
-<p>When virtualHosting is enabled, a username should have a domain part, and the domain part should be concatenated
-after a domain delimiter('@'). E.g. '<a href="mailto:myuser@james.org">myuser@james.org</a>'</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>A user is always considered as lower cased, so 'myUser' and 'myuser' are the same user, and can be used as well as
-recipient local part than as login for different protocols.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_configuration"><a class="anchor" href="#_configuration"></a>Configuration</h2>
-<div class="sectionbody">
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. usersrepository.xml content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">enableVirtualHosting</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">true or false. Add domain support for users (default: false, except for Cassandra Users Repository)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">administratorId</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">user’s name. Allow a user to access to the <a href="https://tools.ietf.org/html/rfc4616#section-2">impersonation command</a>,
-acting on the behalf of any user.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_configuring_a_ldap"><a class="anchor" href="#_configuring_a_ldap"></a>Configuring a LDAP</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>If you run the LDAP fashion of the distributed server, you need to configure the properties for accessing
-your LDAP server in this file.</p>
-</div>
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq-ldap/destination/conf/usersrepository.xml">example</a>
-to get some examples and hints.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><repository name="LocalUsers" class="org.apache.james.user.ldap.ReadOnlyUsersLDAPRepository" ldapHost="ldap://myldapserver:389"
- principal="uid=ldapUser,ou=system" credentials="password" userBase="ou=People,o=myorg.com,ou=system" userIdAttribute="uid"/>;</pre>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/configure/vault.html b/james-project/3.6.0/servers/distributed/configure/vault.html
deleted file mode 100644
index 74aa2a2..0000000
--- a/james-project/3.6.0/servers/distributed/configure/vault.html
+++ /dev/null
@@ -1,604 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — deletedMessageVault.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="5">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Extensions</li>
- <li><a href="vault.html">deletedMessageVault.properties</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="vault.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/configure/vault.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — deletedMessageVault.properties</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>Deleted Messages Vault is the component in charge of retaining messages before they are going to be deleted.
-Messages stored in the Deleted Messages Vault could be deleted after exceeding their retentionPeriod (explained below).
-It also supports to restore or export messages matching with defined criteria in
-<a href="../operate/webadmin.html#_deleted_messages_vault" class="xref page">WebAdmin deleted messages vault document</a> by using
-<a href="../operate/webadmin.html#_deleted_messages_vault" class="xref page">WebAdmin endpoints</a>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_deleted_messages_vault_configuration"><a class="anchor" href="#_deleted_messages_vault_configuration"></a>Deleted Messages Vault Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>To make James use DeletedMessageVault, you need to configure the PreDeletionHook for it.</p>
-</div>
-<div class="paragraph">
-<p>How to do this is documented in the <a href="listeners.html" class="xref page"><strong>listeners.xml</strong></a>
-Mailbox Listener Configuration page.</p>
-</div>
-<div class="paragraph">
-<p>The Deleted Messages Vault also stores and manages deleted messages into a BlobStore. The BlobStore can be either
-based on an object storage or on Cassandra. For configuring the BlobStore the vault will use, you can look at
-<a href="blobstore.html" class="xref page"><strong>blobstore.properties</strong></a> BlobStore Configuration section.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_deletedmessagevault_properties"><a class="anchor" href="#_deletedmessagevault_properties"></a>deletedMessageVault.properties</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/deletedMessageVault.properties">example</a>
-to get some examples and hints.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. deletedMessageVault.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">retentionPeriod</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Deleted messages stored in the Deleted Messages Vault are expired after this period (default: 1 year). It can be expressed in <strong>y</strong> years, <strong>d</strong> days, <strong>h</strong> hours, …​</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/configure/webadmin.html b/james-project/3.6.0/servers/distributed/configure/webadmin.html
deleted file mode 100644
index d3d3c01..0000000
--- a/james-project/3.6.0/servers/distributed/configure/webadmin.html
+++ /dev/null
@@ -1,684 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — webadmin.properties :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item is-current-page" data-depth="5">
- <a class="nav-link" href="webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Configuration</a></li>
- <li>Protocols</li>
- <li><a href="webadmin.html">webadmin.properties</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="webadmin.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/configure/webadmin.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — webadmin.properties</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>The web administration supports for now the CRUD operations on the domains, the users, their mailboxes and their quotas,
-managing mail repositories, performing cassandra migrations, and much more, as described in the following sections.</p>
-</div>
-<div class="paragraph">
-<p><strong>WARNING</strong>: This API allows authentication only via the use of JWT. If not
-configured with JWT, an administrator should ensure an attacker can not
-use this API.</p>
-</div>
-<div class="paragraph">
-<p>By the way, some endpoints are not filtered by authentication. Those endpoints are not related to data stored in James,
-for example: Swagger documentation & James health checks.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_configuration"><a class="anchor" href="#_configuration"></a>Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Consult this <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/webadmin.properties">example</a>
-to get some examples and hints.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. webadmin.properties content</caption>
-<colgroup>
-<col style="width: 50%;">
-<col style="width: 50%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">enabled</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Define if WebAdmin is launched (default: false)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">port</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Define WebAdmin’s port (default: 8080)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">host</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Define WebAdmin’s host (default: localhost)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cors.enable</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Allow the Cross-origin resource sharing (default: false)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cors.origin</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Specify ths CORS origin (default: null)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jwt.enable</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Allow JSON Web Token as an authentication mechanism (default: false)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">https.enable</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Use https (default: false)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">https.keystore</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Specify a keystore file for https (default: null)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">https.password</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Specify the keystore password (default: null)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">https.trust.keystore</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Specify a truststore file for https (default: null)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">https.trust.password</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Specify the truststore password (default: null)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jwt.publickeypem.url</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional. JWT tokens allow request to bypass authentication. Path to the JWT public key.
-Defaults to the <code>jwt.publickeypem.url</code> value of <code>jmap.properties</code> file if unspecified
-(legacy behaviour)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">extensions.routes</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">List of Routes specified as fully qualified class name that should be loaded in addition to your product routes list. Routes
-needs to be on the classpath or in the ./extensions-jars folder. Read mode about
-<a href="../extending/webadmin-routes.html" class="xref page">creating you own webadmin routes</a>.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_generating_a_jwt_key_pair"><a class="anchor" href="#_generating_a_jwt_key_pair"></a>Generating a JWT key pair</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The Distributed server enforces the use of RSA-SHA-256.</p>
-</div>
-<div class="paragraph">
-<p>One can use OpenSSL to generate a JWT key pair :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre># private key
-openssl genrsa -out rs256-4096-private.rsa 4096
-# public key
-openssl rsa -in rs256-4096-private.rsa -pubout > rs256-4096-public.pem</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The private key can be used to generate JWT tokens, for instance
-using <a href="https://github.com/vandium-io/jwtgen">jwtgen</a>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>jwtgen -a RS256 -p rs256-4096-private.rsa 4096 -c "sub=bob@domain.tld" -c "admin=true" -e 3600 -V</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>This token can then be passed as <code>Bearer</code> of the <code>Authorization</code> header :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -H "Authorization: Bearer $token" -XGET http://127.0.0.1:8000/domains</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The public key can be referenced as <code>jwt.publickeypem.url</code> of the <code>jmap.properties</code> configuration file.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/extending/index.html b/james-project/3.6.0/servers/distributed/extending/index.html
deleted file mode 100644
index f09bda3..0000000
--- a/james-project/3.6.0/servers/distributed/extending/index.html
+++ /dev/null
@@ -1,722 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Extending server behavior :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Extending server behavior</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="index.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/extending/index.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Extending server behavior</h1>
-<div class="sect1">
-<h2 id="_available_extension_mechanisms"><a class="anchor" href="#_available_extension_mechanisms"></a>Available extension mechanisms</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The Distributed Server exposes several interfaces allowing the user to write custom extensions in
-order to extend the Distributed Server behavior.</p>
-</div>
-<div class="paragraph">
-<p>Writing <strong>Mailets</strong> and <strong>Matchers</strong> allows one to supply custom components for the
-<a href="mail-processing.html" class="xref page">Mail Processing</a> and
-enables to take decisions, and implement your business logic at the transport level.</p>
-</div>
-<div class="paragraph">
-<p>Writing <a href="mailbox-listeners.html" class="xref page">Mailbox listeners</a> enables to
-react to your user interaction with their mailbox. This powerful tool allows build advanced features
-for mail delivery servers.</p>
-</div>
-<div class="paragraph">
-<p>Writing <a href="smtp-hooks.html" class="xref page">SMTP hookd</a> enables to
-add features to your SMTP server.</p>
-</div>
-<div class="paragraph">
-<p>Writing <a href="webadmin-routes.html" class="xref page">WebAdmin routes</a> enables to
-add features to the WebAdmin REST API.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_handling_injections_for_your_extensions"><a class="anchor" href="#_handling_injections_for_your_extensions"></a>Handling injections for your extensions</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_injecting_core_components"><a class="anchor" href="#_injecting_core_components"></a>Injecting core components</h3>
-<div class="paragraph">
-<p>You can very easily inject core components into your custom extensions.</p>
-</div>
-<div class="paragraph">
-<p>All you need is to pass them via a constructor annotated via <strong>@Inject</strong>.</p>
-</div>
-<div class="paragraph">
-<p>For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>public class MyMailet extends GenericMailet {
- private final UsersRepository usersRepository;
-
- @Inject
- public MyMailet(UsersRepository usersRepository) {
- this.usersRepository = usersRepository;
- }
-
- @Override
- public void service(Mail mail) throws MessagingException {
- // Do something
- }
-}</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_injecting_simple_extension_components"><a class="anchor" href="#_injecting_simple_extension_components"></a>Injecting simple extension components</h3>
-<div class="paragraph">
-<p>Furthermore, concrete implementation, that are part of your extension, can be injected as well.</p>
-</div>
-<div class="paragraph">
-<p>Consider the following example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>public class MyService {
-
-}
-
-public class MyMailet extends GenericMailet {
- private final MyService myService;
-
- @Inject
- public MyMailet(MyService myService) {
- this.usersRepository = myService;
- }
-
- @Override
- public void service(Mail mail) throws MessagingException {
- // Do something
- }
-}</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_defining_custom_injections_for_your_extensions"><a class="anchor" href="#_defining_custom_injections_for_your_extensions"></a>Defining custom injections for your extensions</h3>
-<div class="paragraph">
-<p>However, to inject an interface into your extension, you will need additional injection definitions.</p>
-</div>
-<div class="paragraph">
-<p>To to so:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>1. Given an interface defined in a additional JAR:</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>public interface MyService {}</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>2. And an implementation of that interface, in another additional JAR:</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>public class MyServiceImpl extends MyService {}</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>3. We need to define a binding for MyService to be bound to MyServiceImpl</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>public class MyServiceModule extends AbstractModule {
- @Override
- protected void configure() {
- bind(MyServiceImpl.class).in(Scopes.SINGLETON);
- bind(MyService.class).to(MyServiceImpl.class);
- }
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Both <strong>MyService</strong>, <strong>MyServiceImpl</strong> and <strong>MyServiceModule</strong> needs to be in the <strong>extensions-jars</strong>
-folder (potentially different jars).</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>4. <strong>MyServiceModule</strong> needs to be registered in <a href="../configure/extensions.html" class="xref page"><strong>extensions.properties</strong></a></p>
-</li>
-<li>
-<p>5. <strong>MyService</strong> can then be used as part of your extensions</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>public class MyMailet extends GenericMailet {
- private final MyService myService;
-
- @Inject
- public MyMailet(MyService myService) {
- this.usersRepository = myService;
- }
-
- @Override
- public void service(Mail mail) throws MessagingException {
- // Do something
- }
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note that overriding injection definitions of the Distributed Server for your injections is not supported.</p>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/extending/mail-processing.html b/james-project/3.6.0/servers/distributed/extending/mail-processing.html
deleted file mode 100644
index 7c4666a..0000000
--- a/james-project/3.6.0/servers/distributed/extending/mail-processing.html
+++ /dev/null
@@ -1,738 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Custom mail processing components :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Extending server behavior</a></li>
- <li><a href="mail-processing.html">Custom mail processing components</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="mail-processing.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/extending/mail-processing.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Custom mail processing components</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>When none of the matchers and mailets available in James allows us to implement what we want, extension
-developers will have to write our own mailet and matcher in a separated maven project depending on James
-Mailet API.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_writing_custom_mailetsmatchers"><a class="anchor" href="#_writing_custom_mailetsmatchers"></a>Writing custom mailets/matchers</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>We will write a <strong>IsDelayedForMoreThan</strong> matcher with a configurable delay. If the Sent Date of incoming
-emails is older than specified delay, then the emails should be matched (return all mail recipients). Otherwise,
-we just return an empty list of recipients.</p>
-</div>
-<div class="paragraph">
-<p>To ease our Job, we can rely on the <strong>org.apache.james.apache-mailet-base</strong> maven project, which provides us
-a <strong>GenericMatcher</strong> that we can extend.</p>
-</div>
-<div class="paragraph">
-<p>Here is the dependency:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><dependency>
- <groupId>org.apache.james</groupId>
- <artifactId>apache-mailet-base</artifactId>
-</dependency></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The main method of a matcher is the <strong>match</strong> method:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>Collection<MailAddress> match(Mail mail) throws MessagingException;</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>For us, it becomes, with <strong>maxDelay</strong> being previously configured:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>private final Clock clock;
-private Duration maxDelay;
-
-@Override
-public Collection<MailAddress> match(Mail mail) throws MessagingException {
-Date sentDate = mail.getMessage().getSentDate();
-
- if (clock.instant().isAfter(sentDate.toInstant().plusMillis(maxDelay.toMillis()))) {
- return ImmutableList.copyOf(mail.getRecipients());
- }
- return ImmutableList.of();
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>GenericMatcher</strong> exposes us the condition that had been configured. We will use it to compute <strong>maxDelay</strong>.
-We can do it in the <strong>init()</strong> method exposed by the generic matcher:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>public static final TimeConverter.Unit DEFAULT_UNIT = TimeConverter.Unit.HOURS;
-
-@Override
-public void init() {
- String condition = getCondition();
- maxDelay = Duration.ofMillis(TimeConverter.getMilliSeconds(condition, DEFAULT_UNIT));
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Now, let’s take a look at the <strong>SendPromotionCode</strong> mailet. Of course, we want to write a generic mailet
-with a configurable reason (why are we sending the promotion code). To keep things simple, only one promotion
-code will be used, and will be written in the configuration. We can here also simply extend the
-<strong>GenericMailet</strong> helper class.</p>
-</div>
-<div class="paragraph">
-<p>The main method of a mailet is the <strong>service</strong> method:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>void service(Mail mail) throws MessagingException;</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>For us, it becomes, with <strong>reason</strong> and <strong>promotionCode</strong> being previously configured:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>public static final boolean REPLY_TO_SENDER_ONLY = false;
-
-private String reason;
-private String promotionCode;
-
-@Override
-public void service(Mail mail) throws MessagingException {
-MimeMessage response = (MimeMessage) mail.getMessage()
-.reply(REPLY_TO_SENDER_ONLY);
-
- response.setText(reason + "\n\n" +
- "Here is the following promotion code that you can use on your next order: " + promotionCode);
-
- MailAddress sender = getMailetContext().getPostmaster();
- ImmutableList<MailAddress> recipients = ImmutableList.of(mail.getSender());
-
- getMailetContext()
- .sendMail(sender, recipients, response);
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note that we can interact with the mail server through the mailet context for sending mails, knowing postmaster, etc…​</p>
-</div>
-<div class="paragraph">
-<p><strong>GenericMailet</strong> exposes us the 'init parameters' that had been configured for this mailet. We will
-use it to retrieve <strong>reason</strong> and <strong>promotionCode</strong>.
-We can do it in the <strong>init()</strong> method exposed by the generic mailet:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>@Override
-public void init() throws MessagingException {
- reason = getInitParameter("reason");
- promotionCode = getInitParameter("promotionCode");
-
- if (Strings.isNullOrEmpty(reason)) {
- throw new MessagingException("'reason' is compulsory");
- }
- if (Strings.isNullOrEmpty(promotionCode)) {
- throw new MessagingException("'promotionCode' is compulsory");
- }
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can retrieve the sources of this mini-project on <a href="https://github.com/apache/james-project/tree/master/examples/custom-mailets">GitHub</a></p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_loading_custom_mailets_with_james"><a class="anchor" href="#_loading_custom_mailets_with_james"></a>Loading custom mailets with James</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Now is the time we will run James with our awesome matcher and mailet configured.</p>
-</div>
-<div class="paragraph">
-<p>First, we will need to compile our project with <strong>mvn clean install</strong>. A jar will be outputted in the target directory.</p>
-</div>
-<div class="paragraph">
-<p>Then, we will write the <strong>mailetcontainer.xml</strong> file expressing the logic we want:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><mailetcontainer enableJmx="true">
-
-<context>
- <postmaster>postmaster@localhost</postmaster>
-</context>
-
-<spooler>
- <threads>20</threads>
-</spooler>
-
-<processors>
- <processor state="root" enableJmx="true">
- <mailet match="All" class="PostmasterAlias"/>
- <mailet match="org.apache.james.examples.custom.mailets.IsDelayedForMoreThan=1 day"
- class="org.apache.james.examples.custom.mailets.SendPromotionCode">
- <reason>Your email had been delayed for a long time. Because we are sorry about it, please find the
- following promotion code.</reason>
- <promotionCode>1542-2563-5469</promotionCode>
- </mailet>
- <!-- Rest of the configuration -->
-</processor>
-
-<!-- Other processors -->
-</processors>
-</mailetcontainer></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Finally, we will start a James server using that. We will rely on docker default image for simplicity.
-We need to be using the <strong>mailetcontainer.xml</strong> configuration that we had been writing and position
-the jar in the <strong>extensions-jars</strong> folder (specific to guice).</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/extending/mailbox-listeners.html b/james-project/3.6.0/servers/distributed/extending/mailbox-listeners.html
deleted file mode 100644
index ca9f260..0000000
--- a/james-project/3.6.0/servers/distributed/extending/mailbox-listeners.html
+++ /dev/null
@@ -1,648 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Custom Mailbox Listeners :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Extending server behavior</a></li>
- <li><a href="mailbox-listeners.html">Custom Mailbox Listeners</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="mailbox-listeners.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/extending/mailbox-listeners.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Custom Mailbox Listeners</h1>
-<div class="sect1">
-<h2 id="_writing_additional_listener"><a class="anchor" href="#_writing_additional_listener"></a>Writing additional listener</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>An extension writer can write new additional mailbox listeners.</p>
-</div>
-<div class="paragraph">
-<p>To do so, extend the <strong>GroupMailboxListener</strong> defined in the <strong>mailbox-api</strong>.</p>
-</div>
-<div class="paragraph">
-<p>Here is the dependency:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><dependency>
- <groupId>org.apache.james</groupId>
- <artifactId>apache-james-mailbox-api</artifactId>
-</dependency></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Here are the methods you can implement:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> void event(Event event) throws Exception;</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>allows you to specify the business logic you want to execute upon new events generation.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> boolean isHandling(Event event);</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Allows to know if this event is worth execution, and should be sent on the EventBus. This avoids execution of non
-handled events and can save some IOs.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_registration_of_custom_additional_listeners"><a class="anchor" href="#_registration_of_custom_additional_listeners"></a>Registration of custom additional listeners</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Your custom additional listener needs to be in the <strong>extensions-jars</strong> folder.</p>
-</div>
-<div class="paragraph">
-<p>You need to register its fully qualified class name in <a href="../configure/listeners.html" class="xref page">listeners.xml</a></p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_events"><a class="anchor" href="#_events"></a>Events</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Your listener will be called for the following events:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>MailboxAdded</strong>: A new mailbox had been created</p>
-</li>
-<li>
-<p><strong>MailboxDeletion</strong>: A new mailbox had been deleted</p>
-</li>
-<li>
-<p><strong>MailboxRenamed</strong>: A mailbox was renamed</p>
-</li>
-<li>
-<p><strong>MailboxACLUpdated</strong>: The rights of a mailbox had been changed</p>
-</li>
-<li>
-<p><strong>Expunged</strong>: Some messages had been deleted</p>
-</li>
-<li>
-<p><strong>FlagsUpdated</strong>: Some message flags had been updated</p>
-</li>
-<li>
-<p><strong>Added</strong>: New messages had been added to a mailbox</p>
-</li>
-<li>
-<p><strong>QuotaUsageUpdatedEvent</strong>: The quota of a given account had changed</p>
-</li>
-<li>
-<p><strong>MessageMoveEvent</strong>: A message was moved between mailboxes. This carries an account wide information. Spoecific
-mailboxes event (Added & Expunged) will be emitted as well.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_example"><a class="anchor" href="#_example"></a>Example</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p><a href="http://james.apache.org/howTo/custom-listeners.html">This page</a> provides a working example for writing additional custom mailbox listeners.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/extending/smtp-hooks.html b/james-project/3.6.0/servers/distributed/extending/smtp-hooks.html
deleted file mode 100644
index e27dceb..0000000
--- a/james-project/3.6.0/servers/distributed/extending/smtp-hooks.html
+++ /dev/null
@@ -1,671 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Custom SMTP hooks :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Extending server behavior</a></li>
- <li><a href="smtp-hooks.html">Custom SMTP hooks</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="smtp-hooks.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/extending/smtp-hooks.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Custom SMTP hooks</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>SMTP hooks enable extening capabilities of the SMTP server and are run synchronously upon email reception, before the email is
-enqueued in the MailQueue, and before any mail processing takes place.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_available_generic_hooks"><a class="anchor" href="#_available_generic_hooks"></a>Available generic hooks</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The following interfaces allows interacting with the following commands:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>AuthHook</strong>: Implement this interfaces to hook in the AUTH Command.</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> HookResult doAuth(SMTPSession session, Username username, String password);</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>HeloHook</strong>: Implement this interfaces to hook in the HELO Command</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> HookResult doHelo(SMTPSession session, String helo);</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>MailHook</strong>: Implement this interfaces to hook in the MAIL Command</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> HookResult doMail(SMTPSession session, MaybeSender sender);</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>MailParametersHook</strong>: Implement this interfaces to hook in the MAIL Command, this is called for specific mail arguments</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> HookResult doMailParameter(SMTPSession session, String paramName, String paramValue);</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>QuitHook</strong>: Implement this interfaces to hook in the QUIT Command</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> HookResult doQuit(SMTPSession session);</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>RcptHook</strong>: Implement this interfaces to hook in the RCPT Command</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> HookResult doRcpt(SMTPSession session, MaybeSender sender, MailAddress rcpt);</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>UnknownHook</strong>: Hook for unknown commands</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> HookResult doUnknown(SMTPSession session, String command);</pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_custom_hook_registration"><a class="anchor" href="#_custom_hook_registration"></a>Custom hook registration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Register you hooks using <a href="../configure/smtp.html" class="xref page"><strong>smtpserver.xml</strong></a> handlerchain property.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_writing_additional_smtp_commands"><a class="anchor" href="#_writing_additional_smtp_commands"></a>Writing additional SMTP commands</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>What to do if the Hook API is not enough for you ?</p>
-</div>
-<div class="paragraph">
-<p>You want for example to write a code which handles a new command like "YOURCOOLCOMMAND: whatever@example".</p>
-</div>
-<div class="paragraph">
-<p>For this kind of needs you should implement the CommandHandler interface. This gives you a lower-level API
-to handle this kind of tasks. If you want to support a custom Hook in your CommandHandler its the best to
-just extend AbstractHookableCmdHandler.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/extending/webadmin-routes.html b/james-project/3.6.0/servers/distributed/extending/webadmin-routes.html
deleted file mode 100644
index 6b69ebd..0000000
--- a/james-project/3.6.0/servers/distributed/extending/webadmin-routes.html
+++ /dev/null
@@ -1,604 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Custom WebAdmin routes :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Extending server behavior</a></li>
- <li><a href="webadmin-routes.html">Custom WebAdmin routes</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="webadmin-routes.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/extending/webadmin-routes.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Custom WebAdmin routes</h1>
-<div class="sect1">
-<h2 id="_writing_custom_webadmin_routes"><a class="anchor" href="#_writing_custom_webadmin_routes"></a>Writing custom WebAdmin routes</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>An extension writer can write additional WebAdmin routes, effectively exposed over the WebAdmin API.</p>
-</div>
-<div class="paragraph">
-<p>To do so, extend the <strong>Routes</strong> defined in the <strong>james-server-webadmin-core</strong>.</p>
-</div>
-<div class="paragraph">
-<p>Here is the dependency:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><dependency>
- <groupId>org.apache.james</groupId>
- <artifactId>james-server-webadmin-core</artifactId>
-</dependency></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Here is the interface:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>public interface Routes {
- String getBasePath();
-
- void define(Service service);
-}</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>getBasePath</strong> enables to know the prefix of your route</p>
-</li>
-<li>
-<p><strong>define</strong> enables you to register endpoint is the <a href="http://sparkjava.com/">sparkjava</a> Service instance. HTTP <strong>GET</strong>, <strong>POST</strong>,
-<strong>PUT</strong>, <strong>PATCH</strong>, etc.. verbs are supported.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_registration"><a class="anchor" href="#_registration"></a>Registration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Your custom WebAdmin routes needs to be in the <strong>extensions-jars</strong> folder.</p>
-</div>
-<div class="paragraph">
-<p>You need to register its fully qualified class name in <a href="../configure/webadmin.html" class="xref page">webadmin.properties</a>
-using the <strong>extensions.routes</strong> property.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/objectives.html b/james-project/3.6.0/servers/distributed/objectives.html
deleted file mode 100644
index 933b872..0000000
--- a/james-project/3.6.0/servers/distributed/objectives.html
+++ /dev/null
@@ -1,608 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Objectives and motivation :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../index.html">Apache James Server</a></li>
- <li><a href="../index.html">Servers</a></li>
- <li><a href="../distributed.html">Distributed</a></li>
- <li><a href="objectives.html">Objectives and motivation</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="objectives.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/objectives.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Objectives and motivation</h1>
-<div class="paragraph">
-<p>The objective of the Distributed Server is to provided facilities to execute
-an advanced, extendable, and distributed email system. It is intended for
-organization with serious requirements, such as high-throughput or very large
-data sets.</p>
-</div>
-<div class="paragraph">
-<p>Scaling emails infrastructure is a notoriously hard problem. The intent of the Distributed server is
-to implement a mail server using modern NoSQL technologies. It relies on:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Object Storage enables scalable yet cheap storage of large amount of data</p>
-</li>
-<li>
-<p>The use of NoSQL for metadata storage enables vertical scalability</p>
-</li>
-<li>
-<p>Finally a Distributed search engine enables quick and efficient search</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Replication, data availability are thus handled by battle tested technologies.</p>
-</div>
-<div class="paragraph">
-<p>Such a data storage strategy enables:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>A centralized management of all server components, as each Distributed James server hold the same view on data.</p>
-</li>
-<li>
-<p>A better load and data repartition between email servers, as each James servers can cary out any tasks.</p>
-</li>
-<li>
-<p>Easy scaling. Handling more users or more data is as easy as adding James instances and scaling the underlying
-databases.</p>
-</li>
-<li>
-<p>Easier load-balancing, as any email server can handle requests from any user. No sharding is involved.</p>
-</li>
-<li>
-<p>Rich feature, especially regarding <strong>sharing</strong>. Every user can delegate access to any over users.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Furthermore, this server is intended to be easily customisable so that it can easily be adapted to ones needs.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Several packaged extensions can be <a href="configure/index.html#_for_extensions" class="xref page">configured</a></p>
-</li>
-<li>
-<p>It is easy to write and load <a href="extending/index.html" class="xref page">your own extensions</a></p>
-</li>
-</ul>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../_/js/site.js" data-ui-root-path="../../../../_"></script>
-<script async src="../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/operate/cassandra-migration.html b/james-project/3.6.0/servers/distributed/operate/cassandra-migration.html
deleted file mode 100644
index d00f7f2..0000000
--- a/james-project/3.6.0/servers/distributed/operate/cassandra-migration.html
+++ /dev/null
@@ -1,592 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Cassandra migration :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Operate</a></li>
- <li><a href="cassandra-migration.html">Cassandra migration</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="cassandra-migration.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/operate/cassandra-migration.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Cassandra migration</h1>
-<div class="paragraph">
-<p>Cassandra upgrades implies the creation of a new table. Thus restarting James is needed, as new tables are created on restart.</p>
-</div>
-<div class="paragraph">
-<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>
-</div>
-<div class="paragraph">
-<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>
-</div>
-<div class="paragraph">
-<p>These schema updates can be triggered by <a href="webadmin.html#_cassandra_schema_upgrades" class="xref page">webadmin</a>.</p>
-</div>
-<div class="paragraph">
-<p>Note that currently the progress can be tracked by logs.</p>
-</div>
-<div class="paragraph">
-<p>Here are the implemented migrations:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>From V5 to V6</strong> : Goal is to no longer rely on an UDT partition key for mailboxPath tables. Entries will be migrated
-to mailboxPathV2 table relying on a composite primary key.</p>
-</li>
-<li>
-<p><strong>From V6 to V7</strong> : Goal is to populate mapping_sources projection table. This table allows finding the source of a given redirection, which is
-handy for things like mail aliases (I want to list aliases rewritting things to bob). Without this projection table being available,
-(ie we rely on schema version 6 or less) such information is obtained through a full table scan, unoptimized. From schema version 7,
-the optimized projection can safely be used.</p>
-</li>
-<li>
-<p><strong>From V7 to V8</strong> : Add UID_VALIDITY to mailboxPath table in order not to mandate mailbox table reads.</p>
-</li>
-<li>
-<p><strong>From V8 to V9</strong> : Adopt a more compact representation for message properties.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The <a href="guide.html#_updating_cassandra_schema_version" class="xref page">Operator guide</a> further details the migration process.</p>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/operate/cli.html b/james-project/3.6.0/servers/distributed/operate/cli.html
deleted file mode 100644
index b4317f1..0000000
--- a/james-project/3.6.0/servers/distributed/operate/cli.html
+++ /dev/null
@@ -1,1034 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Command Line Interface :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Operate</a></li>
- <li><a href="cli.html">Command Line Interface</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="cli.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/operate/cli.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Command Line Interface</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>The distributed server is packed with a command line client.</p>
-</div>
-<div class="paragraph">
-<p>To run this command line client simply execute:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>java -jar /root/james-cli.jar -h 127.0.0.1 -p 9999 COMMAND</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The following document will explain you which are the available options
-for <strong>COMMAND</strong>.</p>
-</div>
-<div class="paragraph">
-<p>Note: the above command line before <strong>COMMAND</strong> will be documented as <em>{cli}</em>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_manage_domains"><a class="anchor" href="#_manage_domains"></a>Manage Domains</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Domains represent the domain names handled by your server.</p>
-</div>
-<div class="paragraph">
-<p>You can add a domain:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} AddDomain domain.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can remove a domain:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} RemoveDomain domain.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>(Note: associated users are not removed automatically)</p>
-</div>
-<div class="paragraph">
-<p>Check if a domain is handled:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} ContainsDomain domain.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>And list your domains:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} ListDomains</pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_managing_users"><a class="anchor" href="#_managing_users"></a>Managing users</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Note: the following commands are explained with virtual hosting turned
-on.</p>
-</div>
-<div class="paragraph">
-<p>Users are accounts on the mail server. James can maintain mailboxes for
-them.</p>
-</div>
-<div class="paragraph">
-<p>You can add a user:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} AddUser user@domain.tld password</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note: the domain used should have been previously created.</p>
-</div>
-<div class="paragraph">
-<p>You can delete a user:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} RemoveUser user@domain.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>(Note: associated mailboxes are not removed automatically)</p>
-</div>
-<div class="paragraph">
-<p>And change a user password:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} SetPassword user@domain.tld password</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note: All these write operations can not be performed on LDAP backend,
-as the implementation is read-only.</p>
-</div>
-<div class="paragraph">
-<p>Finally, you can list users:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} ListUsers</pre>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_virtual_hosting"><a class="anchor" href="#_virtual_hosting"></a>Virtual hosting</h3>
-<div class="paragraph">
-<p>James supports virtualhosting.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>If set to true in the configuration, then the username is the full
-mail address.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The domains then become a part of the user.</p>
-</div>
-<div class="paragraph">
-<p><em>usera@domaina.com and</em> <em>usera@domainb.com</em> on a mail server with
-<em>domaina.com</em> and <em>domainb.com</em> configured are mail addresses that
-belongs to different users.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>If set to false in the configurations, then the username is the mail
-address local part.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>It means that a user is automatically created for all the domains
-configured on your server.</p>
-</div>
-<div class="paragraph">
-<p><em>usera@domaina.com and</em> <em>usera@domainb.com</em> on a mail server with
-<em>domaina.com</em> and <em>domainb.com</em> configured are mail addresses that
-belongs to the same users.</p>
-</div>
-<div class="paragraph">
-<p>Here are some sample commands for managing users when virtual hosting is
-turned off:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} AddUser user password
-{cli} RemoveUser user
-{cli} SetPassword user password</pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_managing_mailboxes"><a class="anchor" href="#_managing_mailboxes"></a>Managing mailboxes</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>An administrator can perform some basic operation on user mailboxes.</p>
-</div>
-<div class="paragraph">
-<p>Note on mailbox formatting: mailboxes are composed of three parts.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>The namespace, indicating what kind of mailbox it is. (Shared or
-not?). The value for users mailboxes is #private . Note that for now no
-other values are supported as James do not support shared mailboxes.</p>
-</li>
-<li>
-<p>The username as stated above, depending on the virtual hosting value.</p>
-</li>
-<li>
-<p>And finally mailbox name. Be aware that `.' serves as mailbox
-hierarchy delimiter.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<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>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} DeleteUserMailboxes user@domain.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>He can delete a specific mailbox:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} DeleteMailbox #private user@domain.tld INBOX.toBeDeleted</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>He can list the mailboxes of a specific user:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} ListUserMailboxes user@domain.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>And finally can create a specific mailbox:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} CreateMailbox #private user@domain.tld INBOX.newFolder</pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_adding_a_message_in_a_mailbox"><a class="anchor" href="#_adding_a_message_in_a_mailbox"></a>Adding a message in a mailbox</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The administrator can use the CLI to add a message in a mailbox. this
-can be done using:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} ImportEml #private user@domain.tld INBOX.newFolder /full/path/to/file.eml</pre>
-</div>
-</div>
-<div class="paragraph">
-<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 href="mailto:user@domain.tld">user@domain.tld</a>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_managing_mappings"><a class="anchor" href="#_managing_mappings"></a>Managing mappings</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>A mapping is a recipient rewriting rule. There is several kind of
-rewriting rules:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>address mapping: rewrite a given mail address into an other one.</p>
-</li>
-<li>
-<p>regex mapping.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>You can manage address mapping like (redirects email from
-<a href="mailto:fromUser@fromDomain.tld">fromUser@fromDomain.tld</a> to <a href="mailto:redirected@domain.new">redirected@domain.new</a>, then deletes the
-mapping):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} AddAddressMapping fromUser fromDomain.tld redirected@domain.new
-{cli} RemoveAddressMapping fromUser fromDomain.tld redirected@domain.new</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can manage regex mapping like this:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} AddRegexMapping redirected domain.new .*@domain.tld
-{cli} RemoveRegexMapping redirected domain.new .*@domain.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can view mapping for a mail address:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} ListUserDomainMappings user domain.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>And all mappings defined on the server:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} ListMappings</pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_manage_quotas"><a class="anchor" href="#_manage_quotas"></a>Manage quotas</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Quotas are limitations on a group of mailboxes. They can limit the
-<strong>size</strong> or the <strong>messages count</strong> in a group of mailboxes.</p>
-</div>
-<div class="paragraph">
-<p>James groups by defaults mailboxes by user (but it can be overridden),
-and labels each group with a quotaroot.</p>
-</div>
-<div class="paragraph">
-<p>To get the quotaroot a given mailbox belongs to:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} GetQuotaroot #private user@domain.tld INBOX</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Then you can get the specific quotaroot limitations.</p>
-</div>
-<div class="paragraph">
-<p>For the number of messages:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} GetMessageCountQuota quotaroot</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>And for the storage space available:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} GetStorageQuota quotaroot</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You see the maximum allowed for these values:</p>
-</div>
-<div class="paragraph">
-<p>For the number of messages:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} GetMaxMessageCountQuota quotaroot</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>And for the storage space available:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} GetMaxStorageQuota quotaroot</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can also specify maximum for these values.</p>
-</div>
-<div class="paragraph">
-<p>For the number of messages:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} SetMaxMessageCountQuota quotaroot value</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>And for the storage space available:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} SetMaxStorageQuota quotaroot value</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>With value being an integer. Please note the use of units for storage
-(K, M, G). For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} SetMaxStorageQuota someone@apache.org 4G</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Moreover, James allows to specify global maximum values, at the server
-level. Note: syntax is similar to what was exposed previously.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} SetGlobalMaxMessageCountQuota value
-{cli} GetGlobalMaxMessageCountQuota
-{cli} SetGlobalMaxStorageQuota value
-{cli} GetGlobalMaxStorageQuota</pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_re_indexing"><a class="anchor" href="#_re_indexing"></a>Re-indexing</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>James allow you to index your emails in a search engine, for making
-search faster.</p>
-</div>
-<div class="paragraph">
-<p>For some reasons, you might want to re-index your mails (inconsistencies
-across datastore, migrations).</p>
-</div>
-<div class="paragraph">
-<p>To re-index all mails of all mailboxes of all users, type:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} ReindexAll</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>And for a specific mailbox:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} Reindex #private user@domain.tld INBOX</pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_sieve_scripts_quota"><a class="anchor" href="#_sieve_scripts_quota"></a>Sieve scripts quota</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>James implements Sieve (RFC-5228). Your users can then write 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>
-</div>
-<div class="paragraph">
-<p>You can define quota for the total size of Sieve scripts, per user.</p>
-</div>
-<div class="paragraph">
-<p>Syntax is similar to what was exposed for quotas. For defaults values:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} GetSieveQuota
-{cli} SetSieveQuota value
-{cli} RemoveSieveQuota</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>And for specific user quotas:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} GetSieveUserQuota user@domain.tld
-{cli} SetSieveQuota user@domain.tld value
-{cli} RemoveSieveUserQuota user@domain.tld</pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_switching_of_mailbox_implementation"><a class="anchor" href="#_switching_of_mailbox_implementation"></a>Switching of mailbox implementation</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Migration is experimental for now. You would need to customize <strong>Spring</strong>
-configuration to add a new mailbox manager with a different bean name.</p>
-</div>
-<div class="paragraph">
-<p>You can then copy data across mailbox managers using:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{cli} CopyMailbox srcBean dstBean</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You will then need to reconfigure James to use the new mailbox manager.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/operate/guide.html b/james-project/3.6.0/servers/distributed/operate/guide.html
deleted file mode 100644
index aebe277..0000000
--- a/james-project/3.6.0/servers/distributed/operate/guide.html
+++ /dev/null
@@ -1,1405 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Operator guide :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Operate</a></li>
- <li><a href="guide.html">Operator guide</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="guide.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/operate/guide.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Operator guide</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>This guide aims to be an entry-point to the James documentation for user
-managing a distributed Guice James server.</p>
-</div>
-<div class="paragraph">
-<p>It includes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Simple architecture explanations</p>
-</li>
-<li>
-<p>Propose some diagnostics for some common issues</p>
-</li>
-<li>
-<p>Present procedures that can be set up to address these issues</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>In order to not duplicate information, existing documentation will be
-linked.</p>
-</div>
-<div class="paragraph">
-<p>Please note that this product is under active development, should be
-considered experimental and thus targets advanced users.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_basic_monitoring"><a class="anchor" href="#_basic_monitoring"></a>Basic Monitoring</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>A toolbox is available to help an administrator diagnose issues:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="logging.html" class="xref page">Structured logging into Kibana</a></p>
-</li>
-<li>
-<p><a href="metrics.html" class="xref page">Metrics graphs into Grafana</a></p>
-</li>
-<li>
-<p><a href="webadmin.html#_healthcheck" class="xref page">WebAdmin HealthChecks</a></p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_mail_processing"><a class="anchor" href="#_mail_processing"></a>Mail processing</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Currently, an administrator can monitor mail processing failure through <code>ERROR</code> log
-review. We also recommend watching in Kibana INFO logs using the
-<code>org.apache.james.transport.mailets.ToProcessor</code> value as their <code>logger</code>. Metrics about
-mail repository size, and the corresponding Grafana boards are yet to be contributed.</p>
-</div>
-<div class="paragraph">
-<p>Furthermore, given the default mailet container configuration, we recommend monitoring
-<code>cassandra://var/mail/error/</code> to be empty.</p>
-</div>
-<div class="paragraph">
-<p>WebAdmin exposes all utilities for
-<a href="webadmin.html#_reprocessing_mails_from_a_mail_repository" class="xref page">reprocessing
-all mails in a mail repository</a> or
-<a href="webadmin.html#_reprocessing_a_specific_mail_from_a_mail_repository" class="xref page">reprocessing
-a single mail in a mail repository</a>.</p>
-</div>
-<div class="paragraph">
-<p>Also, one can decide to
-<a href="webadmin.html#_removing_all_mails_from_a_mail_repository" class="xref page">delete
-all the mails of a mail repository</a> or
-<a href="webadmin.html#_removing_a_mail_from_a_mail_repository" class="xref page">delete
-a single mail of a mail repository</a>.</p>
-</div>
-<div class="paragraph">
-<p>Performance of mail processing can be monitored via the
-<a href="https://github.com/apache/james-project/blob/master/grafana-reporting/MAILET-1490071694187-dashboard.json">mailet
-grafana board</a> and
-<a href="https://github.com/apache/james-project/blob/master/grafana-reporting/MATCHER-1490071813409-dashboard.json">matcher
-grafana board</a>.</p>
-</div>
-<div class="sect2">
-<h3 id="_recipient_rewriting"><a class="anchor" href="#_recipient_rewriting"></a>Recipient rewriting</h3>
-<div class="paragraph">
-<p>Given the default configuration, errors (like loops) uopn recipient rewritting will lead
-to emails being stored in <code>cassandra://var/mail/rrt-error/</code>.</p>
-</div>
-<div class="paragraph">
-<p>We recommend monitoring the content of this mail repository to be empty.</p>
-</div>
-<div class="paragraph">
-<p>If it is not empty, we recommend
-verifying user mappings via <a href="webadmin.html#_user_mappings" class="xref page">User Mappings webadmin API</a> then once identified break the loop by removing
-some Recipient Rewrite Table entry via the
-<a href="webadmin.html#_removing_an_alias_of_an_user" class="xref page">Delete Alias</a>,
-<a href="webadmin.html#_removing_a_group_member" class="xref page">Delete Group member</a>,
-<a href="webadmin.html#_removing_a_destination_of_a_forward" class="xref page">Delete forward</a>,
-<a href="webadmin.html#_remove_an_address_mapping" class="xref page">Delete Address mapping</a>,
-<a href="webadmin.html#_removing_a_domain_mapping" class="xref page">Delete Domain mapping</a>
-or <a href="webadmin.html#_removing_a_regex_mapping" class="xref page">Delete Regex mapping</a>
-APIs (as needed).</p>
-</div>
-<div class="paragraph">
-<p>The <code>Mail.error</code> field can help diagnose the issue as well. Then once
-the root cause has been addressed, the mail can be reprocessed.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_mailbox_event_bus"><a class="anchor" href="#_mailbox_event_bus"></a>Mailbox Event Bus</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>It is possible for the administrator of James to define the mailbox
-listeners he wants to use, by adding them in the
-<a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/listeners.xml">listeners.xml</a>
-configuration file. It’s possible also to add your own custom mailbox
-listeners. This enables to enhance capabilities of James as a Mail
-Delivery Agent. You can get more information about those
-<a href="config-listeners.html">here</a>.</p>
-</div>
-<div class="paragraph">
-<p>Currently, an administrator can monitor listeners failures through
-<code>ERROR</code> log review. Metrics regarding mailbox listeners can be monitored
-via
-<a href="https://github.com/apache/james-project/blob/master/grafana-reporting/MailboxListeners-1528958667486-dashboard.json">mailbox_listeners
-grafana board</a> and
-<a href="https://github.com/apache/james-project/blob/master/grafana-reporting/MailboxListeners%20rate-1552903378376.json">mailbox_listeners_rate
-grafana board</a>.</p>
-</div>
-<div class="paragraph">
-<p>Upon exceptions, a bounded number of retries are performed (with
-exponential backoff delays). If after those retries the listener is
-still failing to perform its operation, then the event will be stored in
-the <a href="webadmin.html#_event_dead_letter" class="xref page">Event Dead Letter</a>. This
-API allows diagnosing issues, as well as redelivering the events.</p>
-</div>
-<div class="paragraph">
-<p>To check that you have undelivered events in your system, you can first
-run the associated with
-<a href="webadmin.html#_healthcheck" class="xref page">event dead letter health check</a> .
-You can explore Event DeadLetter content through WebAdmin. For
-this, <a href="webadmin.html#_listing_mailbox_listener_groups" class="xref page">list mailbox listener groups</a>
-you will get a list of groups back, allowing
-you to check if those contain registered events in each by
-<a href="webadmin.html#_listing_failed_events" class="xref page">listing their failed events</a>.</p>
-</div>
-<div class="paragraph">
-<p>If you get failed events IDs back, you can as well
-<a href="webadmin.html#_getting_event_details" class="xref page">check their details</a>.</p>
-</div>
-<div class="paragraph">
-<p>An easy way to solve this is just to trigger then the
-<a href="webadmin.html#_redeliver_all_events" class="xref page">redeliver all events</a>
-task. It will start reprocessing all the failed events registered in
-event dead letters.</p>
-</div>
-<div class="paragraph">
-<p>If for some other reason you don’t need to redeliver all events, you
-have more fine-grained operations allowing you to
-<a href="webadmin.html#_redeliver_group_events" class="xref page">redeliver group events</a>
-or even just
-<a href="webadmin.html#_redeliver_a_single_event" class="xref page">redeliver a single event</a>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_elasticsearch_indexing"><a class="anchor" href="#_elasticsearch_indexing"></a>ElasticSearch Indexing</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>A projection of messages is maintained in ElasticSearch via a listener
-plugged into the mailbox event bus in order to enable search features.</p>
-</div>
-<div class="paragraph">
-<p>You can find more information about ElasticSearch configuration
-<a href="config-elasticsearch.html">here</a>.</p>
-</div>
-<div class="sect2">
-<h3 id="_usual_troubleshooting_procedures"><a class="anchor" href="#_usual_troubleshooting_procedures"></a>Usual troubleshooting procedures</h3>
-<div class="paragraph">
-<p>As explained in the <a href="#_mailbox_event_bus">Mailbox Event Bus</a> section,
-processing those events can fail sometimes.</p>
-</div>
-<div class="paragraph">
-<p>Currently, an administrator can monitor indexation failures through
-<code>ERROR</code> log review. You can as well
-<a href="webadmin.html#_listing_failed_events" class="xref page">list failed events</a> by
-looking with the group called
-<code>org.apache.james.mailbox.elasticsearch.v7.events.ElasticSearchListeningMessageSearchIndex$ElasticSearchListeningMessageSearchIndexGroup</code>.
-A first on-the-fly solution could be to just
-<a href="#_mailbox_event_bus">redeliver those group events with event dead letter</a>.</p>
-</div>
-<div class="paragraph">
-<p>If the event storage in dead-letters fails (for instance in the face of
-Cassandra storage exceptions), then you might need to use our WebAdmin
-reIndexing tasks.</p>
-</div>
-<div class="paragraph">
-<p>From there, you have multiple choices. You can
-<a href="webadmin.html#_reindexing_all_mails" class="xref page">reIndex all mails</a>,
-<a href="webadmin.html#_reindexing_a_mailbox_mails" class="xref page">reIndex mails from a mailbox</a> or even just
-<a href="webadmin.html#_reindexing_a_single_mail_by_messageid" class="xref page">reIndex a single mail</a>.</p>
-</div>
-<div class="paragraph">
-<p>When checking the result of a reIndexing task, you might have failed
-reprocessed mails. You can still use the task ID to
-<a href="webadmin.html#_fixing_previously_failed_reindexing" class="xref page">reprocess previously failed reIndexing mails</a>.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_on_the_fly_elasticsearch_index_setting_update"><a class="anchor" href="#_on_the_fly_elasticsearch_index_setting_update"></a>On the fly ElasticSearch Index setting update</h3>
-<div class="paragraph">
-<p>Sometimes you might need to update index settings. Cases when an
-administrator might want to update index settings include:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Scaling out: increasing the shard count might be needed.</p>
-</li>
-<li>
-<p>Changing string analysers, for instance to target another language</p>
-</li>
-<li>
-<p>etc.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>In order to achieve such a procedure, you need to:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://www.elastic.co/guide/en/elasticsearch/reference/7.10/indices-create-index.html">Create
-the new index</a> with the right settings and mapping</p>
-</li>
-<li>
-<p>James uses two aliases on the mailbox index: one for reading
-(<code>mailboxReadAlias</code>) and one for writing (<code>mailboxWriteAlias</code>). First
-<a href="https://www.elastic.co/guide/en/elasticsearch/reference/7.10/indices-aliases.html">add
-an alias</a> <code>mailboxWriteAlias</code> to that new index, so that now James
-writes on the old and new indexes, while only keeping reading on the
-first one</p>
-</li>
-<li>
-<p>Now trigger a
-<a href="https://www.elastic.co/guide/en/elasticsearch/reference/7.10/docs-reindex.html">reindex</a>
-from the old index to the new one (this actively relies on <code>_source</code>
-field being present)</p>
-</li>
-<li>
-<p>When this is done, add the <code>mailboxReadAlias</code> alias to the new index</p>
-</li>
-<li>
-<p>Now that the migration to the new index is done, you can
-<a href="https://www.elastic.co/guide/en/elasticsearch/reference/7.10/indices-delete-index.html">drop
-the old index</a></p>
-</li>
-<li>
-<p>You might want as well modify the James configuration file
-<a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/elasticsearch.properties">elasticsearch.properties</a>
-by setting the parameter <code>elasticsearch.index.mailbox.name</code> to the name
-of your new index. This is to avoid that James re-creates index upon
-restart</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p><em>Note</em>: keep in mind that reindexing can be a very long operation
-depending on the volume of mails you have stored.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_solving_cassandra_inconsistencies"><a class="anchor" href="#_solving_cassandra_inconsistencies"></a>Solving cassandra inconsistencies</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Cassandra backend uses data duplication to workaround Cassandra query
-limitations. However, Cassandra is not doing transaction when writing in
-several tables, this can lead to consistency issues for a given piece of
-data. The consequence could be that the data is in a transient state
-(that should never appear outside of the system).</p>
-</div>
-<div class="paragraph">
-<p>Because of the lack of transactions, it’s hard to prevent these kind of
-issues. We had developed some features to fix some existing cassandra
-inconsistency issues that had been reported to James.</p>
-</div>
-<div class="sect2">
-<h3 id="_jmap_message_fast_view_projections"><a class="anchor" href="#_jmap_message_fast_view_projections"></a>Jmap message fast view projections</h3>
-<div class="paragraph">
-<p>When you read a Jmap message, some calculated properties are expected to
-be fast to retrieve, like <code>preview</code>, <code>hasAttachment</code>. James achieves it
-by pre-calculating and storing them into a caching table
-(<code>message_fast_view_projection</code>). Missing caches are populated on
-message reads and will temporary decrease the performance.</p>
-</div>
-<div class="sect3">
-<h4 id="_how_to_detect_the_outdated_projections"><a class="anchor" href="#_how_to_detect_the_outdated_projections"></a>How to detect the outdated projections</h4>
-<div class="paragraph">
-<p>You can watch the <code>MessageFastViewProjection</code> health check at
-<a href="webadmin.html#_check_all_components" class="xref page">webadmin documentation</a>.
-It provides a check based on the ratio of missed projection reads.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_how_to_solve"><a class="anchor" href="#_how_to_solve"></a>How to solve</h4>
-<div class="paragraph">
-<p>Since the MessageFastViewProjection is self healing, you should be
-concerned only if the health check still returns <code>degraded</code> for a while,
-there’s a possible thing you can do is looking at James logs for more
-clues.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_mailboxes"><a class="anchor" href="#_mailboxes"></a>Mailboxes</h3>
-<div class="paragraph">
-<p><code>mailboxPath</code> and <code>mailbox</code> tables share common fields like <code>mailboxId</code>
-and mailbox <code>name</code>. A successful operation of creating/renaming/delete
-mailboxes has to succeed at updating <code>mailboxPath</code> and <code>mailbox</code> table.
-Any failure on creating/updating/delete records in <code>mailboxPath</code> or
-<code>mailbox</code> can produce inconsistencies.</p>
-</div>
-<div class="sect3">
-<h4 id="_how_to_detect_the_inconsistencies"><a class="anchor" href="#_how_to_detect_the_inconsistencies"></a>How to detect the inconsistencies</h4>
-<div class="paragraph">
-<p>If you found the suspicious <code>MailboxNotFoundException</code> in your logs.
-Currently, there’s no dedicated tool for that, we recommend scheduling
-the SolveInconsistencies task below for the mailbox object on a regular
-basis, avoiding peak traffic in order to address both inconsistencies
-diagnostic and fixes.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_how_to_solve_2"><a class="anchor" href="#_how_to_solve_2"></a>How to solve</h4>
-<div class="paragraph">
-<p>An admin can run offline webadmin
-<a href="webadmin.html#_fixing_mailboxes_inconsistencies" class="xref page">solve Cassandra mailbox object inconsistencies task</a>
-in order to sanitize his
-mailbox denormalization.</p>
-</div>
-<div class="paragraph">
-<p>In order to ensure being offline, stop the traffic on SMTP, JMAP and
-IMAP ports, for example via re-configuration or firewall rules.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_mailboxes_counters"><a class="anchor" href="#_mailboxes_counters"></a>Mailboxes Counters</h3>
-<div class="paragraph">
-<p>James maintains a per mailbox projection for message count and unseen
-message count. Failures during the denormalization process will lead to
-incorrect results being returned.</p>
-</div>
-<div class="sect3">
-<h4 id="_how_to_detect_the_inconsistencies_2"><a class="anchor" href="#_how_to_detect_the_inconsistencies_2"></a>How to detect the inconsistencies</h4>
-<div class="paragraph">
-<p>Incorrect message count/message unseen count could be seen in the
-<code>Mail User Agent</code> (IMAP or JMAP). Invalid values are reported in the
-logs as warning with the following class
-<code>org.apache.james.mailbox.model.MailboxCounters</code> and the following
-message prefix: <code>Invalid mailbox counters</code>.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_how_to_solve_3"><a class="anchor" href="#_how_to_solve_3"></a>How to solve</h4>
-<div class="paragraph">
-<p>Execute the
-<a href="webadmin.html#_recomputing_mailbox_counters" class="xref page">recompute Mailbox counters task</a>.
-This task is not concurrent-safe. Concurrent
-increments & decrements will be ignored during a single mailbox
-processing. Re-running this task may eventually return the correct
-result.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_messages"><a class="anchor" href="#_messages"></a>Messages</h3>
-<div class="paragraph">
-<p>Messages are denormalized and stored in both <code>imapUidTable</code> (source of
-truth) and <code>messageIdTable</code>. Failure in the denormalization process will
-cause inconsistencies between the two tables.</p>
-</div>
-<div class="sect3">
-<h4 id="_how_to_detect_the_inconsistencies_3"><a class="anchor" href="#_how_to_detect_the_inconsistencies_3"></a>How to detect the inconsistencies</h4>
-<div class="paragraph">
-<p>User can see a message in JMAP but not in IMAP, or mark a message as
-`SEEN' in JMAP but the message flag is still unchanged in IMAP.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_how_to_solve_4"><a class="anchor" href="#_how_to_solve_4"></a>How to solve</h4>
-<div class="paragraph">
-<p>Execute the
-<a href="webadmin.html#_fixing_message_inconsistencies" class="xref page">solve Cassandra message inconsistencies task</a>. This task is not
-concurrent-safe. User actions concurrent to the inconsistency fixing
-task could result in new inconsistencies being created. However the
-source of truth <code>imapUidTable</code> will not be affected and thus re-running
-this task may eventually fix all issues.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_quotas"><a class="anchor" href="#_quotas"></a>Quotas</h3>
-<div class="paragraph">
-<p>User can monitor the amount of space and message count he is allowed to
-use, and that he is effectively using. James relies on an event bus and
-Cassandra to track the quota of an user. Upon Cassandra failure, this
-value can be incorrect.</p>
-</div>
-<div class="sect3">
-<h4 id="_how_to_detect_the_inconsistencies_4"><a class="anchor" href="#_how_to_detect_the_inconsistencies_4"></a>How to detect the inconsistencies</h4>
-<div class="paragraph">
-<p>Incorrect quotas could be seen in the <code>Mail User Agent</code> (IMAP or JMAP).</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_how_to_solve_5"><a class="anchor" href="#_how_to_solve_5"></a>How to solve</h4>
-<div class="paragraph">
-<p>Execute the
-<a href="webadmin.html#_recomputing_current_quotas_for_users" class="xref page">recompute Quotas counters task</a>. This task is not concurrent-safe. Concurrent
-operations will result in an invalid quota to be persisted. Re-running
-this task may eventually return the correct result.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_rrt_recipientrewritetable_mapping_sources"><a class="anchor" href="#_rrt_recipientrewritetable_mapping_sources"></a>RRT (RecipientRewriteTable) mapping sources</h3>
-<div class="paragraph">
-<p><code>rrt</code> and <code>mappings_sources</code> tables store information about address
-mappings. The source of truth is <code>rrt</code> and <code>mappings_sources</code> is the
-projection table containing all mapping sources.</p>
-</div>
-<div class="sect3">
-<h4 id="_how_to_detect_the_inconsistencies_5"><a class="anchor" href="#_how_to_detect_the_inconsistencies_5"></a>How to detect the inconsistencies</h4>
-<div class="paragraph">
-<p>Right now there’s no tool for detecting that, we’re proposing a
-<a href="https://issues.apache.org/jira/browse/JAMES-3069">development plan</a>. By
-the mean time, the recommendation is to execute the
-<code>SolveInconsistencies</code> task below in a regular basis.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_how_to_solve_6"><a class="anchor" href="#_how_to_solve_6"></a>How to solve</h4>
-<div class="paragraph">
-<p>Execute the Cassandra mapping <code>SolveInconsistencies</code> task described in
-<a href="webadmin.html#_operations_on_mappings_sources" class="xref page">webadmin documentation</a></p>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_setting_cassandra_user_permissions"><a class="anchor" href="#_setting_cassandra_user_permissions"></a>Setting Cassandra user permissions</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>When a Cassandra cluster is serving more than a James cluster, the
-keyspaces need isolation. It can be achieved by configuring James server
-with credentials preventing access or modification of other keyspaces.</p>
-</div>
-<div class="paragraph">
-<p>We recommend you to not use the initial admin user of Cassandra and
-provide a different one with a subset of permissions for each
-application.</p>
-</div>
-<div class="sect2">
-<h3 id="_prerequisites"><a class="anchor" href="#_prerequisites"></a>Prerequisites</h3>
-<div class="paragraph">
-<p>We’re gonna use the Cassandra super users to create roles and grant
-permissions for them. To do that, Cassandra requires you to login via
-username/password authentication and enable granting in cassandra
-configuration file.</p>
-</div>
-<div class="paragraph">
-<p>For example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>echo -e "\nauthenticator: PasswordAuthenticator" >> /etc/cassandra/cassandra.yaml
-echo -e "\nauthorizer: org.apache.cassandra.auth.CassandraAuthorizer" >> /etc/cassandra/cassandra.yaml</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_prepare_cassandra_roles_keyspaces_for_james"><a class="anchor" href="#_prepare_cassandra_roles_keyspaces_for_james"></a>Prepare Cassandra roles & keyspaces for James</h3>
-<div class="sect3">
-<h4 id="_create_a_role"><a class="anchor" href="#_create_a_role"></a>Create a role</h4>
-<div class="paragraph">
-<p>Have a look at
-<a href="http://cassandra.apache.org/doc/3.11.11/cql/security.html">cassandra documentation</a> section <code>CREATE ROLE</code> for more information</p>
-</div>
-<div class="paragraph">
-<p>E.g.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>CREATE ROLE james_one WITH PASSWORD = 'james_one' AND LOGIN = true;</pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_create_a_keyspace"><a class="anchor" href="#_create_a_keyspace"></a>Create a keyspace</h4>
-<div class="paragraph">
-<p>Have a look at
-<a href="http://cassandra.apache.org/doc/3.11.11/cql/ddl.html">cassandra documentation</a> section <code>CREATE KEYSPACE</code> for more information</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_grant_permissions_on_created_keyspace_to_the_role"><a class="anchor" href="#_grant_permissions_on_created_keyspace_to_the_role"></a>Grant permissions on created keyspace to the role</h4>
-<div class="paragraph">
-<p>The role to be used by James needs to have full rights on the keyspace
-that James is using. Assuming the keyspace name is <code>james_one_keyspace</code>
-and the role be <code>james_one</code>.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>GRANT CREATE ON KEYSPACE james_one_keyspace TO james_one; // Permission to create tables on the appointed keyspace
-GRANT SELECT ON KEYSPACE james_one_keyspace TO james_one; // Permission to select from tables on the appointed keyspace
-GRANT MODIFY ON KEYSPACE james_one_keyspace TO james_one; // Permission to update data in tables on the appointed keyspace</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>Warning</strong>: The granted role doesn’t have the right to create keyspaces,
-thus, if you haven’t created the keyspace, James server will fail to
-start is expected.</p>
-</div>
-<div class="paragraph">
-<p><strong>Tips</strong></p>
-</div>
-<div class="paragraph">
-<p>Since all of Cassandra roles used by different James are supposed to
-have a same set of permissions, you can reduce the works by creating a
-base role set like <code>typical_james_role</code> with all of necessary
-permissions. After that, with each James, create a new role and grant
-the <code>typical_james_role</code> to the newly created one. Note that, once a
-base role set is updated ( granting or revoking rights) all granted
-roles are automatically updated.</p>
-</div>
-<div class="paragraph">
-<p>E.g.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>CREATE ROLE james1 WITH PASSWORD = 'james1' AND LOGIN = true;
-GRANT typical_james_role TO james1;
-
-CREATE ROLE james2 WITH PASSWORD = 'james2' AND LOGIN = true;
-GRANT typical_james_role TO james2;</pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_revoke_harmful_permissions_from_the_created_role"><a class="anchor" href="#_revoke_harmful_permissions_from_the_created_role"></a>Revoke harmful permissions from the created role</h4>
-<div class="paragraph">
-<p>We want a specific role that cannot describe or query the information of
-other keyspaces or tables used by another application. By default,
-Cassandra allows every role created to have the right to describe any
-keyspace and table. There’s no configuration that can make effect on
-that topic. Consequently, you have to accept that your data models are
-still being exposed to anyone having credentials to Cassandra.</p>
-</div>
-<div class="paragraph">
-<p>For more information, have a look at
-<a href="http://cassandra.apache.org/doc/3.11.11/cql/security.html">cassandra documentation</a> section <code>REVOKE PERMISSION</code>.</p>
-</div>
-<div class="paragraph">
-<p>Except for the case above, the permissions are not auto available for a
-specific role unless they are granted by <code>GRANT</code> command. Therefore, if
-you didn’t provide more permissions than
-<a href="#Grant_permissions_on_created_keyspace_to_the_role">granting
-section</a>, there’s no need to revoke.</p>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_cassandra_table_level_configuration"><a class="anchor" href="#_cassandra_table_level_configuration"></a>Cassandra table level configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>While <em>Distributed James</em> is shipped with default table configuration
-options, these settings should be refined depending of your usage.</p>
-</div>
-<div class="paragraph">
-<p>These options are:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>The <a href="https://cassandra.apache.org/doc/latest/operating/compaction.html">compaction algorithms</a></p>
-</li>
-<li>
-<p>The <a href="https://cassandra.apache.org/doc/latest/operating/bloom_filters.html">bloom filter sizing</a></p>
-</li>
-<li>
-<p>The <a href="https://cassandra.apache.org/doc/latest/operating/compression.html?highlight=chunk%20size">chunk size</a></p>
-</li>
-<li>
-<p>Thehttps://www.datastax.com/blog/2011/04/maximizing-cache-benefit-cassandra[cachingoptions]</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The compaction algorithms allow a tradeoff between background IO upon
-writes and reads. We recommend:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Using <strong>Leveled Compaction Strategy</strong> on
-read intensive tables subject to updates. This limits the count of
-SStables being read at the cost of more background IO. High garbage
-collections can be caused by an inappropriate use of Leveled Compaction
-Strategy.</p>
-</li>
-<li>
-<p>Otherwise use the default <strong>Size Tiered Compaction Strategy</strong>.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Bloom filters help avoiding unnecessary reads on SSTables. This
-probabilistic data structure can tell an entry absence from a SSTable,
-as well as the presence of an entry with an associated probability. If a
-lot of false positives are noticed, the size of the bloom filters can be
-increased.</p>
-</div>
-<div class="paragraph">
-<p>As explained in
-<a href="https://thelastpickle.com/blog/2018/08/08/compression_performance.html">this post</a>,
-chunk size used upon compression allows a tradeoff between reads
-and writes. A smaller size will mean decreasing compression, thus it
-increases data being stored on disk, but allow lower chunks to be read
-to access data, and will favor reads. A bigger size will mean better
-compression, thus writing less, but it might imply reading bigger
-chunks.</p>
-</div>
-<div class="paragraph">
-<p>Cassandra enables a key cache and a row cache. Key cache enables to skip
-reading the partition index upon reads, thus performing 1 read to the
-disk instead of 2. Enabling this cache is globally advised. Row cache
-stores the entire row in memory. It can be seen as an optimization, but
-it might actually use memory no longer available for instance for file
-system cache. We recommend turning it off on modern SSD hardware.</p>
-</div>
-<div class="paragraph">
-<p>A review of your usage can be conducted using
-<a href="https://cassandra.apache.org/doc/latest/tools/nodetool/nodetool.html">nodetool</a>
-utility. For example <code>nodetool tablestats {keyspace}</code> allows reviewing
-the number of SSTables, the read/write ratios, bloom filter efficiency.
-<code>nodetool tablehistograms {keyspace}.{table}</code> might give insight about
-read/write performance.</p>
-</div>
-<div class="paragraph">
-<p>Table level options can be changed using <strong>ALTER TABLE</strong> for example with
-the <a href="https://cassandra.apache.org/doc/latest/tools/cqlsh.html">cqlsh</a>
-utility. A full compaction might be needed in order for the changes to
-be taken into account.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_mail_queue"><a class="anchor" href="#_mail_queue"></a>Mail Queue</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_fine_tune_configuration_for_rabbitmq"><a class="anchor" href="#_fine_tune_configuration_for_rabbitmq"></a>Fine tune configuration for RabbitMQ</h3>
-<div class="paragraph">
-<p>In order to adapt mail queue settings to the actual traffic load, an
-administrator needs to perform fine configuration tunning as explained
-in
-<a href="https://github.com/apache/james-project/blob/master/src/site/xdoc/server/config-rabbitmq.xml">rabbitmq.properties</a>.</p>
-</div>
-<div class="paragraph">
-<p>Be aware that <code>MailQueue::getSize</code> is currently performing a browse and
-thus is expensive. Size recurring metric reporting thus introduces
-performance issues. As such, we advise setting
-<code>mailqueue.size.metricsEnabled=false</code>.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_managing_email_queues"><a class="anchor" href="#_managing_email_queues"></a>Managing email queues</h3>
-<div class="paragraph">
-<p>Managing an email queue is an easy task if you follow this procedure:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>First, <a href="webadmin.html#_listing_mail_queues" class="xref page">List mail queues</a>
-and <a href="webadmin.html#_getting_a_mail_queue_details" class="xref page">get a mail queue details</a>.</p>
-</li>
-<li>
-<p>And then
-<a href="webadmin.html#_listing_the_mails_of_a_mail_queue" class="xref page">List the mails of a mail queue</a>.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>In case, you need to clear an email queue because there are only spam or
-trash emails in the email queue you have this procedure to follow:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>All mails from the given mail queue will be deleted with
-<a href="webadmin.html#_clearing_a_mail_queue" class="xref page">Clearing a mail queue</a>.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_updating_cassandra_schema_version"><a class="anchor" href="#_updating_cassandra_schema_version"></a>Updating Cassandra schema version</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>A schema version indicates you which schema your James server is relying
-on. The schema version number tracks if a migration is required. For
-instance, when the latest schema version is 2, and the current schema
-version is 1, you might think that you still have data in the deprecated
-Message table in the database. Hence, you need to migrate these messages
-into the MessageV2 table. Once done, you can safely bump the current
-schema version to 2.</p>
-</div>
-<div class="paragraph">
-<p>Relying on outdated schema version prevents you to benefit from the
-newest performance and safety improvements. Otherwise, there’s something
-very unexpected in the way we manage cassandra schema: we create new
-tables without asking the admin about it. That means your James version
-is always using the last tables but may also take into account the old
-ones if the migration is not done yet.</p>
-</div>
-<div class="sect2">
-<h3 id="_how_to_detect_when_we_should_update_cassandra_schema_version"><a class="anchor" href="#_how_to_detect_when_we_should_update_cassandra_schema_version"></a>How to detect when we should update Cassandra schema version</h3>
-<div class="paragraph">
-<p>When you see in James logs
-<code>org.apache.james.modules.mailbox.CassandraSchemaVersionStartUpCheck</code>
-showing a warning like <code>Recommended version is versionX</code>, you should
-perform an update of the Cassandra schema version.</p>
-</div>
-<div class="paragraph">
-<p>Also, we keep track of changes needed when upgrading to a newer version.
-You can read this
-<a href="https://github.com/apache/james-project/blob/master/upgrade-instructions.md">upgrade
-instructions</a>.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_how_to_update_cassandra_schema_version"><a class="anchor" href="#_how_to_update_cassandra_schema_version"></a>How to update Cassandra schema version</h3>
-<div class="paragraph">
-<p>These schema updates can be triggered by webadmin using the Cassandra
-backend. Following steps are for updating Cassandra schema version:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>At the very first step, you need to
-<a href="webadmin.html#_retrieving_current_cassandra_schema_version" class="xref page">retrieve
-current Cassandra schema version</a></p>
-</li>
-<li>
-<p>And then, you
-<a href="webadmin.html#_retrieving_latest_available_cassandra_schema_version" class="xref page">retrieve
-latest available Cassandra schema version</a> to make sure there is a
-latest available version</p>
-</li>
-<li>
-<p>Eventually, you can update the current schema version to the one you
-got with
-<a href="webadmin.html#_upgrading_to_the_latest_version" class="xref page">upgrading to
-the latest version</a></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Otherwise, if you need to run the migrations to a specific version, you
-can use
-<a href="webadmin.html#_upgrading_to_a_specific_version" class="xref page">Upgrading to a
-specific version</a></p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_deleted_message_vault"><a class="anchor" href="#_deleted_message_vault"></a>Deleted Message Vault</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>We recommend the administrator to
-<a href="#_cleaning_expired_deleted_messages">run it</a> in cron job to save
-storage volume.</p>
-</div>
-<div class="sect2">
-<h3 id="_how_to_configure_deleted_messages_vault"><a class="anchor" href="#_how_to_configure_deleted_messages_vault"></a>How to configure deleted messages vault</h3>
-<div class="paragraph">
-<p>To setup James with Deleted Messages Vault, you need to follow those
-steps:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Enable Deleted Messages Vault by configuring Pre Deletion Hooks.</p>
-</li>
-<li>
-<p>Configuring the retention time for the Deleted Messages Vault.</p>
-</li>
-</ul>
-</div>
-<div class="sect3">
-<h4 id="_enable_deleted_messages_vault_by_configuring_pre_deletion_hooks"><a class="anchor" href="#_enable_deleted_messages_vault_by_configuring_pre_deletion_hooks"></a>Enable Deleted Messages Vault by configuring Pre Deletion Hooks</h4>
-<div class="paragraph">
-<p>You need to configure this hook in
-<a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/listeners.xml">listeners.xml</a>
-configuration file. More details about configuration & example can be
-found at <a href="http://james.apache.org/server/config-listeners.html">Pre
-Deletion Hook Configuration</a></p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_configuring_the_retention_time_for_the_deleted_messages_vault"><a class="anchor" href="#_configuring_the_retention_time_for_the_deleted_messages_vault"></a>Configuring the retention time for the Deleted Messages Vault</h4>
-<div class="paragraph">
-<p>In order to configure the retention time for the Deleted Messages Vault,
-an administrator needs to perform fine configuration tunning as
-explained in
-<a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra/destination/conf/deletedMessageVault.properties">deletedMessageVault.properties</a>.
-Mails are not retained forever as you have to configure a retention
-period (by <code>retentionPeriod</code>) before using it (with one-year retention
-by default if not defined).</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_restore_deleted_messages_after_deletion"><a class="anchor" href="#_restore_deleted_messages_after_deletion"></a>Restore deleted messages after deletion</h3>
-<div class="paragraph">
-<p>After users deleted their mails and emptied the trash, the admin can use
-<a href="webadmin.html#_restore_deleted_messagest" class="xref page">Restore Deleted Messages</a>
-to restore all the deleted mails.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_cleaning_expired_deleted_messages"><a class="anchor" href="#_cleaning_expired_deleted_messages"></a>Cleaning expired deleted messages</h3>
-<div class="paragraph">
-<p>You can delete all deleted messages older than the configured
-<code>retentionPeriod</code> by using
-<a href="webadmin.html#_deleted_messages_vault" class="xref page">Purge Deleted Messages</a>.
-We recommend calling this API in CRON job on 1st day each
-month.</p>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/operate/index.html b/james-project/3.6.0/servers/distributed/operate/index.html
deleted file mode 100644
index 30d13ea..0000000
--- a/james-project/3.6.0/servers/distributed/operate/index.html
+++ /dev/null
@@ -1,580 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Operate the Distributed server :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Operate</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="index.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/operate/index.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Operate the Distributed server</h1>
-<div class="paragraph">
-<p>The following pages detail how to operate the Distributed server.</p>
-</div>
-<div class="paragraph">
-<p>Once you have a Distributed James server up and running you then need to ensure it operates correctly.
-You may also need to perform some operation maintenance or recover from incidents. This section covers
-these topics.</p>
-</div>
-<div class="paragraph">
-<p>Read more about <a href="logging.html" class="xref page">Logging</a>.</p>
-</div>
-<div class="paragraph">
-<p>The <a href="webadmin.html" class="xref page">WebAdmin Restfull administration API</a> is the
-recommended way to operate the Distributed James server. It allows managing and interacting with most
-server components.</p>
-</div>
-<div class="paragraph">
-<p>The <a href="cli.html" class="xref page">Command line interface</a> allows to interact with some
-server components. However it relies on JMX technologies and its use is discouraged.</p>
-</div>
-<div class="paragraph">
-<p>The <a href="metrics.html" class="xref page">metrics</a> allows to build latency and throughput
-graphs, that can be visualized, for instance in <strong>Grafana</strong>.</p>
-</div>
-<div class="paragraph">
-<p>We did put together a <a href="guide.html" class="xref page">detailed guide</a> for
-distributed James operators.</p>
-</div>
-<div class="paragraph">
-<p>We also included a guide for <a href="migrating.html" class="xref page">migrating existing data</a> into the distributed server.</p>
-</div>
-<div class="paragraph">
-<p>Read more about <a href="cassandra-migration.html" class="xref page">Cassandra data migration</a>.</p>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/operate/logging.html b/james-project/3.6.0/servers/distributed/operate/logging.html
deleted file mode 100644
index cea46f2..0000000
--- a/james-project/3.6.0/servers/distributed/operate/logging.html
+++ /dev/null
@@ -1,941 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Logging :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="guide.html">Operator guide</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Operate</a></li>
- <li><a href="logging.html">Logging</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="logging.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/operate/logging.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Logging</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>We recommend to closely monitoring <strong>ERROR</strong> and <strong>WARNING</strong> logs. Those
-logs should be considered not normal.</p>
-</div>
-<div class="paragraph">
-<p>If you encounter some suspicious logs:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>If you have any doubt about the log being caused by a bug in James
-source code, please reach us via the bug tracker, the user mailing list or our Gitter channel (see our
-<a href="http://james.apache.org/#second">community page</a>)</p>
-</li>
-<li>
-<p>They can be due to insufficient performance from tier applications (eg
-Cassandra timeouts). In such case we advise you to conduct a close
-review of performances at the tier level.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Leveraging filters in Kibana discover view can help to filter out
-''already known'' frequently occurring logs.</p>
-</div>
-<div class="paragraph">
-<p>When reporting ERROR or WARNING logs, consider adding the full logs, and
-related data (eg the raw content of a mail triggering an issue) to the
-bug report in order to ease resolution.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_logging_configuration"><a class="anchor" href="#_logging_configuration"></a>Logging configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Distributed James uses <a href="http://logback.qos.ch/">logback</a> as a logging library
-and <a href="https://docs.fluentbit.io/">FluentBit</a> as centralize logging.</p>
-</div>
-<div class="paragraph">
-<p>Information about logback configuration can be found
-<a href="http://logback.qos.ch/manual/configuration.html">here</a>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_structured_logging"><a class="anchor" href="#_structured_logging"></a>Structured logging</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_pushing_logs_to_elasticsearch"><a class="anchor" href="#_pushing_logs_to_elasticsearch"></a>Pushing logs to ElasticSearch</h3>
-<div class="paragraph">
-<p>Distributed Server leverages the use of MDC in order to achieve structured logging,
-and better add context to the logged information. We furthermore ship
-<a href="https://github.com/linagora/logback-elasticsearch-appender">Logback Elasticsearch Appender</a>
-on the classpath to easily allow direct log indexation in
-<a href="https://www.elastic.co/elasticsearch">ElasticSearch</a>.</p>
-</div>
-<div class="paragraph">
-<p>Here is a sample <code>conf/logback.xml</code> configuration file for logback with the following
-pre-requisites:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Logging both in an unstructured fashion on the console and in a structured fashion in ElasticSearch</p>
-</li>
-<li>
-<p>Logging ElasticSearch Log appender logs in the console</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Configuration for pushing log direct to ElasticSearch</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Logging ElasticSearch Log appender logs in the console</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><?xml version="1.0" encoding="UTF-8"?>
-<configuration scan="true" scanPeriod="30 seconds">
-
- <contextListener class="ch.qos.logback.classic.jul.LevelChangePropagator">
- <resetJUL>true</resetJUL>
- </contextListener>
-
- <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
- <encoder>
- <pattern>%d{yyyy.MM.dd HH:mm:ss.SSS} %highlight([%-5level]) %logger{15} - %msg%n%rEx</pattern>
- <immediateFlush>false</immediateFlush>
- </encoder>
- </appender>
-
- <appender name="ELASTIC" class="com.linagora.logback.elasticsearch.ElasticsearchAppender">
- <url>http://elasticsearch:9200/_bulk</url>
- <index>logs-james-%date{yyyy.MM.dd}</index>
- <type>tester</type>
- <includeMdc>true</includeMdc>
- <excludedMdcKeys>host</excludedMdcKeys>
- <errorLoggerName>es-error-logger</errorLoggerName>
- <properties>
- <property>
- <name>host</name>
- <value>${HOSTNAME}</value>
- <allowEmpty>false</allowEmpty>
- </property>
- <property>
- <name>severity</name>
- <value>%level</value>
- </property>
- <property>
- <name>thread</name>
- <value>%thread</value>
- </property>
- <property>
- <name>stacktrace</name>
- <value>%ex</value>
- </property>
- <property>
- <name>logger</name>
- <value>%logger</value>
- </property>
- </properties>
- <headers>
- <header>
- <name>Content-Type</name>
- <value>application/json</value>
- </header>
- </headers>
- </appender>
-
- <root level="WARN">
- <appender-ref ref="ELASTIC" />
- </root>
-
- <logger name="es-error-logger" level="DEBUG" additivity="false">
- <appender-ref ref="CONSOLE" />
- </logger>
-
- <logger name="org.apache.james" level="INFO" />
-
-</configuration></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_using_fluentbit_as_a_log_forwarder"><a class="anchor" href="#_using_fluentbit_as_a_log_forwarder"></a>Using FluentBit as a log forwarder</h3>
-<div class="sect3">
-<h4 id="_using_docker"><a class="anchor" href="#_using_docker"></a>Using Docker</h4>
-<div class="paragraph">
-<p>Distributed Server leverages the use of MDC in order to achieve structured logging, and better add context to the logged information. We furthermore ship json logs to file with RollingFileAppender on the classpath to easily allow FluentBit to directly tail the log file.
-Here is a sample conf/logback.xml configuration file for logback with the following pre-requisites:</p>
-</div>
-<div class="paragraph">
-<p>Logging in a structured json fashion and write to file for centralizing logging.
-Centralize logging third party like FluentBit can tail from logging’s file then filter/process and put in to ElastichSearch</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><?xml version="1.0" encoding="UTF-8"?>
-<configuration>
-
- <contextListener class="ch.qos.logback.classic.jul.LevelChangePropagator">
- <resetJUL>true</resetJUL>
- </contextListener>
-
- <appender name="LOG_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
- <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
- <fileNamePattern>logs/james.%d{yyyy-MM-dd}.%i.log</fileNamePattern>
- <maxHistory>1</maxHistory>
- <totalSizeCap>200MB</totalSizeCap>
- <maxFileSize>100MB</maxFileSize>
- </rollingPolicy>
-
- <encoder class="ch.qos.logback.core.encoder.LayoutWrappingEncoder">
- <layout class="ch.qos.logback.contrib.json.classic.JsonLayout">
- <timestampFormat>yyyy-MM-dd'T'HH:mm:ss.SSSX</timestampFormat>
- <timestampFormatTimezoneId>Etc/UTC</timestampFormatTimezoneId>
-
- <!-- Importance for handling multiple lines log -->
- <appendLineSeparator>true</appendLineSeparator>
-
- <jsonFormatter class="ch.qos.logback.contrib.jackson.JacksonJsonFormatter">
- <prettyPrint>false</prettyPrint>
- </jsonFormatter>
- </layout>
- </encoder>
- </appender>
-
- <root level="INFO">
- <appender-ref ref="LOG_FILE" />
- </root>
-
-</configuration></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>First you need to create a <code>logs</code> folder, then mount it to James container and to FluentBit.</p>
-</div>
-<div class="paragraph">
-<p>docker-compose:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>version: "3"
-
-services:
- james:
- depends_on:
- - elasticsearch
- - cassandra
- - rabbitmq
- - s3
- entrypoint: bash -c "java -cp 'james-server.jar:extension-jars/*:james-server-memory-guice.lib/*' -Dworking.directory=/root/ -Dlogback.configurationFile=/root/conf/logback.xml org.apache.james.CassandraRabbitMQJamesServerMain"
- image: linagora/james-rabbitmq-project:branch-master
- container_name: james
- hostname: james.local
- volumes:
- - ./extension-jars:/root/extension-jars
- - ./conf/logback.xml:/root/conf/logback.xml
- - ./logs:/root/logs
- ports:
- - "80:80"
- - "25:25"
- - "110:110"
- - "143:143"
- - "465:465"
- - "587:587"
- - "993:993"
- - "8080:8000"
-
- elasticsearch:
- image: docker.elastic.co/elasticsearch/elasticsearch:7.10.2
- ports:
- - "9200:9200"
- environment:
- - discovery.type=single-node
-
- cassandra:
- image: cassandra:3.11.10
- ports:
- - "9042:9042"
-
- rabbitmq:
- image: rabbitmq:3.8.1-management
- ports:
- - "5672:5672"
- - "15672:15672"
-
- s3:
- image: zenko/cloudserver:8.2.6
- container_name: s3.docker.test
- environment:
- - SCALITY_ACCESS_KEY_ID=accessKey1
- - SCALITY_SECRET_ACCESS_KEY=secretKey1
- - S3BACKEND=mem
- - LOG_LEVEL=trace
- - REMOTE_MANAGEMENT_DISABLE=1
-
- fluent-bit:
- image: fluent/fluent-bit:1.5.7
- volumes:
- - ./fluentbit/fluent-bit.conf:/fluent-bit/etc/fluent-bit.conf
- - ./fluentbit/parsers.conf:/fluent-bit/etc/parsers.conf
- - ./logs:/fluent-bit/log
- ports:
- - "24224:24224"
- - "24224:24224/udp"
- depends_on:
- - elasticsearch
-
- kibana:
- image: docker.elastic.co/kibana/kibana:7.10.2
- environment:
- ELASTICSEARCH_HOSTS: http://elasticsearch:9200
- ports:
- - "5601:5601"
- depends_on:
- - elasticsearch</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>FluentBit config as:
-the <code>Host elasticsearch</code> pointing to <code>elasticsearch</code> service in docker-compose file.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[SERVICE]
- Parsers_File /fluent-bit/etc/parsers.conf
-
-[INPUT]
- name tail
- path /fluent-bit/log/*.log
- Parser docker
- docker_mode on
- buffer_chunk_size 1MB
- buffer_max_size 1MB
- mem_buf_limit 64MB
- Refresh_Interval 30
-
-[OUTPUT]
- Name stdout
- Match *
-
-
-[OUTPUT]
- Name es
- Match *
- Host elasticsearch
- Port 9200
- Index fluentbit
- Logstash_Format On
- Logstash_Prefix fluentbit-james
- Type docker</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>FluentBit Parser config:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[PARSER]
- Name docker
- Format json
- Time_Key timestamp
- Time_Format %Y-%m-%dT%H:%M:%S.%LZ
- Time_Keep On
- Decode_Field_As escaped_utf8 log do_next
- Decode_Field_As escaped log do_next
- Decode_Field_As json log</pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_using_kubernetes"><a class="anchor" href="#_using_kubernetes"></a>Using Kubernetes</h4>
-<div class="paragraph">
-<p>If using James in a Kubernetes environment, you can just append the logs to the console in a JSON formatted way
-using Jackson to easily allow FluentBit to directly tail them.</p>
-</div>
-<div class="paragraph">
-<p>Here is a sample conf/logback.xml configuration file for achieving this:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre><?xml version="1.0" encoding="UTF-8"?>
-<configuration>
-
- <contextListener class="ch.qos.logback.classic.jul.LevelChangePropagator">
- <resetJUL>true</resetJUL>
- </contextListener>
-
- <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
- <encoder class="ch.qos.logback.core.encoder.LayoutWrappingEncoder">
- <layout class="ch.qos.logback.contrib.json.classic.JsonLayout">
- <timestampFormat>yyyy-MM-dd'T'HH:mm:ss.SSSX</timestampFormat>
- <timestampFormatTimezoneId>Etc/UTC</timestampFormatTimezoneId>
-
- <!-- Importance for handling multiple lines log -->
- <appendLineSeparator>true</appendLineSeparator>
-
- <jsonFormatter class="ch.qos.logback.contrib.jackson.JacksonJsonFormatter">
- <prettyPrint>false</prettyPrint>
- </jsonFormatter>
- </layout>
- </encoder>
- </appender>
-
- <root level="INFO">
- <appender-ref ref="CONSOLE" />
- </root>
-
-</configuration></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Regarding FluentBit on Kubernetes, you need to install it as a DaemonSet. Some official template exist
-with FluentBit outputting logs to ElasticSearch. For more information on how to install it,
-with your cluster, you can look at this <a href="https://docs.fluentbit.io/manual/installation/kubernetes">documentation</a>.</p>
-</div>
-<div class="paragraph">
-<p>As stated by the <a href="https://docs.fluentbit.io/manual/installation/kubernetes#details">detail</a> of the
-official documentation, FluentBit is configured to consume out of the box logs from containers
-on the same running node. So it should scrap your James logs without extra configuration.</p>
-</div>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/operate/metrics.html b/james-project/3.6.0/servers/distributed/operate/metrics.html
deleted file mode 100644
index dee78ad..0000000
--- a/james-project/3.6.0/servers/distributed/operate/metrics.html
+++ /dev/null
@@ -1,783 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Metrics :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Operate</a></li>
- <li><a href="metrics.html">Metrics</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="metrics.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/operate/metrics.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Metrics</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>James relies on the <a href="https://metrics.dropwizard.io/4.1.2/manual/core.html">Dropwizard metric library</a>
-for keeping track of some core metrics of James.</p>
-</div>
-<div class="paragraph">
-<p>Such metrics are made available via JMX. You can connect for instance using VisualVM and the associated
-mbean plugins.</p>
-</div>
-<div class="paragraph">
-<p>You can also export the metrics to ElasticSearch and visualize them with <a href="https://grafana.com/">Grafana</a>.
-See <a href="../configure/elasticsearch.html#_exporting_metrics_directly_to_elasticsearch" class="xref page">elaticseach.properties</a>
-documentation for more details on how to set this up.</p>
-</div>
-<div class="paragraph">
-<p>If some metrics seem abnormally slow despite in depth database
-performance tuning, feedback is appreciated as well on the bug tracker,
-the user mailing list or our Gitter channel (see our
-<a href="http://james.apache.org/#second">community page</a>) . Any additional
-details categorizing the slowness are appreciated as well (details of
-the slow requests for instance).</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_available_metrics"><a class="anchor" href="#_available_metrics"></a>Available metrics</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Here are the available metrics :</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>James JVM metrics</p>
-</li>
-<li>
-<p>Number of active SMTP connections</p>
-</li>
-<li>
-<p>Number of SMTP commands received</p>
-</li>
-<li>
-<p>Number of active IMAP connections</p>
-</li>
-<li>
-<p>Number of IMAP commands received</p>
-</li>
-<li>
-<p>Number of active LMTP connections</p>
-</li>
-<li>
-<p>Number of LMTP commands received</p>
-</li>
-<li>
-<p>Number of per queue number of enqueued mails</p>
-</li>
-<li>
-<p>Number of sent emails</p>
-</li>
-<li>
-<p>Number of delivered emails</p>
-</li>
-<li>
-<p>Diverse Response time percentiles, counts and rates for JMAP</p>
-</li>
-<li>
-<p>Diverse Response time percentiles, counts and rates for IMAP</p>
-</li>
-<li>
-<p>Diverse Response time percentiles, counts and rates for SMTP</p>
-</li>
-<li>
-<p>Diverse Response time percentiles, counts and rates for WebAdmin</p>
-</li>
-<li>
-<p>Diverse Response time percentiles, counts and rates for each Mail Queue</p>
-</li>
-<li>
-<p>Per mailet and per matcher Response time percentiles</p>
-</li>
-<li>
-<p>Diverse Response time percentiles, counts and rates for DNS</p>
-</li>
-<li>
-<p>Cassandra Java driver metrics</p>
-</li>
-<li>
-<p>Tika HTTP client statistics</p>
-</li>
-<li>
-<p>SpamAssassin TCP client statistics</p>
-</li>
-<li>
-<p>Mailbox listeners statistics time percentiles</p>
-</li>
-<li>
-<p>Mailbox listeners statistics requests rate</p>
-</li>
-<li>
-<p>Pre-deletion hooks execution statistics time percentiles</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_available_grafana_boards"><a class="anchor" href="#_available_grafana_boards"></a>Available Grafana boards</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Here are the various relevant Grafana boards for the Distributed Server:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://github.com/apache/james-project/blob/master/grafana-reporting/BlobStore-1543222647953-dashboard.json">BlobStore</a> :
-Rates and percentiles for the BlobStore component</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/blob/master/grafana-reporting/CacheBlobStore-15911761170000-dashboard.json">BlobStore Cache</a> :
-Hit ratios and percentiles for the BlobStore Cache component. Note that this is relevant if this component is configured.</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/blob/master/grafana-reporting/Cassandra_driver-1504068385404-dashboard.json">Cassandra driver</a> :
-Exposes some dashboard for the merics collected by the Cassandra driver, like request counts, and percentiles.</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/blob/master/grafana-reporting/DeletedMessagesVault-1563771591074-dashboard.json">Deleted Message Vault</a> :
-Exposes metrics for the deleted message vault. Note that this is relevant if this component is configured.</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/blob/master/grafana-reporting/JAMES_DNS_dashboard-1491268903944-dashboard.json">DNS</a> :
-Latencies and query counts for DNS resolution.</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/blob/master/grafana-reporting/IMAP_board-1488774825351-dashboard.json">IMAP</a> :
-Latencies for the IMAP protocol</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/blob/master/grafana-reporting/IMAP_count_board-1488774815587-dashboard.json">IMAP counts</a> :
-Request counts for the IMAP protocol</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/blob/master/grafana-reporting/James_JVM-1504068360629-dashboard.json">JVM</a> :
-JVM statistics (heap, gcs, etc…​)</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/blob/master/grafana-reporting/MAILET-1490071694187-dashboard.json">Mailets</a> :
-Per-mailet execution timings.</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/blob/master/grafana-reporting/MATCHER-1490071813409-dashboard.json">Matchers</a> :
-Per-matcher execution timings
--https://github.com/apache/james-project/blob/master/grafana-reporting/MailQueue-1490071879988-dashboard.json[MailQueue] :
-MailQueue statistics</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/blob/master/grafana-reporting/MailboxListeners%20rate-1552903378376.json">MailboxListener rates</a> :
-Mailbox events processing rate</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/blob/master/grafana-reporting/MailboxListeners-1528958667486-dashboard.json">MailboxListener</a> :
-Mailbox events processing latencies</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/blob/master/grafana-reporting/MessageFastViewProjection-1575520507952.json">MessageFastViewProjection</a> :
-Hit ratio & latencies for the JMAP Message FastView projection</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/blob/master/grafana-reporting/Miscalleneous-1490072265151-dashboard.json">Miscalleneous</a> :
-Collection of various metrics not included in other boards.</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/blob/master/grafana-reporting/PreDeletionHooks-1553684324244-dashboard.json">PreDeletionHooks</a> :
-Latencies for PreDeletionHooks. Note that this is relevant if this component is configured.</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/blob/master/grafana-reporting/SMTP_board-1488774774172-dashboard.json">SMTP</a> :
-SMTP latencies reports</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/blob/master/grafana-reporting/SMTP_count_board-1488774761350-dashboard.json">SMTP count</a> :
-Request count for the SMTP protocol</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/blob/master/grafana-reporting/SpamAssassin-1522226824255-dashboard.json">SpamAssassin</a> :
-Latencies for SpamAssassin Spam detection and feedback. Note that this is relevant if this component is configured.</p>
-</li>
-<li>
-<p><a href="https://github.com/apache/james-project/blob/master/grafana-reporting/Tika-1522226794419-dashboard.json">Tika</a> :
-Latencies for Tika text extraction. Note that this is relevant if this component is configured.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This is for instance how the JMAP dashboard looks like:</p>
-</div>
-<div class="imageblock">
-<div class="content">
-<img src="../../_images/metrics.png" alt="metrics for the JMAP protocol request latencies">
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_running_and_configuring_grafana"><a class="anchor" href="#_running_and_configuring_grafana"></a>Running and configuring Grafana</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The following command allow you to run a fresh grafana server :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>docker run -i -p 3000:3000 grafana/grafana</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Once running, you need to set up an ElasticSearch data-source : - select
-proxy mode - Select version 2.x of ElasticSearch - make the URL point
-your ES node - Specify the index name. By default, it should be :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[james-metrics-]YYYY-MM</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Import the different dashboards you want.</p>
-</div>
-<div class="paragraph">
-<p>You then need to enable reporting through ElasticSearch. Modify your
-James ElasticSearch configuration file accordingly. To help you doing
-this, you can take a look to
-<a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra/destination/conf/elasticsearch.properties">elasticsearch.properties</a>.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/operate/migrating.html b/james-project/3.6.0/servers/distributed/operate/migrating.html
deleted file mode 100644
index fd8ceea..0000000
--- a/james-project/3.6.0/servers/distributed/operate/migrating.html
+++ /dev/null
@@ -1,608 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Migrating existing data :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="metrics.html">Metrics</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Operate</a></li>
- <li><a href="migrating.html">Migrating existing data</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="migrating.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/operate/migrating.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Migrating existing data</h1>
-<div class="paragraph">
-<p>This page presents how operators can migrate your user mailbox and mails into the Distributed Server in order to adopt it.</p>
-</div>
-<div class="paragraph">
-<p>We assume you have a <a href="../configure/index.html" class="xref page">well configured</a> running Distributed server
-at hand. We also assume existing mails are hosted on a tier mail server which can be accessed via IMAP and supports
-impersonation.</p>
-</div>
-<div class="paragraph">
-<p>First, you want to create the domains handled by your server, as well as the users you will be hosting. This operation
-can be performed via WebAdmin or the CLI.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Using webadmin :</p>
-<div class="ulist">
-<ul>
-<li>
-<p>Read <a href="webadmin.html#_create_a_domain" class="xref page">this section</a> for creating domains</p>
-</li>
-<li>
-<p>Read <a href="webadmin.html#_create_a_user" class="xref page">this section</a> for creating users</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p>Using the CLI :</p>
-<div class="ulist">
-<ul>
-<li>
-<p>Read <a href="cli.html#_manage_domains" class="xref page">this section</a> for creating domains</p>
-</li>
-<li>
-<p>Read <a href="cli.html#_manage_users" class="xref page">this section</a> for creating users</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Second, you want to allow an administrator account of your Distributed Server to have write access on other user mailboxes.
-This can be setted up this the <strong>administratorId</strong> configuration option of the <a href="../configure/usersrepository.html" class="xref page">usersrepository.xml</a> configuration file.</p>
-</div>
-<div class="paragraph">
-<p>Then, it is time to run <a href="https://github.com/imapsync/imapsync">imapsync</a> script to copy the emails from the previous mail server
-into the Distributed Server. Here is an example migrating a single user, relying on impersonation:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>imapsync --host1 previous.server.domain.tld \
- --user1 user@domain.tld --authuser1 adminOldServer@domain.tld \
- --proxyauth1 --password1 passwordOfTheOldAdmin \
- --host2 distributed.james.domain.tld \
- --user2 use1@domain.tld \
- --authuser2 adminNewServer@domain.tld --proxyauth2 \
- --password2 passwordOfTheNewAdmin</pre>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/operate/webadmin.html b/james-project/3.6.0/servers/distributed/operate/webadmin.html
deleted file mode 100644
index 0527a3d..0000000
--- a/james-project/3.6.0/servers/distributed/operate/webadmin.html
+++ /dev/null
@@ -1,7079 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — WebAdmin REST administration API :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="../configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="logging.html">Logging</a>
- </li>
- <li class="nav-item is-current-page" data-depth="4">
- <a class="nav-link" href="webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../../index.html">Apache James Server</a></li>
- <li><a href="../../index.html">Servers</a></li>
- <li><a href="../../distributed.html">Distributed</a></li>
- <li><a href="index.html">Operate</a></li>
- <li><a href="webadmin.html">WebAdmin REST administration API</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="webadmin.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/operate/webadmin.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — WebAdmin REST administration API</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>The web administration supports for now the CRUD operations on the domains, the users, their mailboxes and their quotas,
- managing mail repositories, performing cassandra migrations, and much more, as described in the following sections.</p>
-</div>
-<div class="paragraph">
-<p><strong>WARNING</strong>: 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>
-</div>
-<div class="paragraph">
-<p>By the way, some endpoints are not filtered by authentication. Those endpoints are not related to data stored in James,
-for example: Swagger documentation & James health checks.</p>
-</div>
-<div class="paragraph">
-<p>In case of any error, the system will return an error message which is
-json format like this:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- statusCode: <error_code>,
- type: <error_type>,
- message: <the_error_message>
- cause: <the_detail_message_from_throwable>
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Also be aware that, in case things go wrong, all endpoints might return
-a 500 internal error (with a JSON body formatted as exposed above). To
-avoid information duplication, this is omitted on endpoint specific
-documentation.</p>
-</div>
-<div class="paragraph">
-<p>Finally, please note that in case of a malformed URL the 400 bad request
-response will contain an HTML body.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_healthcheck"><a class="anchor" href="#_healthcheck"></a>HealthCheck</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_check_all_components"><a class="anchor" href="#_check_all_components"></a>Check all components</h3>
-<div class="paragraph">
-<p>This endpoint is simple for now and is just returning the http status
-code corresponding to the state of checks (see below). The user has to
-check in the logs in order to have more information about failing
-checks.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/healthcheck</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return a list of healthChecks execution result, with an aggregated
-result:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "status": "healthy",
- "checks": [
- {
- "componentName": "Cassandra backend",
- "escapedComponentName": "Cassandra%20backend",
- "status": "healthy"
- "cause": null
- }
- ]
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>status</strong> field can be:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>healthy</strong>: Component works normally</p>
-</li>
-<li>
-<p><strong>degraded</strong>: Component works in degraded mode. Some non-critical
-services may not be working, or latencies are high, for example. Cause
-contains explanations.</p>
-</li>
-<li>
-<p><strong>unhealthy</strong>: The component is currently not working. Cause contains
-explanations.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Supported health checks include:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>Cassandra backend</strong>: Cassandra storage.</p>
-</li>
-<li>
-<p><strong>ElasticSearch Backend</strong>: ElasticSearch storage.</p>
-</li>
-<li>
-<p><strong>EventDeadLettersHealthCheck</strong></p>
-</li>
-<li>
-<p><strong>Guice application lifecycle</strong></p>
-</li>
-<li>
-<p><strong>JPA Backend</strong>: JPA storage.</p>
-</li>
-<li>
-<p><strong>MessageFastViewProjection</strong> Health check of the component storing JMAP properties
-which are fast to retrieve. Those properties are computed in advance
-from messages and persisted in order to archive a better performance.
-There are some latencies between a source update and its projections
-updates. Incoherency problems arise when reads are performed in this
-time-window. We piggyback the projection update on missed JMAP read in
-order to decrease the outdated time window for a given entry. The health
-is determined by the ratio of missed projection reads. (lower than 10%
-causes <code>degraded</code>)</p>
-</li>
-<li>
-<p><strong>RabbitMQ backend</strong>: RabbitMQ messaging.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: All checks have answered with a Healthy or Degraded status. James
-services can still be used.</p>
-</li>
-<li>
-<p>503: At least one check have answered with a Unhealthy status</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_check_single_component"><a class="anchor" href="#_check_single_component"></a>Check single component</h3>
-<div class="paragraph">
-<p>Performs a health check for the given component. The component is
-referenced by its URL encoded name.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/healthcheck/checks/Cassandra%20backend</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the component’s name, the component’s escaped name, the
-health status and a cause.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "componentName": "Cassandra backend",
- "escapedComponentName": "Cassandra%20backend",
- "status": "healthy"
- "cause": null
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The check has answered with a Healthy or Degraded status.</p>
-</li>
-<li>
-<p>404: A component with the given name was not found.</p>
-</li>
-<li>
-<p>503: The check has anwered with a Unhealthy status.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_list_all_health_checks"><a class="anchor" href="#_list_all_health_checks"></a>List all health checks</h3>
-<div class="paragraph">
-<p>This endpoint lists all the available health checks.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/healthcheck/checks</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the list of all available health checks.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[
- {
- "componentName": "Cassandra backend",
- "escapedComponentName": "Cassandra%20backend"
- }
-]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: List of available health checks</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_task_management"><a class="anchor" href="#_task_management"></a>Task management</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Some webadmin features schedule tasks. The task management API allow to
-monitor and manage the execution of the following tasks.</p>
-</div>
-<div class="paragraph">
-<p>Note that the <code>taskId</code> used in the following APIs is returned by other
-WebAdmin APIs scheduling tasks.</p>
-</div>
-<div class="sect2">
-<h3 id="_getting_a_task_details"><a class="anchor" href="#_getting_a_task_details"></a>Getting a task details</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/tasks/3294a976-ce63-491e-bd52-1b6f465ed7a2</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>An Execution Report will be returned:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<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": "type-of-the-task"
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note that:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>status</code> can have the value:</p>
-<div class="ulist">
-<ul>
-<li>
-<p><code>waiting</code>: The task is scheduled but its execution did not start yet</p>
-</li>
-<li>
-<p><code>inProgress</code>: The task is currently executed</p>
-</li>
-<li>
-<p><code>cancelled</code>: The task had been cancelled</p>
-</li>
-<li>
-<p><code>completed</code>: The task execution is finished, and this execution is a
-success</p>
-</li>
-<li>
-<p><code>failed</code>: The task execution is finished, and this execution is a
-failure</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p><code>additionalInformation</code> is a task specific object giving additional
-information and context about that task. The structure of this
-<code>additionalInformation</code> field is provided along the specific task
-submission endpoint.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The specific task was found and the execution report exposed
-above is returned</p>
-</li>
-<li>
-<p>400: Invalid task ID</p>
-</li>
-<li>
-<p>404: Task ID was not found</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_awaiting_a_task"><a class="anchor" href="#_awaiting_a_task"></a>Awaiting a task</h3>
-<div class="paragraph">
-<p>One can await the end of a task, then receive its final execution
-report.</p>
-</div>
-<div class="paragraph">
-<p>That feature is especially usefull for testing purpose but still can
-serve real-life scenari.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/tasks/3294a976-ce63-491e-bd52-1b6f465ed7a2/await?timeout=duration</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>An Execution Report will be returned.</p>
-</div>
-<div class="paragraph">
-<p><code>timeout</code> is optional. By default it is set to 365 days (the maximum
-value). The expected value is expressed in the following format:
-<code>Nunit</code>. <code>N</code> should be strictly positive. <code>unit</code> could be either in the
-short form (<code>s</code>, <code>m</code>, <code>h</code>, etc.), or in the long form (<code>day</code>, <code>week</code>,
-<code>month</code>, etc.).</p>
-</div>
-<div class="paragraph">
-<p>Examples:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>30s</code></p>
-</li>
-<li>
-<p><code>5m</code></p>
-</li>
-<li>
-<p><code>7d</code></p>
-</li>
-<li>
-<p><code>1y</code></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The specific task was found and the execution report exposed
-above is returned</p>
-</li>
-<li>
-<p>400: Invalid task ID or invalid timeout</p>
-</li>
-<li>
-<p>404: Task ID was not found</p>
-</li>
-<li>
-<p>408: The timeout has been reached</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_cancelling_a_task"><a class="anchor" href="#_cancelling_a_task"></a>Cancelling a task</h3>
-<div class="paragraph">
-<p>You can cancel a task by calling:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/tasks/3294a976-ce63-491e-bd52-1b6f465ed7a2</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Task had been cancelled</p>
-</li>
-<li>
-<p>400: Invalid task ID</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_listing_tasks"><a class="anchor" href="#_listing_tasks"></a>Listing tasks</h3>
-<div class="paragraph">
-<p>A list of all tasks can be retrieved:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/tasks</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return a list of Execution reports</p>
-</div>
-<div class="paragraph">
-<p>One can filter the above results by status. For example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/tasks?status=inProgress</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return a list of Execution reports that are currently in progress.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: A list of corresponding tasks is returned</p>
-</li>
-<li>
-<p>400: Invalid status value</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_endpoints_returning_a_task"><a class="anchor" href="#_endpoints_returning_a_task"></a>Endpoints returning a task</h3>
-<div class="paragraph">
-<p>Many endpoints do generate a task.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /endpoint?action={action}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The response to these requests will be the scheduled <code>taskId</code> :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"taskId":"5641376-02ed-47bd-bcc7-76ff6262d92a"}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Positionned headers:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Location header indicates the location of the resource associated with
-the scheduled task. Example:</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>Location: /tasks/3294a976-ce63-491e-bd52-1b6f465ed7a2</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Task generation succeeded. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>Other response codes might be returned depending on the endpoint</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The additional information returned depends on the scheduled task type
-and is documented in the endpoint documentation.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_administrating_domains"><a class="anchor" href="#_administrating_domains"></a>Administrating domains</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_create_a_domain"><a class="anchor" href="#_create_a_domain"></a>Create a domain</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/domains/domainToBeCreated</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name domainToBeCreated:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>can not be null or empty</p>
-</li>
-<li>
-<p>can not contain `@'</p>
-</li>
-<li>
-<p>can not be more than 255 characters</p>
-</li>
-<li>
-<p>can not contain `/'</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The domain was successfully added</p>
-</li>
-<li>
-<p>400: The domain name is invalid</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_delete_a_domain"><a class="anchor" href="#_delete_a_domain"></a>Delete a domain</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/domains/{domainToBeDeleted}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note: Deletion of an auto-detected domain, default domain or of an
-auto-detected ip is not supported. We encourage you instead to review
-your <a href="https://james.apache.org/server/config-domainlist.html">domain list
-configuration</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The domain was successfully removed</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_test_if_a_domain_exists"><a class="anchor" href="#_test_if_a_domain_exists"></a>Test if a domain exists</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/domains/{domainName}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The domain exists</p>
-</li>
-<li>
-<p>404: The domain does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_get_the_list_of_domains"><a class="anchor" href="#_get_the_list_of_domains"></a>Get the list of domains</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/domains</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Possible response:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>["domain1", "domain2"]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The domain list was successfully retrieved</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_get_the_list_of_aliases_for_a_domain"><a class="anchor" href="#_get_the_list_of_aliases_for_a_domain"></a>Get the list of aliases for a domain</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/domains/destination.domain.tld/aliases</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Possible response:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[
- {"source": "source1.domain.tld"},
- {"source": "source2.domain.tld"}
-]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>When sending an email to an email address having <code>source1.domain.tld</code> or
-<code>source2.domain.tld</code> as a domain part (example:
-<code>user@source1.domain.tld</code>), then the domain part will be rewritten into
-destination.domain.tld (so into <code>user@destination.domain.tld</code>).</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The domain aliases was successfully retrieved</p>
-</li>
-<li>
-<p>400: destination.domain.tld has an invalid syntax</p>
-</li>
-<li>
-<p>404: destination.domain.tld is not part of handled domains and does
-not have local domains as aliases.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_create_an_alias_for_a_domain"><a class="anchor" href="#_create_an_alias_for_a_domain"></a>Create an alias for a domain</h3>
-<div class="paragraph">
-<p>To create a domain alias execute the following query:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/domains/destination.domain.tld/aliases/source.domain.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>When sending an email to an email address having <code>source.domain.tld</code> as
-a domain part (example: <code>user@source.domain.tld</code>), then the domain part
-will be rewritten into <code>destination.domain.tld</code> (so into
-<code>user@destination.domain.tld</code>).</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The redirection now exists</p>
-</li>
-<li>
-<p>400: <code>source.domain.tld</code> or <code>destination.domain.tld</code> have an invalid
-syntax</p>
-</li>
-<li>
-<p>400: <code>source, domain</code> and <code>destination domain</code> are the same</p>
-</li>
-<li>
-<p>404: <code>source.domain.tld</code> are not part of handled domains.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Be aware that no checks to find possible loops that would result of this creation will be performed.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_delete_an_alias_for_a_domain"><a class="anchor" href="#_delete_an_alias_for_a_domain"></a>Delete an alias for a domain</h3>
-<div class="paragraph">
-<p>To delete a domain alias execute the following query:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/domains/destination.domain.tld/aliases/source.domain.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>When sending an email to an email address having <code>source.domain.tld</code> as
-a domain part (example: <code>user@source.domain.tld</code>), then the domain part
-will be rewritten into <code>destination.domain.tld</code> (so into
-<code>user@destination.domain.tld</code>).</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The redirection now no longer exists</p>
-</li>
-<li>
-<p>400: <code>source.domain.tld</code> or destination.domain.tld have an invalid
-syntax</p>
-</li>
-<li>
-<p>400: source, domain and destination domain are the same</p>
-</li>
-<li>
-<p>404: <code>source.domain.tld</code> are not part of handled domains.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_administrating_users"><a class="anchor" href="#_administrating_users"></a>Administrating users</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_create_a_user"><a class="anchor" href="#_create_a_user"></a>Create a user</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/users/usernameToBeUsed \
- -d '{"password":"passwordToBeUsed"}' \
- -H "Content-Type: application/json"</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name usernameToBeUsed representing valid users, hence it should
-match the criteria at <a href="#distributed/confgure/usersrepository.adoc" class="xref unresolved">User Repositories documentation</a></p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The user was successfully created</p>
-</li>
-<li>
-<p>400: The user name or the payload is invalid</p>
-</li>
-<li>
-<p>409: The user name already exists</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Note: If the user exists already, its password cannot be updated using this.
-If you want to update a user’s password, please have a look at <strong>Update a user password</strong> below.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_updating_a_user_password"><a class="anchor" href="#_updating_a_user_password"></a>Updating a user password</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/users/usernameToBeUsed?force \
- -d '{"password":"passwordToBeUsed"}' \
- -H "Content-Type: application/json"</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The user’s password was successfully updated</p>
-</li>
-<li>
-<p>400: The user name or the payload is invalid</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This also can be used to create a new user.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_testing_a_user_existence"><a class="anchor" href="#_testing_a_user_existence"></a>Testing a user existence</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XHEAD http://ip:port/users/usernameToBeUsed</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name ``usernameToBeUsed'' represents a valid user, hence it
-should match the criteria at <a href="../configure/usersrepository.html" class="xref page">User Repositories documentation</a></p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The user exists</p>
-</li>
-<li>
-<p>400: The user name is invalid</p>
-</li>
-<li>
-<p>404: The user does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_deleting_a_user"><a class="anchor" href="#_deleting_a_user"></a>Deleting a user</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/users/{userToBeDeleted}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The user was successfully deleted</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_retrieving_the_user_list"><a class="anchor" href="#_retrieving_the_user_list"></a>Retrieving the user list</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/users</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[{"username":"username@domain-jmapauthentication.tld"},{"username":"username@domain.tld"}]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The user name list was successfully retrieved</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_retrieving_the_list_of_allowed_from_headers_for_a_given_user"><a class="anchor" href="#_retrieving_the_list_of_allowed_from_headers_for_a_given_user"></a>Retrieving the list of allowed <code>From</code> headers for a given user</h3>
-<div class="paragraph">
-<p>This endpoint allows to know which From headers a given user is allowed to use when sending mails.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/users/givenUser/allowedFromHeaders</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>["user@domain.tld","alias@domain.tld"]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The list was successfully retrieved</p>
-</li>
-<li>
-<p>400: The user is invalid</p>
-</li>
-<li>
-<p>404: The user is unknown</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_administrating_mailboxes"><a class="anchor" href="#_administrating_mailboxes"></a>Administrating mailboxes</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_all_mailboxes"><a class="anchor" href="#_all_mailboxes"></a>All mailboxes</h3>
-<div class="paragraph">
-<p>Several actions can be performed on the server mailboxes.</p>
-</div>
-<div class="paragraph">
-<p>Request pattern is:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /mailboxes?action={action1},...</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Error in the request. Details can be found in the reported error.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The kind of task scheduled depends on the action parameter. See below
-for details.</p>
-</div>
-<div class="sect3">
-<h4 id="_fixing_mailboxes_inconsistencies"><a class="anchor" href="#_fixing_mailboxes_inconsistencies"></a>Fixing mailboxes inconsistencies</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /mailboxes?task=SolveInconsistencies</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule a task for fixing inconsistencies for the mailbox
-deduplicated object stored in Cassandra.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>The <code>I-KNOW-WHAT-I-M-DOING</code> header is mandatory (you can read more
-information about it in the warning section below).</p>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type
-<code>solve-mailbox-inconsistencies</code> and the following
-<code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"solve-mailbox-inconsistencies",
- "processedMailboxEntries": 3,
- "processedMailboxPathEntries": 3,
- "fixedInconsistencies": 2,
- "errors": 1,
- "conflictingEntries":[{
- "mailboxDaoEntry":{
- "mailboxPath":"#private:user:mailboxName",
- "mailboxId":"464765a0-e4e7-11e4-aba4-710c1de3782b"
- }," +
- "mailboxPathDaoEntry":{
- "mailboxPath":"#private:user:mailboxName2",
- "mailboxId":"464765a0-e4e7-11e4-aba4-710c1de3782b"
- }
- }]
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note that conflicting entry inconsistencies will not be fixed and will
-require to explicitly use <a href="#correcting-ghost-mailbox">ghost mailbox</a>
-endpoint in order to merge the conflicting mailboxes and prevent any
-message loss.</p>
-</div>
-<div class="paragraph">
-<p><strong>WARNING</strong>: this task can cancel concurrently running legitimate user
-operations upon dirty read. As such this task should be run offline.</p>
-</div>
-<div class="paragraph">
-<p>A dirty read is when data is read between the two writes of the
-denormalization operations (no isolation).</p>
-</div>
-<div class="paragraph">
-<p>In order to ensure being offline, stop the traffic on SMTP, JMAP and
-IMAP ports, for example via re-configuration or firewall rules.</p>
-</div>
-<div class="paragraph">
-<p>Due to all of those risks, a <code>I-KNOW-WHAT-I-M-DOING</code> header should be
-positioned to <code>ALL-SERVICES-ARE-OFFLINE</code> in order to prevent accidental
-calls.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_recomputing_mailbox_counters"><a class="anchor" href="#_recomputing_mailbox_counters"></a>Recomputing mailbox counters</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /mailboxes?task=RecomputeMailboxCounters</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will recompute counters (unseen & total count) for the mailbox object
-stored in Cassandra.</p>
-</div>
-<div class="paragraph">
-<p>Cassandra maintains a per mailbox projection for message count and
-unseen message count. As with any projection, it can go out of sync,
-leading to inconsistent results being returned to the client.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type
-<code>recompute-mailbox-counters</code> and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"recompute-mailbox-counters",
- "processedMailboxes": 3,
- "failedMailboxes": ["464765a0-e4e7-11e4-aba4-710c1de3782b"]
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note that conflicting inconsistencies entries will not be fixed and will
-require to explicitly use <a href="#correcting-ghost-mailbox">ghost mailbox</a>
-endpoint in order to merge the conflicting mailboxes and prevent any
-message loss.</p>
-</div>
-<div class="paragraph">
-<p><strong>WARNING</strong>: this task do not take into account concurrent modifications
-upon a single mailbox counter recomputation. Rerunning the task will
-<em>eventually</em> provide the consistent result. As such we advise to run
-this task offline.</p>
-</div>
-<div class="paragraph">
-<p>In order to ensure being offline, stop the traffic on SMTP, JMAP and
-IMAP ports, for example via re-configuration or firewall rules.</p>
-</div>
-<div class="paragraph">
-<p><code>trustMessageProjection</code> query parameter can be set to <code>true</code>. Content
-of <code>messageIdTable</code> (listing messages by their mailbox context) table
-will be trusted and not compared against content of <code>imapUidTable</code> table
-(listing messages by their messageId mailbox independent identifier).
-This will result in a better performance running the task at the cost of
-safety in the face of message denormalization inconsistencies.</p>
-</div>
-<div class="paragraph">
-<p>Defaults to false, which generates additional checks. You can read
-<a href="https://github.com/apache/james-project/blob/master/src/adr/0022-cassandra-message-inconsistency.md">this
-ADR</a> to better understand the message projection and how it can become
-inconsistent.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_recomputing_global_jmap_fast_message_view_projection"><a class="anchor" href="#_recomputing_global_jmap_fast_message_view_projection"></a>Recomputing Global JMAP fast message view projection</h4>
-<div class="paragraph">
-<p>Message fast view projection stores message properties expected to be
-fast to fetch but are actually expensive to compute, in order for
-GetMessages operation to be fast to execute for these properties.</p>
-</div>
-<div class="paragraph">
-<p>These projection items are asynchronously computed on mailbox events.</p>
-</div>
-<div class="paragraph">
-<p>You can force the full projection recomputation by calling the following
-endpoint:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /mailboxes?task=recomputeFastViewProjectionItems</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule a task for recomputing the fast message view projection
-for all mailboxes.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>An admin can specify the concurrency that should be used when running
-the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>messagesPerSecond</code> rate at which messages should be processed, per
-second. Defaults to 10.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must have a strictly positive integer as a value
-and be passed as query parameters.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /mailboxes?task=recomputeFastViewProjectionItems&messagesPerSecond=20</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type
-<code>RecomputeAllFastViewProjectionItemsTask</code> and the following
-<code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"RecomputeAllPreviewsTask",
- "processedUserCount": 3,
- "processedMessageCount": 3,
- "failedUserCount": 2,
- "failedMessageCount": 1,
- "runningOptions": {
- "messagesPerSecond":20
- }
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Error in the request. Details can be found in the reported error.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_reindexing_action"><a class="anchor" href="#_reindexing_action"></a>ReIndexing action</h4>
-<div class="paragraph">
-<p>Be also aware of the limits of this API:</p>
-</div>
-<div class="paragraph">
-<p>Warning: During the re-indexing, the result of search operations might
-be altered.</p>
-</div>
-<div class="paragraph">
-<p>Warning: Canceling this task should be considered unsafe as it will
-leave the currently reIndexed mailbox as partially indexed.</p>
-</div>
-<div class="paragraph">
-<p>Warning: While we have been trying to reduce the inconsistency window to
-a maximum (by keeping track of ongoing events), concurrent changes done
-during the reIndexing might be ignored.</p>
-</div>
-<div class="sect4">
-<h5 id="_reindexing_all_mails"><a class="anchor" href="#_reindexing_all_mails"></a>ReIndexing all mails</h5>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/mailboxes?task=reIndex</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule a task for reIndexing all the mails stored on this James
-server.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>An admin can specify the concurrency that should be used when running
-the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>messagesPerSecond</code> rate at which messages should be processed per
-second. Default is 50.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must have a strictly positive integer as a value
-and be passed as query parameter.</p>
-</div>
-<div class="paragraph">
-<p>An admin can also specify the reindexing mode it wants to use when
-running the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>mode</code> the reindexing mode used. There are 2 modes for the moment:</p>
-<div class="ulist">
-<ul>
-<li>
-<p><code>rebuildAll</code> allows to rebuild all indexes. This is the default mode.</p>
-</li>
-<li>
-<p><code>fixOutdated</code> will check for outdated indexed document and reindex
-only those.</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must be passed as query parameter.</p>
-</div>
-<div class="paragraph">
-<p>It’s good to note as well that there is a limitation with the
-<code>fixOutdated</code> mode. As we first collect metadata of stored messages to
-compare them with the ones in the index, a failed <code>expunged</code> operation
-might not be well corrected (as the message might not exist anymore but
-still be indexed).</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/mailboxes?task=reIndex&messagesPerSecond=200&mode=rebuildAll</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>full-reindexing</code> and
-the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"full-reindexing",
- "runningOptions":{
- "messagesPerSecond":200,
- "mode":"REBUILD_ALL"
- },
- "successfullyReprocessedMailCount":18,
- "failedReprocessedMailCount": 3,
- "mailboxFailures": ["12", "23" ],
- "messageFailures": [
- {
- "mailboxId": "1",
- "uids": [1, 36]
- }]
-}</pre>
-</div>
-</div>
-</div>
-<div class="sect4">
-<h5 id="_fixing_previously_failed_reindexing"><a class="anchor" href="#_fixing_previously_failed_reindexing"></a>Fixing previously failed ReIndexing</h5>
-<div class="paragraph">
-<p>Will schedule a task for reIndexing all the mails which had failed to be
-indexed from the ReIndexingAllMails task.</p>
-</div>
-<div class="paragraph">
-<p>Given <code>bbdb69c9-082a-44b0-a85a-6e33e74287a5</code> being a <code>taskId</code> generated
-for a reIndexing tasks</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST 'http://ip:port/mailboxes?task=reIndex&reIndexFailedMessagesOf=bbdb69c9-082a-44b0-a85a-6e33e74287a5'</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>An admin can specify the concurrency that should be used when running
-the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>messagesPerSecond</code> rate at which messages should be processed per
-second. Default is 50.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must have a strictly positive integer as a value
-and be passed as query parameter.</p>
-</div>
-<div class="paragraph">
-<p>An admin can also specify the reindexing mode it wants to use when
-running the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>mode</code> the reindexing mode used. There are 2 modes for the moment:</p>
-<div class="ulist">
-<ul>
-<li>
-<p><code>rebuildAll</code> allows to rebuild all indexes. This is the default mode.</p>
-</li>
-<li>
-<p><code>fixOutdated</code> will check for outdated indexed document and reindex
-only those.</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must be passed as query parameter.</p>
-</div>
-<div class="paragraph">
-<p>It’s good to note as well that there is a limitation with the
-<code>fixOutdated</code> mode. As we first collect metadata of stored messages to
-compare them with the ones in the index, a failed <code>expunged</code> operation
-might not be well corrected (as the message might not exist anymore but
-still be indexed).</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/mailboxes?task=reIndex&reIndexFailedMessagesOf=bbdb69c9-082a-44b0-a85a-6e33e74287a5&messagesPerSecond=200&mode=rebuildAll</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type
-<code>error-recovery-indexation</code> and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"error-recovery-indexation"
- "runningOptions":{
- "messagesPerSecond":200,
- "mode":"REBUILD_ALL"
- },
- "successfullyReprocessedMailCount":18,
- "failedReprocessedMailCount": 3,
- "mailboxFailures": ["12", "23" ],
- "messageFailures": [{
- "mailboxId": "1",
- "uids": [1, 36]
- }]
-}</pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_single_mailbox"><a class="anchor" href="#_single_mailbox"></a>Single mailbox</h3>
-<div class="sect3">
-<h4 id="_reindexing_a_mailbox_mails"><a class="anchor" href="#_reindexing_a_mailbox_mails"></a>ReIndexing a mailbox mails</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/mailboxes/{mailboxId}?task=reIndex</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule a task for reIndexing all the mails in one mailbox.</p>
-</div>
-<div class="paragraph">
-<p>Note that `mailboxId' path parameter needs to be a (implementation
-dependent) valid mailboxId.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>An admin can specify the concurrency that should be used when running
-the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>messagesPerSecond</code> rate at which messages should be processed per
-second. Default is 50.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must have a strictly positive integer as a value
-and be passed as query parameter.</p>
-</div>
-<div class="paragraph">
-<p>An admin can also specify the reindexing mode it wants to use when
-running the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>mode</code> the reindexing mode used. There are 2 modes for the moment:</p>
-<div class="ulist">
-<ul>
-<li>
-<p><code>rebuildAll</code> allows to rebuild all indexes. This is the default mode.</p>
-</li>
-<li>
-<p><code>fixOutdated</code> will check for outdated indexed document and reindex
-only those.</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must be passed as query parameter.</p>
-</div>
-<div class="paragraph">
-<p>It’s good to note as well that there is a limitation with the
-<code>fixOutdated</code> mode. As we first collect metadata of stored messages to
-compare them with the ones in the index, a failed <code>expunged</code> operation
-might not be well corrected (as the message might not exist anymore but
-still be indexed).</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/mailboxes/{mailboxId}?task=reIndex&messagesPerSecond=200&mode=fixOutdated</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Error in the request. Details can be found in the reported error.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>mailbox-reindexing</code> and
-the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"mailbox-reindexing",
- "runningOptions":{
- "messagesPerSecond":200,
- "mode":"FIX_OUTDATED"
- },
- "mailboxId":"{mailboxId}",
- "successfullyReprocessedMailCount":18,
- "failedReprocessedMailCount": 3,
- "mailboxFailures": ["12"],
- "messageFailures": [
- {
- "mailboxId": "1",
- "uids": [1, 36]
- }]
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Warning: During the re-indexing, the result of search operations might
-be altered.</p>
-</div>
-<div class="paragraph">
-<p>Warning: Canceling this task should be considered unsafe as it will
-leave the currently reIndexed mailbox as partially indexed.</p>
-</div>
-<div class="paragraph">
-<p>Warning: While we have been trying to reduce the inconsistency window to
-a maximum (by keeping track of ongoing events), concurrent changes done
-during the reIndexing might be ignored.</p>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_administrating_messages"><a class="anchor" href="#_administrating_messages"></a>Administrating Messages</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_reindexing_a_single_mail_by_messageid"><a class="anchor" href="#_reindexing_a_single_mail_by_messageid"></a>ReIndexing a single mail by messageId</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/messages/{messageId}?task=reIndex</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule a task for reIndexing a single email in all the mailboxes
-containing it.</p>
-</div>
-<div class="paragraph">
-<p>Note that `messageId' path parameter needs to be a (implementation
-dependent) valid messageId.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Error in the request. Details can be found in the reported error.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>messageId-reindexing</code>
-and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "messageId":"18"
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Warning: During the re-indexing, the result of search operations might
-be altered.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_fixing_message_inconsistencies"><a class="anchor" href="#_fixing_message_inconsistencies"></a>Fixing message inconsistencies</h3>
-<div class="paragraph">
-<p>This task is only available on top of Guice Cassandra products.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /messages?task=SolveInconsistencies</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule a task for fixing message inconsistencies created by the
-message denormalization process.</p>
-</div>
-<div class="paragraph">
-<p>Messages are denormalized and stored in separated data tables in
-Cassandra, so they can be accessed by their unique identifier or mailbox
-identifier & local mailbox identifier through different protocols.</p>
-</div>
-<div class="paragraph">
-<p>Failure in the denormalization process will lead to inconsistencies, for
-example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>BOB receives a message
-The denormalization process fails
-BOB can read the message via JMAP
-BOB cannot read the message via IMAP
-
-BOB marks a message as SEEN
-The denormalization process fails
-The message is SEEN via JMAP
-The message is UNSEEN via IMAP</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>An admin can specify the concurrency that should be used when running
-the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>messagesPerSecond</code> rate of messages to be processed per second.
-Default is 100.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must have a strictly positive integer as a value
-and be passed as query parameter.</p>
-</div>
-<div class="paragraph">
-<p>An admin can also specify the reindexing mode it wants to use when
-running the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>mode</code> the reindexing mode used. There are 2 modes for the moment:</p>
-<div class="ulist">
-<ul>
-<li>
-<p><code>rebuildAll</code> allows to rebuild all indexes. This is the default mode.</p>
-</li>
-<li>
-<p><code>fixOutdated</code> will check for outdated indexed document and reindex
-only those.</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must be passed as query parameter.</p>
-</div>
-<div class="paragraph">
-<p>It’s good to note as well that there is a limitation with the
-<code>fixOutdated</code> mode. As we first collect metadata of stored messages to
-compare them with the ones in the index, a failed <code>expunged</code> operation
-might not be well corrected (as the message might not exist anymore but
-still be indexed).</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /messages?task=SolveInconsistencies&messagesPerSecond=200&mode=rebuildAll</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Error in the request. Details can be found in the reported error.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type
-<code>solve-message-inconsistencies</code> and the following
-<code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"solve-message-inconsistencies",
- "timestamp":"2007-12-03T10:15:30Z",
- "processedImapUidEntries": 2,
- "processedMessageIdEntries": 1,
- "addedMessageIdEntries": 1,
- "updatedMessageIdEntries": 0,
- "removedMessageIdEntries": 1,
- "runningOptions":{
- "messagesPerSecond": 200,
- "mode":"REBUILD_ALL"
- },
- "fixedInconsistencies": [
- {
- "mailboxId": "551f0580-82fb-11ea-970e-f9c83d4cf8c2",
- "messageId": "d2bee791-7e63-11ea-883c-95b84008f979",
- "uid": 1
- },
- {
- "mailboxId": "551f0580-82fb-11ea-970e-f9c83d4cf8c2",
- "messageId": "d2bee792-7e63-11ea-883c-95b84008f979",
- "uid": 2
- }
- ],
- "errors": [
- {
- "mailboxId": "551f0580-82fb-11ea-970e-f9c83d4cf8c2",
- "messageId": "ffffffff-7e63-11ea-883c-95b84008f979",
- "uid": 3
- }
- ]
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>User actions concurrent to the inconsistency fixing task could result in
-concurrency issues. New inconsistencies could be created.</p>
-</div>
-<div class="paragraph">
-<p>However the source of truth will not be impacted, hence rerunning the
-task will eventually fix all issues.</p>
-</div>
-<div class="paragraph">
-<p>This task could be run safely online and can be scheduled on a recurring
-basis outside of peak traffic by an admin to ensure Cassandra message
-consistency.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_administrating_user_mailboxes"><a class="anchor" href="#_administrating_user_mailboxes"></a>Administrating user mailboxes</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_creating_a_mailbox"><a class="anchor" href="#_creating_a_mailbox"></a>Creating a mailbox</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/users/{usernameToBeUsed}/mailboxes/{mailboxNameToBeCreated}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user Resource
-name <code>mailboxNameToBeCreated</code> should not be empty, nor contain % * characters, nor starting with #.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The mailbox now exists on the server</p>
-</li>
-<li>
-<p>400: Invalid mailbox name</p>
-</li>
-<li>
-<p>404: The user name does not exist</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<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>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/users/{usernameToBeUsed}/mailboxes/INBOX.work</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_deleting_a_mailbox_and_its_children"><a class="anchor" href="#_deleting_a_mailbox_and_its_children"></a>Deleting a mailbox and its children</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/users/{usernameToBeUsed}/mailboxes/{mailboxNameToBeDeleted}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user Resource
-name <code>mailboxNameToBeDeleted</code> should not be empty</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The mailbox now does not exist on the server</p>
-</li>
-<li>
-<p>400: Invalid mailbox name</p>
-</li>
-<li>
-<p>404: The user name does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_testing_existence_of_a_mailbox"><a class="anchor" href="#_testing_existence_of_a_mailbox"></a>Testing existence of a mailbox</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/users/{usernameToBeUsed}/mailboxes/{mailboxNameToBeTested}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user Resource
-name <code>mailboxNameToBeTested</code> should not be empty</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The mailbox exists</p>
-</li>
-<li>
-<p>400: Invalid mailbox name</p>
-</li>
-<li>
-<p>404: The user name does not exist, the mailbox does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_listing_user_mailboxes"><a class="anchor" href="#_listing_user_mailboxes"></a>Listing user mailboxes</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/users/{usernameToBeUsed}/mailboxes</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[{"mailboxName":"INBOX"},{"mailboxName":"outbox"}]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The mailboxes list was successfully retrieved</p>
-</li>
-<li>
-<p>404: The user name does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_deleting_user_mailboxes"><a class="anchor" href="#_deleting_user_mailboxes"></a>Deleting user mailboxes</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/users/{usernameToBeUsed}/mailboxes</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The user do not have mailboxes anymore</p>
-</li>
-<li>
-<p>404: The user name does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_exporting_user_mailboxes"><a class="anchor" href="#_exporting_user_mailboxes"></a>Exporting user mailboxes</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/users/{usernameToBeUsed}/mailboxes?action=export</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned</p>
-</li>
-<li>
-<p>404: The user name does not exist</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>MailboxesExportTask</code>
-and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"MailboxesExportTask",
- "timestamp":"2007-12-03T10:15:30Z",
- "username": "user",
- "stage": "STARTING"
-}</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_reindexing_a_user_mails"><a class="anchor" href="#_reindexing_a_user_mails"></a>ReIndexing a user mails</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/users/{usernameToBeUsed}/mailboxes?task=reIndex</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule a task for reIndexing all the mails in ``<a href="mailto:user@domain.com">user@domain.com</a>''
-mailboxes (encoded above).</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>An admin can specify the concurrency that should be used when running
-the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>messagesPerSecond</code> rate at which messages should be processed per
-second. Default is 50.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must have a strictly positive integer as a value
-and be passed as query parameter.</p>
-</div>
-<div class="paragraph">
-<p>An admin can also specify the reindexing mode it wants to use when
-running the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>mode</code> the reindexing mode used. There are 2 modes for the moment:</p>
-<div class="ulist">
-<ul>
-<li>
-<p><code>rebuildAll</code> allows to rebuild all indexes. This is the default mode.</p>
-</li>
-<li>
-<p><code>fixOutdated</code> will check for outdated indexed document and reindex
-only those.</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must be passed as query parameter.</p>
-</div>
-<div class="paragraph">
-<p>It’s good to note as well that there is a limitation with the
-<code>fixOutdated</code> mode. As we first collect metadata of stored messages to
-compare them with the ones in the index, a failed <code>expunged</code> operation
-might not be well corrected (as the message might not exist anymore but
-still be indexed).</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/users/{usernameToBeUsed}/mailboxes?task=reIndex&messagesPerSecond=200&mode=fixOutdated</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Error in the request. Details can be found in the reported error.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>user-reindexing</code> and
-the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"user-reindexing",
- "runningOptions":{
- "messagesPerSecond":200,
- "mode":"FIX_OUTDATED"
- },
- "user":"user@domain.com",
- "successfullyReprocessedMailCount":18,
- "failedReprocessedMailCount": 3,
- "mailboxFailures": ["12", "23" ],
- "messageFailures": [
- {
- "mailboxId": "1",
- "uids": [1, 36]
- }]
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Warning: During the re-indexing, the result of search operations might
-be altered.</p>
-</div>
-<div class="paragraph">
-<p>Warning: Canceling this task should be considered unsafe as it will
-leave the currently reIndexed mailbox as partially indexed.</p>
-</div>
-<div class="paragraph">
-<p>Warning: While we have been trying to reduce the inconsistency window to
-a maximum (by keeping track of ongoing events), concurrent changes done
-during the reIndexing might be ignored.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_subscribing_a_user_to_all_of_its_mailboxes"><a class="anchor" href="#_subscribing_a_user_to_all_of_its_mailboxes"></a>Subscribing a user to all of its mailboxes</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/users/{usernameToBeUsed}/mailboxes?task=subscribeAll</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule a task for subscribing a user to all of its mailboxes.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Most users are unaware of what an IMAP subscription is, nor how they can manage it. If the subscription list gets out
-of sync with the mailbox list, it could result in downgraded user experience (see MAILBOX-405). This task allow
-to reset the subscription list to the mailbox list on a per user basis thus working around the aforementioned issues.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>404: No such user</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>SubscribeAllTask</code> and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"SubscribeAllTask",
- "username":"user@domain.com",
- "subscribedCount":18,
- "unsubscribedCount": 3
-}</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_recomputing_user_jmap_fast_message_view_projection"><a class="anchor" href="#_recomputing_user_jmap_fast_message_view_projection"></a>Recomputing User JMAP fast message view projection</h3>
-<div class="paragraph">
-<p>This action is only available for backends supporting JMAP protocol.</p>
-</div>
-<div class="paragraph">
-<p>Message fast view projection stores message properties expected to be
-fast to fetch but are actually expensive to compute, in order for
-GetMessages operation to be fast to execute for these properties.</p>
-</div>
-<div class="paragraph">
-<p>These projection items are asynchronously computed on mailbox events.</p>
-</div>
-<div class="paragraph">
-<p>You can force the full projection recomputation by calling the following
-endpoint:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /users/{usernameToBeUsed}/mailboxes?task=recomputeFastViewProjectionItems</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule a task for recomputing the fast message view projection
-for all mailboxes of <code>usernameToBeUsed</code>.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>An admin can specify the concurrency that should be used when running
-the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>messagesPerSecond</code> rate at which messages should be processed, per
-second. Defaults to 10.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must have a strictly positive integer as a value
-and be passed as query parameters.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /mailboxes?task=recomputeFastViewProjectionItems&messagesPerSecond=20</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type
-<code>RecomputeUserFastViewProjectionItemsTask</code> and the following
-<code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"RecomputeUserFastViewProjectionItemsTask",
- "username": "{usernameToBeUsed}",
- "processedMessageCount": 3,
- "failedMessageCount": 1,
- "runningOptions": {
- "messagesPerSecond":20
- }
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Success. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Error in the request. Details can be found in the reported error.</p>
-</li>
-<li>
-<p>404: User not found.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_administrating_quotas"><a class="anchor" href="#_administrating_quotas"></a>Administrating quotas</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_administrating_quotas_by_users"><a class="anchor" href="#_administrating_quotas_by_users"></a>Administrating quotas by users</h3>
-<div class="sect3">
-<h4 id="_getting_the_quota_for_a_user"><a class="anchor" href="#_getting_the_quota_for_a_user"></a>Getting the quota for a user</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/quota/users/{usernameToBeUsed}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user</p>
-</div>
-<div class="paragraph">
-<p>The answer is the details of the quota of that user.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "global": {
- "count":252,
- "size":242
- },
- "domain": {
- "count":152,
- "size":142
- },
- "user": {
- "count":52,
- "size":42
- },
- "computed": {
- "count":52,
- "size":42
- },
- "occupation": {
- "size":13,
- "count":21,
- "ratio": {
- "size":0.25,
- "count":0.5,
- "max":0.5
- }
- }
-}</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>The <code>global</code> entry represent the quota limit allowed on this James
-server.</p>
-</li>
-<li>
-<p>The <code>domain</code> entry represent the quota limit allowed for the user of
-that domain.</p>
-</li>
-<li>
-<p>The <code>user</code> entry represent the quota limit allowed for this specific
-user.</p>
-</li>
-<li>
-<p>The <code>computed</code> entry represent the quota limit applied for this user,
-resolved from the upper values.</p>
-</li>
-<li>
-<p>The <code>occupation</code> entry represent the occupation of the quota for this
-user. This includes used count and size as well as occupation ratio
-(used / limit).</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Note that <code>quota</code> object can contain a fixed value, an empty value
-(null) or an unlimited value (-1):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"count":52,"size":42}
-
-{"count":null,"size":null}
-
-{"count":52,"size":-1}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The user’s quota was successfully retrieved</p>
-</li>
-<li>
-<p>404: The user does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_updating_the_quota_for_a_user"><a class="anchor" href="#_updating_the_quota_for_a_user"></a>Updating the quota for a user</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/quota/users/{usernameToBeUsed}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user</p>
-</div>
-<div class="paragraph">
-<p>The body can contain a fixed value, an empty value (null) or an
-unlimited value (-1):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"count":52,"size":42}
-
-{"count":null,"size":null}
-
-{"count":52,"size":-1}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated</p>
-</li>
-<li>
-<p>400: The body is not a positive integer neither an unlimited value
-(-1).</p>
-</li>
-<li>
-<p>404: The user does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_getting_the_quota_count_for_a_user"><a class="anchor" href="#_getting_the_quota_count_for_a_user"></a>Getting the quota count for a user</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/quota/users/{usernameToBeUsed}/count</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user</p>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>52</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The user’s quota was successfully retrieved</p>
-</li>
-<li>
-<p>204: No quota count limit is defined at the user level for this user</p>
-</li>
-<li>
-<p>404: The user does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_updating_the_quota_count_for_a_user"><a class="anchor" href="#_updating_the_quota_count_for_a_user"></a>Updating the quota count for a user</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/quota/users/{usernameToBeUsed}/count</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user</p>
-</div>
-<div class="paragraph">
-<p>The body can contain a fixed value or an unlimited value (-1):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>52</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated</p>
-</li>
-<li>
-<p>400: The body is not a positive integer neither an unlimited value
-(-1).</p>
-</li>
-<li>
-<p>404: The user does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_deleting_the_quota_count_for_a_user"><a class="anchor" href="#_deleting_the_quota_count_for_a_user"></a>Deleting the quota count for a user</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/quota/users/{usernameToBeUsed}/count</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated to unlimited value.</p>
-</li>
-<li>
-<p>404: The user does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_getting_the_quota_size_for_a_user"><a class="anchor" href="#_getting_the_quota_size_for_a_user"></a>Getting the quota size for a user</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/quota/users/{usernameToBeUsed}/size</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user</p>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>52</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The user’s quota was successfully retrieved</p>
-</li>
-<li>
-<p>204: No quota size limit is defined at the user level for this user</p>
-</li>
-<li>
-<p>404: The user does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_updating_the_quota_size_for_a_user"><a class="anchor" href="#_updating_the_quota_size_for_a_user"></a>Updating the quota size for a user</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/quota/users/{usernameToBeUsed}/size</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user</p>
-</div>
-<div class="paragraph">
-<p>The body can contain a fixed value or an unlimited value (-1):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>52</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated</p>
-</li>
-<li>
-<p>400: The body is not a positive integer neither an unlimited value
-(-1).</p>
-</li>
-<li>
-<p>404: The user does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_deleting_the_quota_size_for_a_user"><a class="anchor" href="#_deleting_the_quota_size_for_a_user"></a>Deleting the quota size for a user</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/quota/users/{usernameToBeUsed}/size</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>usernameToBeUsed</code> should be an existing user</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated to unlimited value.</p>
-</li>
-<li>
-<p>404: The user does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_searching_user_by_quota_ratio"><a class="anchor" href="#_searching_user_by_quota_ratio"></a>Searching user by quota ratio</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET 'http://ip:port/quota/users?minOccupationRatio=0.8&maxOccupationRatio=0.99&limit=100&offset=200&domain=domain.com'</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[
- {
- "username":"user@domain.com",
- "detail": {
- "global": {
- "count":252,
- "size":242
- },
- "domain": {
- "count":152,
- "size":142
- },
- "user": {
- "count":52,
- "size":42
- },
- "computed": {
- "count":52,
- "size":42
- },
- "occupation": {
- "size":48,
- "count":21,
- "ratio": {
- "size":0.9230,
- "count":0.5,
- "max":0.9230
- }
- }
- }
- },
- ...
-]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Where:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>minOccupationRatio</strong> is a query parameter determining the minimum
-occupation ratio of users to be returned.</p>
-</li>
-<li>
-<p><strong>maxOccupationRatio</strong> is a query parameter determining the maximum
-occupation ratio of users to be returned.</p>
-</li>
-<li>
-<p><strong>domain</strong> is a query parameter determining the domain of users to be
-returned.</p>
-</li>
-<li>
-<p><strong>limit</strong> is a query parameter determining the maximum number of users
-to be returned.</p>
-</li>
-<li>
-<p><strong>offset</strong> is a query parameter determining the number of users to skip.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Please note that users are alphabetically ordered on username.</p>
-</div>
-<div class="paragraph">
-<p>The response is a list of usernames, with attached quota details as
-defined <a href="#getting-the-quota-for-a-user">here</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: List of users had successfully been returned.</p>
-</li>
-<li>
-<p>400: Validation issues with parameters</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_recomputing_current_quotas_for_users"><a class="anchor" href="#_recomputing_current_quotas_for_users"></a>Recomputing current quotas for users</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /quota/users?task=RecomputeCurrentQuotas</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will recompute current quotas (count and size) for all users stored in
-James.</p>
-</div>
-<div class="paragraph">
-<p>James maintains per quota a projection for current quota count and size.
-As with any projection, it can go out of sync, leading to inconsistent
-results being returned to the client.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>An admin can specify the concurrency that should be used when running
-the task:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>usersPerSecond</code> rate at which users quotas should be reprocessed, per
-second. Defaults to 1.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This optional parameter must have a strictly positive integer as a value
-and be passed as query parameters.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /quota/users?task=RecomputeCurrentQuotas&usersPerSecond=20</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type
-<code>recompute-current-quotas</code> and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "type":"recompute-current-quotas",
- "processedQuotaRoots": 3,
- "failedQuotaRoots": ["#private&bob@localhost"],
- "runningOptions": {
- "usersPerSecond":20
- }
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>WARNING</strong>: this task do not take into account concurrent modifications
-upon a single current quota re-computation. Rerunning the task will
-<em>eventually</em> provide the consistent result.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_administrating_quotas_by_domains"><a class="anchor" href="#_administrating_quotas_by_domains"></a>Administrating quotas by domains</h3>
-<div class="sect3">
-<h4 id="_getting_the_quota_for_a_domain"><a class="anchor" href="#_getting_the_quota_for_a_domain"></a>Getting the quota for a domain</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/quota/domains/{domainToBeUsed}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>domainToBeUsed</code> should be an existing domain. For
-example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/quota/domains/james.org</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The answer will detail the default quota applied to users belonging to
-that domain:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "global": {
- "count":252,
- "size":null
- },
- "domain": {
- "count":null,
- "size":142
- },
- "computed": {
- "count":252,
- "size":142
- }
-}</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>The <code>global</code> entry represents the quota limit defined on this James
-server by default.</p>
-</li>
-<li>
-<p>The <code>domain</code> entry represents the quota limit allowed for the user of
-that domain by default.</p>
-</li>
-<li>
-<p>The <code>computed</code> entry represents the quota limit applied for the users
-of that domain, by default, resolved from the upper values.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Note that <code>quota</code> object can contain a fixed value, an empty value
-(null) or an unlimited value (-1):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"count":52,"size":42}
-
-{"count":null,"size":null}
-
-{"count":52,"size":-1}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The domain’s quota was successfully retrieved</p>
-</li>
-<li>
-<p>404: The domain does not exist</p>
-</li>
-<li>
-<p>405: Domain Quota configuration not supported when virtual hosting is
-desactivated.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_updating_the_quota_for_a_domain"><a class="anchor" href="#_updating_the_quota_for_a_domain"></a>Updating the quota for a domain</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/quota/domains/{domainToBeUsed}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>domainToBeUsed</code> should be an existing domain.</p>
-</div>
-<div class="paragraph">
-<p>The body can contain a fixed value, an empty value (null) or an
-unlimited value (-1):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"count":52,"size":42}
-
-{"count":null,"size":null}
-
-{"count":52,"size":-1}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated</p>
-</li>
-<li>
-<p>400: The body is not a positive integer neither an unlimited value
-(-1).</p>
-</li>
-<li>
-<p>404: The domain does not exist</p>
-</li>
-<li>
-<p>405: Domain Quota configuration not supported when virtual hosting is
-desactivated.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_getting_the_quota_count_for_a_domain"><a class="anchor" href="#_getting_the_quota_count_for_a_domain"></a>Getting the quota count for a domain</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/quota/domains/{domainToBeUsed}/count</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>domainToBeUsed</code> should be an existing domain.</p>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>52</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The domain’s quota was successfully retrieved</p>
-</li>
-<li>
-<p>204: No quota count limit is defined at the domain level for this
-domain</p>
-</li>
-<li>
-<p>404: The domain does not exist</p>
-</li>
-<li>
-<p>405: Domain Quota configuration not supported when virtual hosting is
-desactivated.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_updating_the_quota_count_for_a_domain"><a class="anchor" href="#_updating_the_quota_count_for_a_domain"></a>Updating the quota count for a domain</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/quota/domains/{domainToBeUsed}/count</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>domainToBeUsed</code> should be an existing domain.</p>
-</div>
-<div class="paragraph">
-<p>The body can contain a fixed value or an unlimited value (-1):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>52</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated</p>
-</li>
-<li>
-<p>400: The body is not a positive integer neither an unlimited value
-(-1).</p>
-</li>
-<li>
-<p>404: The domain does not exist</p>
-</li>
-<li>
-<p>405: Domain Quota configuration not supported when virtual hosting is
-desactivated.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_deleting_the_quota_count_for_a_domain"><a class="anchor" href="#_deleting_the_quota_count_for_a_domain"></a>Deleting the quota count for a domain</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/quota/domains/{domainToBeUsed}/count</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>domainToBeUsed</code> should be an existing domain.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated to unlimited value.</p>
-</li>
-<li>
-<p>404: The domain does not exist</p>
-</li>
-<li>
-<p>405: Domain Quota configuration not supported when virtual hosting is
-desactivated.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_getting_the_quota_size_for_a_domain"><a class="anchor" href="#_getting_the_quota_size_for_a_domain"></a>Getting the quota size for a domain</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/quota/domains/{domainToBeUsed}/size</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>domainToBeUsed</code> should be an existing domain.</p>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>52</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The domain’s quota was successfully retrieved</p>
-</li>
-<li>
-<p>204: No quota size limit is defined at the domain level for this
-domain</p>
-</li>
-<li>
-<p>404: The domain does not exist</p>
-</li>
-<li>
-<p>405: Domain Quota configuration not supported when virtual hosting is
-desactivated.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_updating_the_quota_size_for_a_domain"><a class="anchor" href="#_updating_the_quota_size_for_a_domain"></a>Updating the quota size for a domain</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/quota/domains/{domainToBeUsed}/size</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>domainToBeUsed</code> should be an existing domain.</p>
-</div>
-<div class="paragraph">
-<p>The body can contain a fixed value or an unlimited value (-1):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>52</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated</p>
-</li>
-<li>
-<p>400: The body is not a positive integer neither an unlimited value
-(-1).</p>
-</li>
-<li>
-<p>404: The domain does not exist</p>
-</li>
-<li>
-<p>405: Domain Quota configuration not supported when virtual hosting is
-desactivated.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_deleting_the_quota_size_for_a_domain"><a class="anchor" href="#_deleting_the_quota_size_for_a_domain"></a>Deleting the quota size for a domain</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/quota/domains/{domainToBeUsed}/size</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>domainToBeUsed</code> should be an existing domain.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated to unlimited value.</p>
-</li>
-<li>
-<p>404: The domain does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_administrating_global_quotas"><a class="anchor" href="#_administrating_global_quotas"></a>Administrating global quotas</h3>
-<div class="sect3">
-<h4 id="_getting_the_global_quota"><a class="anchor" href="#_getting_the_global_quota"></a>Getting the global quota</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/quota</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The answer is the details of the global quota.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "count":252,
- "size":242
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note that <code>quota</code> object can contain a fixed value, an empty value
-(null) or an unlimited value (-1):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"count":52,"size":42}
-
-{"count":null,"size":null}
-
-{"count":52,"size":-1}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The quota was successfully retrieved</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_updating_global_quota"><a class="anchor" href="#_updating_global_quota"></a>Updating global quota</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/quota</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The body can contain a fixed value, an empty value (null) or an
-unlimited value (-1):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"count":52,"size":42}
-
-{"count":null,"size":null}
-
-{"count":52,"size":-1}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated</p>
-</li>
-<li>
-<p>400: The body is not a positive integer neither an unlimited value
-(-1).</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_getting_the_global_quota_count"><a class="anchor" href="#_getting_the_global_quota_count"></a>Getting the global quota count</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/quota/count</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name usernameToBeUsed should be an existing user</p>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>52</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The quota was successfully retrieved</p>
-</li>
-<li>
-<p>204: No quota count limit is defined at the global level</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_updating_the_global_quota_count"><a class="anchor" href="#_updating_the_global_quota_count"></a>Updating the global quota count</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/quota/count</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The body can contain a fixed value or an unlimited value (-1):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>52</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated</p>
-</li>
-<li>
-<p>400: The body is not a positive integer neither an unlimited value
-(-1).</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_deleting_the_global_quota_count"><a class="anchor" href="#_deleting_the_global_quota_count"></a>Deleting the global quota count</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/quota/count</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated to unlimited value.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_getting_the_global_quota_size"><a class="anchor" href="#_getting_the_global_quota_size"></a>Getting the global quota size</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/quota/size</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>52</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The quota was successfully retrieved</p>
-</li>
-<li>
-<p>204: No quota size limit is defined at the global level</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_updating_the_global_quota_size"><a class="anchor" href="#_updating_the_global_quota_size"></a>Updating the global quota size</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/quota/size</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The body can contain a fixed value or an unlimited value (-1):</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>52</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated</p>
-</li>
-<li>
-<p>400: The body is not a positive integer neither an unlimited value
-(-1).</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_deleting_the_global_quota_size"><a class="anchor" href="#_deleting_the_global_quota_size"></a>Deleting the global quota size</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/quota/size</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The quota has been updated to unlimited value.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_administrating_sieve_quotas"><a class="anchor" href="#_administrating_sieve_quotas"></a>Administrating Sieve quotas</h3>
-<div class="paragraph">
-<p>Some limitations on space Users Sieve script can occupy can be
-configured by default, and overridden by user.</p>
-</div>
-<div class="sect3">
-<h4 id="_retrieving_global_sieve_quota"><a class="anchor" href="#_retrieving_global_sieve_quota"></a>Retrieving global sieve quota</h4>
-<div class="paragraph">
-<p>This endpoints allows to retrieve the global Sieve quota, which will be
-users default:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/sieve/quota/default</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the bytes count allowed by user per default on this server.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>102400</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Request is a success and the value is returned</p>
-</li>
-<li>
-<p>204: No default quota is being configured</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_updating_global_sieve_quota"><a class="anchor" href="#_updating_global_sieve_quota"></a>Updating global sieve quota</h4>
-<div class="paragraph">
-<p>This endpoints allows to update the global Sieve quota, which will be
-users default:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/sieve/quota/default</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>With the body being the bytes count allowed by user per default on this
-server.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>102400</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Operation succeeded</p>
-</li>
-<li>
-<p>400: Invalid payload</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_removing_global_sieve_quota"><a class="anchor" href="#_removing_global_sieve_quota"></a>Removing global sieve quota</h4>
-<div class="paragraph">
-<p>This endpoints allows to remove the global Sieve quota. There will no
-more be users default:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/sieve/quota/default</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Operation succeeded</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_retrieving_user_sieve_quota"><a class="anchor" href="#_retrieving_user_sieve_quota"></a>Retrieving user sieve quota</h4>
-<div class="paragraph">
-<p>This endpoints allows to retrieve the Sieve quota of a user, which will
-be this users quota:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/sieve/quota/users/user@domain.com</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the bytes count allowed for this user.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>102400</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Request is a success and the value is returned</p>
-</li>
-<li>
-<p>204: No quota is being configured for this user</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_updating_user_sieve_quota"><a class="anchor" href="#_updating_user_sieve_quota"></a>Updating user sieve quota</h4>
-<div class="paragraph">
-<p>This endpoints allows to update the Sieve quota of a user, which will be
-users default:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/sieve/quota/users/user@domain.com</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>With the body being the bytes count allowed for this user on this
-server.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>102400</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Operation succeeded</p>
-</li>
-<li>
-<p>400: Invalid payload</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_removing_user_sieve_quota"><a class="anchor" href="#_removing_user_sieve_quota"></a>Removing user sieve quota</h4>
-<div class="paragraph">
-<p>This endpoints allows to remove the Sieve quota of a user. There will no
-more quota for this user:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/sieve/quota/users/user@domain.com</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Operation succeeded</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_administrating_recipient_rewriting"><a class="anchor" href="#_administrating_recipient_rewriting"></a>Administrating Recipient rewriting</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_address_group"><a class="anchor" href="#_address_group"></a>Address group</h3>
-<div class="paragraph">
-<p>You can use <strong>webadmin</strong> to define address groups.</p>
-</div>
-<div class="paragraph">
-<p>When a specific email is sent to the group mail address, every group
-member will receive it.</p>
-</div>
-<div class="paragraph">
-<p>Note that the group mail address is virtual: it does not correspond to
-an existing user.</p>
-</div>
-<div class="paragraph">
-<p>This feature uses <a href="#distributed/architecture.adoc#_recipient_rewrite_tables" class="xref unresolved">Recipients rewrite table</a>
-and requires the
-<a 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>
-</div>
-<div class="paragraph">
-<p>Note that email addresses are restricted to ASCII character set. Mail
-addresses not matching this criteria will be rejected.</p>
-</div>
-<div class="sect3">
-<h4 id="_listing_groups"><a class="anchor" href="#_listing_groups"></a>Listing groups</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/address/groups</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the groups as a list of JSON Strings representing mail
-addresses. For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>["group1@domain.com", "group2@domain.com"]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_listing_members_of_a_group"><a class="anchor" href="#_listing_members_of_a_group"></a>Listing members of a group</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/address/groups/group@domain.com</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the group members as a list of JSON Strings representing
-mail addresses. For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>["member1@domain.com", "member2@domain.com"]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success</p>
-</li>
-<li>
-<p>400: Group structure is not valid</p>
-</li>
-<li>
-<p>404: The group does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_adding_a_group_member"><a class="anchor" href="#_adding_a_group_member"></a>Adding a group member</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/address/groups/group@domain.com/member@domain.com</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will add <a href="mailto:member@domain.com">member@domain.com</a> to <a href="mailto:group@domain.com">group@domain.com</a>, creating the group if
-needed</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Success</p>
-</li>
-<li>
-<p>400: Group structure or member is not valid</p>
-</li>
-<li>
-<p>400: Domain in the source is not managed by the DomainList</p>
-</li>
-<li>
-<p>409: Requested group address is already used for another purpose</p>
-</li>
-<li>
-<p>409: The addition of the group member would lead to a loop and thus cannot be performed</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_removing_a_group_member"><a class="anchor" href="#_removing_a_group_member"></a>Removing a group member</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/address/groups/group@domain.com/member@domain.com</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will remove <a href="mailto:member@domain.com">member@domain.com</a> from <a href="mailto:group@domain.com">group@domain.com</a>, removing the group
-if group is empty after deletion</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Success</p>
-</li>
-<li>
-<p>400: Group structure or member is not valid</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_address_forwards"><a class="anchor" href="#_address_forwards"></a>Address forwards</h3>
-<div class="paragraph">
-<p>You can use <strong>webadmin</strong> to define address forwards.</p>
-</div>
-<div class="paragraph">
-<p>When a specific email is sent to the base mail address, every forward
-destination addresses will receive it.</p>
-</div>
-<div class="paragraph">
-<p>Please note that the base address can be optionaly part of the forward
-destination. In that case, the base recipient also receive a copy of the
-mail. Otherwise he is ommitted.</p>
-</div>
-<div class="paragraph">
-<p>Forwards can be defined for existing users. It then defers from
-``groups''.</p>
-</div>
-<div class="paragraph">
-<p>This feature uses <a href="#distributed/architecture.adoc#_recipient_rewrite_tables" class="xref unresolved">Recipients rewrite table</a>
-and requires the
-<a 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>
-</div>
-<div class="paragraph">
-<p>Note that email addresses are restricted to ASCII character set. Mail
-addresses not matching this criteria will be rejected.</p>
-</div>
-<div class="sect3">
-<h4 id="_listing_forwards"><a class="anchor" href="#_listing_forwards"></a>Listing Forwards</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/address/forwards</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the users having forwards configured as a list of JSON
-Strings representing mail addresses. For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>["user1@domain.com", "user2@domain.com"]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_listing_destinations_in_a_forward"><a class="anchor" href="#_listing_destinations_in_a_forward"></a>Listing destinations in a forward</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/address/forwards/user@domain.com</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the destination addresses of this forward as a list of JSON
-Strings representing mail addresses. For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[
- {"mailAddress":"destination1@domain.com"},
- {"mailAddress":"destination2@domain.com"}
-]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success</p>
-</li>
-<li>
-<p>400: Forward structure is not valid</p>
-</li>
-<li>
-<p>404: The given user don’t have forwards or does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_adding_a_new_destination_to_a_forward"><a class="anchor" href="#_adding_a_new_destination_to_a_forward"></a>Adding a new destination to a forward</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/address/forwards/user@domain.com/targets/destination@domain.com</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will add <a href="mailto:destination@domain.com">destination@domain.com</a> to <a href="mailto:user@domain.com">user@domain.com</a>, creating the forward
-if needed</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Success</p>
-</li>
-<li>
-<p>400: Forward structure or member is not valid</p>
-</li>
-<li>
-<p>400: Domain in the source is not managed by the DomainList</p>
-</li>
-<li>
-<p>404: Requested forward address does not match an existing user</p>
-</li>
-<li>
-<p>409: The creation of the forward would lead to a loop and thus cannot be performed</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_removing_a_destination_of_a_forward"><a class="anchor" href="#_removing_a_destination_of_a_forward"></a>Removing a destination of a forward</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/address/forwards/user@domain.com/targets/destination@domain.com</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will remove <a href="mailto:destination@domain.com">destination@domain.com</a> from <a href="mailto:user@domain.com">user@domain.com</a>, removing the
-forward if forward is empty after deletion</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Success</p>
-</li>
-<li>
-<p>400: Forward structure or member is not valid</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_address_aliases"><a class="anchor" href="#_address_aliases"></a>Address aliases</h3>
-<div class="paragraph">
-<p>You can use <strong>webadmin</strong> to define aliases for an user.</p>
-</div>
-<div class="paragraph">
-<p>When a specific email is sent to the alias address, the destination
-address of the alias will receive it.</p>
-</div>
-<div class="paragraph">
-<p>Aliases can be defined for existing users.</p>
-</div>
-<div class="paragraph">
-<p>This feature uses <a href="#distributed/architecture.adoc#_recipient_rewrite_tables" class="xref unresolved">Recipients rewrite table</a>
-and requires the
-<a 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>
-</div>
-<div class="paragraph">
-<p>Note that email addresses are restricted to ASCII character set. Mail
-addresses not matching this criteria will be rejected.</p>
-</div>
-<div class="sect3">
-<h4 id="_listing_users_with_aliases"><a class="anchor" href="#_listing_users_with_aliases"></a>Listing users with aliases</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/address/aliases</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the users having aliases configured as a list of JSON
-Strings representing mail addresses. For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>["user1@domain.com", "user2@domain.com"]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_listing_alias_sources_of_an_user"><a class="anchor" href="#_listing_alias_sources_of_an_user"></a>Listing alias sources of an user</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/address/aliases/user@domain.com</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the aliases of this user as a list of JSON Strings
-representing mail addresses. For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[
- {"source":"alias1@domain.com"},
- {"source":"alias2@domain.com"}
-]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success</p>
-</li>
-<li>
-<p>400: Alias structure is not valid</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_adding_a_new_alias_to_an_user"><a class="anchor" href="#_adding_a_new_alias_to_an_user"></a>Adding a new alias to an user</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/address/aliases/user@domain.com/sources/alias@domain.com</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will add <a href="mailto:alias@domain.com">alias@domain.com</a> to <a href="mailto:user@domain.com">user@domain.com</a>, creating the alias if
-needed</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: OK</p>
-</li>
-<li>
-<p>400: Alias structure or member is not valid</p>
-</li>
-<li>
-<p>400: The alias source exists as an user already</p>
-</li>
-<li>
-<p>400: Source and destination can’t be the same!</p>
-</li>
-<li>
-<p>400: Domain in the destination or source is not managed by the
-DomainList</p>
-</li>
-<li>
-<p>409: The addition of the alias would lead to a loop and thus cannot be performed</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_removing_an_alias_of_an_user"><a class="anchor" href="#_removing_an_alias_of_an_user"></a>Removing an alias of an user</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/address/aliases/user@domain.com/sources/alias@domain.com</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will remove <a href="mailto:alias@domain.com">alias@domain.com</a> from <a href="mailto:user@domain.com">user@domain.com</a>, removing the alias if
-needed</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: OK</p>
-</li>
-<li>
-<p>400: Alias structure or member is not valid</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_domain_mappings"><a class="anchor" href="#_domain_mappings"></a>Domain mappings</h3>
-<div class="paragraph">
-<p>You can use <strong>webadmin</strong> to define domain mappings.</p>
-</div>
-<div class="paragraph">
-<p>Given a configured source (from) domain and a destination (to) domain,
-when an email is sent to an address belonging to the source domain, then
-the domain part of this address is overwritten, the destination domain
-is then used. A source (from) domain can have many destination (to)
-domains.</p>
-</div>
-<div class="paragraph">
-<p>For example: with a source domain <code>james.apache.org</code> maps to two
-destination domains <code>james.org</code> and <code>apache-james.org</code>, when a mail is
-sent to <code>admin@james.apache.org</code>, then it will be routed to
-<code>admin@james.org</code> and <code>admin@apache-james.org</code></p>
-</div>
-<div class="paragraph">
-<p>This feature uses <a href="#distributed/architecture.adoc#_recipient_rewrite_tables" class="xref unresolved">Recipients rewrite table</a>
-and requires the
-<a 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>
-</div>
-<div class="paragraph">
-<p>Note that email addresses are restricted to ASCII character set. Mail
-addresses not matching this criteria will be rejected.</p>
-</div>
-<div class="sect3">
-<h4 id="_listing_all_domain_mappings"><a class="anchor" href="#_listing_all_domain_mappings"></a>Listing all domain mappings</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/domainMappings</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return all configured domain mappings</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "firstSource.org" : ["firstDestination.com", "secondDestination.net"],
- "secondSource.com" : ["thirdDestination.com", "fourthDestination.net"],
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: OK</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_listing_all_destination_domains_for_a_source_domain"><a class="anchor" href="#_listing_all_destination_domains_for_a_source_domain"></a>Listing all destination domains for a source domain</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/domainMappings/sourceDomain.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>With <code>sourceDomain.tld</code> as the value passed to <code>fromDomain</code> resource
-name, the API will return all destination domains configured to that
-domain</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>["firstDestination.com", "secondDestination.com"]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: OK</p>
-</li>
-<li>
-<p>400: The <code>fromDomain</code> resource name is invalid</p>
-</li>
-<li>
-<p>404: The <code>fromDomain</code> resource name is not found</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_adding_a_domain_mapping"><a class="anchor" href="#_adding_a_domain_mapping"></a>Adding a domain mapping</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/domainMappings/sourceDomain.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Body:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>destination.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>With <code>sourceDomain.tld</code> as the value passed to <code>fromDomain</code> resource
-name, the API will add a destination domain specified in the body to
-that domain</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: OK</p>
-</li>
-<li>
-<p>400: The <code>fromDomain</code> resource name is invalid</p>
-</li>
-<li>
-<p>400: The destination domain specified in the body is invalid</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Be aware that no checks to find possible loops that would result of this creation will be performed.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_removing_a_domain_mapping"><a class="anchor" href="#_removing_a_domain_mapping"></a>Removing a domain mapping</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/domainMappings/sourceDomain.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Body:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>destination.tld</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>With <code>sourceDomain.tld</code> as the value passed to <code>fromDomain</code> resource
-name, the API will remove a destination domain specified in the body
-mapped to that domain</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: OK</p>
-</li>
-<li>
-<p>400: The <code>fromDomain</code> resource name is invalid</p>
-</li>
-<li>
-<p>400: The destination domain specified in the body is invalid</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_regex_mapping"><a class="anchor" href="#_regex_mapping"></a>Regex mapping</h3>
-<div class="paragraph">
-<p>You can use <strong>webadmin</strong> to create regex mappings.</p>
-</div>
-<div class="paragraph">
-<p>A regex mapping contains a mapping source and a Java Regular Expression
-(regex) in String as the mapping value. Everytime, if a mail containing
-a recipient matched with the mapping source, then that mail will be
-re-routed to a new recipient address which is re written by the regex.</p>
-</div>
-<div class="paragraph">
-<p>This feature uses <a href="#distributed/architecture.adoc#_recipient_rewrite_tables" class="xref unresolved">Recipients rewrite table</a>
-and requires the
-<a href="https://github.com/apache/james-project/blob/master/server/mailet/mailets/src/main/java/org/apache/james/transport/mailets/RecipientRewriteTable.java">RecipientRewriteTable
-API</a> to be configured.</p>
-</div>
-<div class="sect3">
-<h4 id="_adding_a_regex_mapping"><a class="anchor" href="#_adding_a_regex_mapping"></a>Adding a regex mapping</h4>
-<div class="literalblock">
-<div class="content">
-<pre>POST /mappings/regex/mappingSource/targets/regex</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Where:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>the <code>mappingSource</code> is the path parameter represents for the Regex
-Mapping mapping source</p>
-</li>
-<li>
-<p>the <code>regex</code> is the path parameter represents for the Regex Mapping
-regex</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The route will add a regex mapping made from <code>mappingSource</code> and <code>regex</code>
-to RecipientRewriteTable.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/mappings/regex/james@domain.tld/targets/james@.*:james-intern@james.org</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Mapping added successfully.</p>
-</li>
-<li>
-<p>400: Invalid <code>mappingSource</code> path parameter.</p>
-</li>
-<li>
-<p>400: Invalid <code>regex</code> path parameter.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Be aware that no checks to find possible loops that would result of this creation will be performed.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_removing_a_regex_mapping"><a class="anchor" href="#_removing_a_regex_mapping"></a>Removing a regex mapping</h4>
-<div class="literalblock">
-<div class="content">
-<pre>DELETE /mappings/regex/{mappingSource}/targets/{regex}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Where:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>the <code>mappingSource</code> is the path parameter representing the Regex
-Mapping mapping source</p>
-</li>
-<li>
-<p>the <code>regex</code> is the path parameter representing the Regex Mapping regex</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The route will remove the regex mapping made from <code>regex</code> from the
-mapping source <code>mappingSource</code> to RecipientRewriteTable.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/mappings/regex/james@domain.tld/targets/[O_O]:james-intern@james.org</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Mapping deleted successfully.</p>
-</li>
-<li>
-<p>400: Invalid <code>mappingSource</code> path parameter.</p>
-</li>
-<li>
-<p>400: Invalid <code>regex</code> path parameter.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_address_mappings"><a class="anchor" href="#_address_mappings"></a>Address Mappings</h3>
-<div class="paragraph">
-<p>You can use <strong>webadmin</strong> to define address mappings.</p>
-</div>
-<div class="paragraph">
-<p>When a specific email is sent to the base mail address, every
-destination addresses will receive it.</p>
-</div>
-<div class="paragraph">
-<p>This feature uses <a href="#distributed/architecture.adoc#_recipient_rewrite_tables" class="xref unresolved">Recipients rewrite table</a>
-and requires the
-<a 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>
-</div>
-<div class="paragraph">
-<p>Note that email addresses are restricted to ASCII character set. Mail
-addresses not matching this criteria will be rejected.</p>
-</div>
-<div class="paragraph">
-<p>Please use address mappings with caution, as it’s not a typed address.
-If you know the type of your address (forward, alias, domain, group,
-etc), prefer using the corresponding routes to those types.</p>
-</div>
-<div class="paragraph">
-<p>Here are the following actions available on address mappings:</p>
-</div>
-<div class="sect3">
-<h4 id="_add_an_address_mapping"><a class="anchor" href="#_add_an_address_mapping"></a>Add an address mapping</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/mappings/address/{mappingSource}/targets/{destinationAddress}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Add an address mapping to the Recipients rewrite table
-Mapping source is the value of {mappingSource} Mapping destination is
-the value of {destinationAddress} Type of mapping destination is
-Address</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Action successfully performed</p>
-</li>
-<li>
-<p>400: Invalid parameters</p>
-</li>
-<li>
-<p>409: The addition of the address mapping would lead to a loop and thus cannot be performed</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_remove_an_address_mapping"><a class="anchor" href="#_remove_an_address_mapping"></a>Remove an address mapping</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/mappings/address/{mappingSource}/targets/{destinationAddress}</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Remove an address mapping from the Recipients rewrite table</p>
-</li>
-<li>
-<p>Mapping source is the value of <code>mappingSource</code></p>
-</li>
-<li>
-<p>Mapping destination is the value of <code>destinationAddress</code></p>
-</li>
-<li>
-<p>Type of mapping destination is Address</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Action successfully performed</p>
-</li>
-<li>
-<p>400: Invalid parameters</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_list_all_mappings"><a class="anchor" href="#_list_all_mappings"></a>List all mappings</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mappings</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Get all mappings from the
-<a href="#distributed/architecture.adoc#_recipient_rewrite_tables" class="xref unresolved">Recipients rewrite table</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response body:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "alias@domain.tld": [
- {
- "type": "Alias",
- "mapping": "user@domain.tld"
- },
- {
- "type": "Group",
- "mapping": "group-user@domain.tld"
- }
- ],
- "aliasdomain.tld": [
- {
- "type": "Domain",
- "mapping": "realdomain.tld"
- }
- ],
- "group@domain.tld": [
- {
- "type": "Address",
- "mapping": "user@domain.tld"
- }
- ]
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response code:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: OK</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_listing_user_mappings"><a class="anchor" href="#_listing_user_mappings"></a>Listing User Mappings</h3>
-<div class="paragraph">
-<p>This endpoint allows receiving all mappings of a corresponding user.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mappings/user/{userAddress}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Return all mappings of a user where:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>userAddress</code>: is the selected user</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Response body:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[
- {
- "type": "Address",
- "mapping": "user123@domain.tld"
- },
- {
- "type": "Alias",
- "mapping": "aliasuser123@domain.tld"
- },
- {
- "type": "Group",
- "mapping": "group123@domain.tld"
- }
-]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: OK</p>
-</li>
-<li>
-<p>400: Invalid parameter value</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_administrating_mail_repositories"><a class="anchor" href="#_administrating_mail_repositories"></a>Administrating mail repositories</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_create_a_mail_repository"><a class="anchor" href="#_create_a_mail_repository"></a>Create a mail repository</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/mailRepositories/{encodedPathOfTheRepository}?protocol={someProtocol}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>encodedPathOfTheRepository</code> should be the resource path
-of the created mail repository. Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/mailRepositories/mailRepo?protocol=file</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: The repository is created</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_listing_mail_repositories"><a class="anchor" href="#_listing_mail_repositories"></a>Listing mail repositories</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mailRepositories</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[
- {
- "repository": "var/mail/error/",
- "path": "var%2Fmail%2Ferror%2F"
- },
- {
- "repository": "var/mail/relay-denied/",
- "path": "var%2Fmail%2Frelay-denied%2F"
- },
- {
- "repository": "var/mail/spam/",
- "path": "var%2Fmail%2Fspam%2F"
- },
- {
- "repository": "var/mail/address-error/",
- "path": "var%2Fmail%2Faddress-error%2F"
- }
-]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can use <code>id</code>, the encoded URL of the repository, to access it in
-later requests.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The list of mail repositories</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_getting_additional_information_for_a_mail_repository"><a class="anchor" href="#_getting_additional_information_for_a_mail_repository"></a>Getting additional information for a mail repository</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mailRepositories/{encodedPathOfTheRepository}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>encodedPathOfTheRepository</code> should be the resource path
-of an existing mail repository. Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mailRepositories/var%2Fmail%2Ferror%2F</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "repository": "var/mail/error/",
- "path": "mail%2Ferror%2F",
- "size": 243
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Additonnal information for that repository</p>
-</li>
-<li>
-<p>404: This repository can not be found</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_listing_mails_contained_in_a_mail_repository"><a class="anchor" href="#_listing_mails_contained_in_a_mail_repository"></a>Listing mails contained in a mail repository</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mailRepositories/{encodedPathOfTheRepository}/mails</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>encodedPathOfTheRepository</code> should be the resource path
-of an existing mail repository. Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mailRepositories/var%2Fmail%2Ferror%2F/mails</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The answer will contains all mailKey contained in that repository.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[
- "mail-key-1",
- "mail-key-2",
- "mail-key-3"
-]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note that this can be used to read mail details.</p>
-</div>
-<div class="paragraph">
-<p>You can pass additional URL parameters to this call in order to limit
-the output: - A limit: no more elements than the specified limit will be
-returned. This needs to be strictly positive. If no value is specified,
-no limit will be applied. - An offset: allow to skip elements. This
-needs to be positive. Default value is zero.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET 'http://ip:port/mailRepositories/var%2Fmail%2Ferror%2F/mails?limit=100&offset=500'</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The list of mail keys contained in that mail repository</p>
-</li>
-<li>
-<p>400: Invalid parameters</p>
-</li>
-<li>
-<p>404: This repository can not be found</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_readingdownloading_a_mail_details"><a class="anchor" href="#_readingdownloading_a_mail_details"></a>Reading/downloading a mail details</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mailRepositories/{encodedPathOfTheRepository}/mails/mailKey</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>encodedPathOfTheRepository</code> should be the resource path
-of an existing mail repository. Resource name <code>mailKey</code> should be the
-key of a mail stored in that repository. Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mailRepositories/var%2Fmail%2Ferror%2F/mails/mail-key-1</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If the Accept header in the request is ``application/json'', then the
-response looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "name": "mail-key-1",
- "sender": "sender@domain.com",
- "recipients": ["recipient1@domain.com", "recipient2@domain.com"],
- "state": "address-error",
- "error": "A small message explaining what happened to that mail...",
- "remoteHost": "111.222.333.444",
- "remoteAddr": "127.0.0.1",
- "lastUpdated": null
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If the Accept header in the request is ``message/rfc822'', then the
-response will be the <em>eml</em> file itself.</p>
-</div>
-<div class="paragraph">
-<p>Additional query parameter <code>additionalFields</code> add the existing
-information to the response for the supported values (only work with
-``application/json'' Accept header):</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>attributes</p>
-</li>
-<li>
-<p>headers</p>
-</li>
-<li>
-<p>textBody</p>
-</li>
-<li>
-<p>htmlBody</p>
-</li>
-<li>
-<p>messageSize</p>
-</li>
-<li>
-<p>perRecipientsHeaders</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mailRepositories/file%3A%2F%2Fvar%2Fmail%2Ferror%2F/mails/mail-key-1?additionalFields=attributes,headers,textBody,htmlBody,messageSize,perRecipientsHeaders</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Give the following kind of response:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "name": "mail-key-1",
- "sender": "sender@domain.com",
- "recipients": ["recipient1@domain.com", "recipient2@domain.com"],
- "state": "address-error",
- "error": "A small message explaining what happened to that mail...",
- "remoteHost": "111.222.333.444",
- "remoteAddr": "127.0.0.1",
- "lastUpdated": null,
- "attributes": {
- "name2": "value2",
- "name1": "value1"
- },
- "perRecipientsHeaders": {
- "third@party": {
- "headerName1": [
- "value1",
- "value2"
- ],
- "headerName2": [
- "value3",
- "value4"
- ]
- }
- },
- "headers": {
- "headerName4": [
- "value6",
- "value7"
- ],
- "headerName3": [
- "value5",
- "value8"
- ]
- },
- "textBody": "My body!!",
- "htmlBody": "My <em>body</em>!!",
- "messageSize": 42424242
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Details of the mail</p>
-</li>
-<li>
-<p>404: This repository or mail can not be found</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_removing_a_mail_from_a_mail_repository"><a class="anchor" href="#_removing_a_mail_from_a_mail_repository"></a>Removing a mail from a mail repository</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/mailRepositories/{encodedPathOfTheRepository}/mails/mailKey</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>encodedPathOfTheRepository</code> should be the resource path
-of an existing mail repository. Resource name <code>mailKey</code> should be the
-key of a mail stored in that repository. Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/mailRepositories/var%2Fmail%2Ferror%2F/mails/mail-key-1</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: This mail no longer exists in this repository</p>
-</li>
-<li>
-<p>404: This repository can not be found</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_removing_all_mails_from_a_mail_repository"><a class="anchor" href="#_removing_all_mails_from_a_mail_repository"></a>Removing all mails from a mail repository</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/mailRepositories/{encodedPathOfTheRepository}/mails</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>encodedPathOfTheRepository</code> should be the resource path
-of an existing mail repository. Example:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/mailRepositories/var%2Fmail%2Ferror%2F/mails</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Task generation succeeded. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>404: Could not find that mail repository</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>clear-mail-repository</code>
-and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "mailRepositoryPath":"var/mail/error/",
- "initialCount": 243,
- "remainingCount": 17
-}</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_reprocessing_mails_from_a_mail_repository"><a class="anchor" href="#_reprocessing_mails_from_a_mail_repository"></a>Reprocessing mails from a mail repository</h3>
-<div class="paragraph">
-<p>Sometime, you want to re-process emails stored in a mail repository. For
-instance, you can make a configuration error, or there can be a James
-bug that makes processing of some mails fail. Those mail will be stored
-in a mail repository. Once you solved the problem, you can reprocess
-them.</p>
-</div>
-<div class="paragraph">
-<p>To reprocess mails from a repository:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPATCH http://ip:port/mailRepositories/{encodedPathOfTheRepository}/mails?action=reprocess</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>encodedPathOfTheRepository</code> should be the resource path
-of an existing mail repository. Example:</p>
-</div>
-<div class="paragraph">
-<p>For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPATCH http://ip:port/mailRepositories/var%2Fmail%2Ferror%2F/mails?action=reprocess</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Additional query parameters are supported: - <code>queue</code> allows you to
-target the mail queue you want to enqueue the mails in. Defaults to
-<code>spool</code>. - <code>processor</code> allows you to overwrite the state of the
-reprocessing mails, and thus select the processors they will start their
-processing in. Defaults to the <code>state</code> field of each processed email.</p>
-</div>
-<div class="paragraph">
-<p>For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPATCH 'http://ip:port/mailRepositories/var%2Fmail%2Ferror%2F/mails?action=reprocess&processor=transport&queue=spool'</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note that the <code>action</code> query parameter is compulsary and can only take
-value <code>reprocess</code>.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Task generation succeeded. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>404: Could not find that mail repository</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>reprocessing-all</code> and
-the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "mailRepositoryPath":"var/mail/error/",
- "targetQueue":"spool",
- "targetProcessor":"transport",
- "initialCount": 243,
- "remainingCount": 17
-}</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_reprocessing_a_specific_mail_from_a_mail_repository"><a class="anchor" href="#_reprocessing_a_specific_mail_from_a_mail_repository"></a>Reprocessing a specific mail from a mail repository</h3>
-<div class="paragraph">
-<p>To reprocess a specific mail from a mail repository:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPATCH http://ip:port/mailRepositories/{encodedPathOfTheRepository}/mails/mailKey?action=reprocess</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>encodedPathOfTheRepository</code> should be the resource id of
-an existing mail repository. Resource name <code>mailKey</code> should be the key
-of a mail stored in that repository. Example:</p>
-</div>
-<div class="paragraph">
-<p>For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPATCH http://ip:port/mailRepositories/var%2Fmail%2Ferror%2F/mails/name1?action=reprocess</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Additional query parameters are supported: - <code>queue</code> allows you to
-target the mail queue you want to enqueue the mails in. Defaults to
-<code>spool</code>. - <code>processor</code> allows you to overwrite the state of the
-reprocessing mails, and thus select the processors they will start their
-processing in. Defaults to the <code>state</code> field of each processed email.</p>
-</div>
-<div class="paragraph">
-<p>While <code>processor</code> being an optional parameter, not specifying it will
-result reprocessing the mails in their current state
-(<a href="https://james.apache.org/server/feature-mailetcontainer.html#Processors">see
-documentation about processors and state</a>). Consequently, only few cases
-will give a different result, definitively storing them out of the mail
-repository.</p>
-</div>
-<div class="paragraph">
-<p>For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPATCH 'http://ip:port/mailRepositories/var%2Fmail%2Ferror%2F/mails/name1?action=reprocess&processor=transport&queue=spool'</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note that the <code>action</code> query parameter is compulsary and can only take
-value <code>reprocess</code>.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Task generation succeeded. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>404: Could not find that mail repository</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>reprocessing-one</code> and
-the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "mailRepositoryPath":"var/mail/error/",
- "targetQueue":"spool",
- "targetProcessor":"transport",
- "mailKey":"name1"
-}</pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_administrating_mail_queues"><a class="anchor" href="#_administrating_mail_queues"></a>Administrating mail queues</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_listing_mail_queues"><a class="anchor" href="#_listing_mail_queues"></a>Listing mail queues</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mailQueues</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>["outgoing","spool"]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: The list of mail queues</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_getting_a_mail_queue_details"><a class="anchor" href="#_getting_a_mail_queue_details"></a>Getting a mail queue details</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mailQueues/{mailQueueName}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Resource name <code>mailQueueName</code> is the name of a mail queue, this command
-will return the details of the given mail queue. For instance:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"name":"outgoing","size":0}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success</p>
-</li>
-<li>
-<p>400: Mail queue is not valid</p>
-</li>
-<li>
-<p>404: The mail queue does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_listing_the_mails_of_a_mail_queue"><a class="anchor" href="#_listing_the_mails_of_a_mail_queue"></a>Listing the mails of a mail queue</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mailQueues/{mailQueueName}/mails</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Additional URL query parameters:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>limit</code>: Maximum number of mails returned in a single call. Only
-strictly positive integer values are accepted. Example:</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/mailQueues/{mailQueueName}/mails?limit=100</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The answer looks like:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[{
- "name": "Mail1516976156284-8b3093b9-eebf-4c40-9c26-1450f4fcdc3c-to-test.com",
- "sender": "user@james.linagora.com",
- "recipients": ["someone@test.com"],
- "nextDelivery": "1969-12-31T23:59:59.999Z"
-}]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success</p>
-</li>
-<li>
-<p>400: Mail queue is not valid or limit is invalid</p>
-</li>
-<li>
-<p>404: The mail queue does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_deleting_mails_from_a_mail_queue"><a class="anchor" href="#_deleting_mails_from_a_mail_queue"></a>Deleting mails from a mail queue</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/mailQueues/{mailQueueName}/mails?sender=senderMailAddress</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>This request should have exactly one query parameter from the following
-list:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>sender: which is a mail address (i.e. <a href="mailto:sender@james.org">sender@james.org</a>)</p>
-</li>
-<li>
-<p>name: which is a string</p>
-</li>
-<li>
-<p>recipient: which is a mail address (i.e. <a href="mailto:recipient@james.org">recipient@james.org</a>)</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The mails from the given mail queue matching the query parameter will be
-deleted.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Task generation succeeded. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Invalid request</p>
-</li>
-<li>
-<p>404: The mail queue does not exist</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type
-<code>delete-mails-from-mail-queue</code> and the following
-<code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "queue":"outgoing",
- "initialCount":10,
- "remainingCount": 5,
- "sender": "sender@james.org",
- "name": "Java Developer",
- "recipient: "recipient@james.org"
-}</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_clearing_a_mail_queue"><a class="anchor" href="#_clearing_a_mail_queue"></a>Clearing a mail queue</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/mailQueues/{mailQueueName}/mails</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>All mails from the given mail queue will be deleted.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Task generation succeeded. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Invalid request</p>
-</li>
-<li>
-<p>404: The mail queue does not exist</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>clear-mail-queue</code> and
-the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "queue":"outgoing",
- "initialCount":10,
- "remainingCount": 0
-}</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_flushing_mails_from_a_mail_queue"><a class="anchor" href="#_flushing_mails_from_a_mail_queue"></a>Flushing mails from a mail queue</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPATCH http://ip:port/mailQueues/{mailQueueName}?delayed=true \
- -d '{"delayed": false}' \
- -H "Content-Type: application/json"</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>This request should have the query parameter <em>delayed</em> set to <em>true</em>, in
-order to indicate only delayed mails are affected. The payload should
-set the <code>delayed</code> field to false inorder to remove the delay. This is
-the only supported combination, and it performs a flush.</p>
-</div>
-<div class="paragraph">
-<p>The mails delayed in the given mail queue will be flushed.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Success (No content)</p>
-</li>
-<li>
-<p>400: Invalid request</p>
-</li>
-<li>
-<p>404: The mail queue does not exist</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_rabbitmq_republishing_a_mail_queue_from_cassandra"><a class="anchor" href="#_rabbitmq_republishing_a_mail_queue_from_cassandra"></a>RabbitMQ republishing a mail queue from cassandra</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST 'http://ip:port/mailQueues/{mailQueueName}?action=RepublishNotProcessedMails&olderThan=1d'</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>This method is specific to the distributed flavor of James, which relies
-on Cassandra and RabbitMQ for implementing a mail queue. In case of a
-RabbitMQ crash resulting in a loss of messages, this task can be
-launched to repopulate the <code>mailQueueName</code> queue in RabbitMQ using the
-information stored in Cassandra.</p>
-</div>
-<div class="paragraph">
-<p>The <code>olderThan</code> parameter is mandatory. It filters the mails to be
-restored, by taking into account only the mails older than the given
-value. The expected value should be expressed in the following format:
-<code>Nunit</code>. <code>N</code> should be strictly positive. <code>unit</code> could be either in the
-short form (<code>h</code>, <code>d</code>, <code>w</code>, etc.), or in the long form (<code>day</code>, <code>week</code>,
-<code>month</code>, etc.).</p>
-</div>
-<div class="paragraph">
-<p>Examples:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>5h</code></p>
-</li>
-<li>
-<p><code>7d</code></p>
-</li>
-<li>
-<p><code>1y</code></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Task created</p>
-</li>
-<li>
-<p>400: Invalid request</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The response body contains the id of the republishing task.
-<code>{ "taskId": "a650a66a-5984-431e-bdad-f1baad885856" }</code></p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_event_dead_letter"><a class="anchor" href="#_event_dead_letter"></a>Event Dead Letter</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The EventBus allows to register `group listeners' that are called in a
-distributed fashion. These group listeners enable the implementation of
-some advanced mailbox manager feature like indexing, spam reporting,
-quota management and the like.</p>
-</div>
-<div class="paragraph">
-<p>Upon exceptions, a bounded number of retries are performed (with
-exponential backoff delays). If after those retries the listener is
-still failing, then the event will be stored in the ``Event Dead
-Letter''. This API allows diagnosing issues, as well as performing event
-replay.</p>
-</div>
-<div class="sect2">
-<h3 id="_listing_mailbox_listener_groups"><a class="anchor" href="#_listing_mailbox_listener_groups"></a>Listing mailbox listener groups</h3>
-<div class="paragraph">
-<p>This endpoint allows discovering the list of mailbox listener groups.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/events/deadLetter/groups</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return a list of group names that can be further used to interact
-with the dead letter API:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>["org.apache.james.mailbox.events.EventBusTestFixture$GroupA", "org.apache.james.mailbox.events.GenericGroup-abc"]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success. A list of group names is returned.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_listing_failed_events"><a class="anchor" href="#_listing_failed_events"></a>Listing failed events</h3>
-<div class="paragraph">
-<p>This endpoint allows listing failed events for a given group:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/events/deadLetter/groups/org.apache.james.mailbox.events.EventBusTestFixture$GroupA</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return a list of insertionIds:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>["6e0dd59d-660e-4d9b-b22f-0354479f47b4", "58a8f59d-660e-4d9b-b22f-0354486322a2"]</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success. A list of insertion ids is returned.</p>
-</li>
-<li>
-<p>400: Invalid group name</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_getting_event_details"><a class="anchor" href="#_getting_event_details"></a>Getting event details</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/events/deadLetter/groups/org.apache.james.mailbox.events.EventBusTestFixture$GroupA/6e0dd59d-660e-4d9b-b22f-0354479f47b4</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the full JSON associated with this event.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success. A JSON representing this event is returned.</p>
-</li>
-<li>
-<p>400: Invalid group name or <code>insertionId</code></p>
-</li>
-<li>
-<p>404: No event with this <code>insertionId</code></p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_deleting_an_event"><a class="anchor" href="#_deleting_an_event"></a>Deleting an event</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/events/deadLetter/groups/org.apache.james.mailbox.events.EventBusTestFixture$GroupA/6e0dd59d-660e-4d9b-b22f-0354479f47b4</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will delete this event.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: Success</p>
-</li>
-<li>
-<p>400: Invalid group name or <code>insertionId</code></p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_redeliver_all_events"><a class="anchor" href="#_redeliver_all_events"></a>Redeliver all events</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/events/deadLetter?action=redeliver</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will create a task that will attempt to redeliver all events stored in
-<code>Event Dead Letter''. If successful, redelivered events will then be
-removed from </code>Dead Letter''.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: the taskId of the created task</p>
-</li>
-<li>
-<p>400: Invalid action argument</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_redeliver_group_events"><a class="anchor" href="#_redeliver_group_events"></a>Redeliver group events</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/events/deadLetter/groups/org.apache.james.mailbox.events.EventBusTestFixture$GroupA</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will create a task that will attempt to redeliver all events of a
-particular group stored in <code>Event Dead Letter''. If successful,
-redelivered events will then be removed from </code>Dead Letter''.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: the taskId of the created task</p>
-</li>
-<li>
-<p>400: Invalid group name or action argument</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_redeliver_a_single_event"><a class="anchor" href="#_redeliver_a_single_event"></a>Redeliver a single event</h3>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/events/deadLetter/groups/org.apache.james.mailbox.events.EventBusTestFixture$GroupA/6e0dd59d-660e-4d9b-b22f-0354479f47b4?action=reDeliver</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will create a task that will attempt to redeliver a single event of a
-particular group stored in <code>Event Dead Letter''. If successful,
-redelivered event will then be removed from </code>Dead Letter''.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: the taskId of the created task</p>
-</li>
-<li>
-<p>400: Invalid group name, insertion id or action argument</p>
-</li>
-<li>
-<p>404: No event with this insertionId</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_cassandra_extra_operations"><a class="anchor" href="#_cassandra_extra_operations"></a>Cassandra extra operations</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Some webadmin features to manage some extra operations on Cassandra
-tables, like solving inconsistencies on projection tables. Such
-inconsistencies can be for example created by a fail of the DAO to add a
-mapping into
-’mappings_sources`, while it was successful regarding the`rrt` table.</p>
-</div>
-<div class="sect2">
-<h3 id="_operations_on_mappings_sources"><a class="anchor" href="#_operations_on_mappings_sources"></a>Operations on mappings sources</h3>
-<div class="paragraph">
-<p>You can do a series of action on <code>mappings_sources</code> projection table :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /cassandra/mappings?action={action}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return the taskId corresponding to the related task. Actions
-supported so far are :</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>SolveInconsistencies : cleans up first all the mappings in
-<code>mappings_sources</code> index and then repopulate it correctly. In the
-meantime, listing sources of a mapping might create temporary
-inconsistencies during the process.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>For example :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST /cassandra/mappings?action=SolveInconsistencies</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes :</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: the taskId of the created task</p>
-</li>
-<li>
-<p>400: Invalid action argument for performing operation on mappings data</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_cassandra_schema_upgrades"><a class="anchor" href="#_cassandra_schema_upgrades"></a>Cassandra Schema upgrades</h3>
-<div class="paragraph">
-<p>Cassandra upgrades implies the creation of a new table. Thus restarting
-James is needed, as new tables are created on restart.</p>
-</div>
-<div class="paragraph">
-<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>
-</div>
-<div class="paragraph">
-<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>
-</div>
-<div class="paragraph">
-<p>These schema updates can be triggered by webadmin using the Cassandra
-backend.</p>
-</div>
-<div class="paragraph">
-<p>Note that currently the progress can be tracked by logs.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="#Retrieving_current_Cassandra_schema_version">Retrieving current
-Cassandra schema version</a></p>
-</li>
-<li>
-<p><a href="#Retrieving_latest_available_Cassandra_schema_version">Retrieving
-latest available Cassandra schema version</a></p>
-</li>
-<li>
-<p><a href="#Upgrading_to_a_specific_version">Upgrading to a specific version</a></p>
-</li>
-<li>
-<p><a href="#Upgrading_to_the_latest_version">Upgrading to the latest version</a></p>
-</li>
-</ul>
-</div>
-<div class="sect3">
-<h4 id="_retrieving_current_cassandra_schema_version"><a class="anchor" href="#_retrieving_current_cassandra_schema_version"></a>Retrieving current Cassandra schema version</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/cassandra/version</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"version": 2}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Where the number corresponds to the current schema version of the
-database you are using.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_retrieving_latest_available_cassandra_schema_version"><a class="anchor" href="#_retrieving_latest_available_cassandra_schema_version"></a>Retrieving latest available Cassandra schema version</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/cassandra/version/latest</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will return:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"version": 3}</pre>
-</div>
-</div>
-<div class="paragraph">
-<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>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_upgrading_to_a_specific_version"><a class="anchor" href="#_upgrading_to_a_specific_version"></a>Upgrading to a specific version</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/cassandra/version/upgrade -d '3'</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule the run of the migrations you need to reach schema version
-3.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success. The scheduled task <code>taskId</code> is returned.</p>
-</li>
-<li>
-<p>400: The version is invalid. The version should be a strictly positive
-number.</p>
-</li>
-<li>
-<p>410: Error while planning this migration. This resource is gone away.
-Reason is mentionned in the body.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Note that several calls to this endpoint will be run in a sequential
-pattern.</p>
-</div>
-<div class="paragraph">
-<p>If the server restarts during the migration, the migration is silently
-aborted.</p>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>cassandra-migration</code>
-and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"targetVersion":3}</pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_upgrading_to_the_latest_version"><a class="anchor" href="#_upgrading_to_the_latest_version"></a>Upgrading to the latest version</h4>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/cassandra/version/upgrade/latest</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will schedule the run of the migrations you need to reach the latest
-schema version.</p>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: Success. The scheduled task <code>taskId</code> is returned.</p>
-</li>
-<li>
-<p>410: Error while planning this migration. This resource is gone away.
-Reason is mentionned in the body.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Note that several calls to this endpoint will be run in a sequential
-pattern.</p>
-</div>
-<div class="paragraph">
-<p>If the server restarts during the migration, the migration is silently
-aborted.</p>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>cassandra-migration</code>
-and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"toVersion":2}</pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_correcting_ghost_mailbox"><a class="anchor" href="#_correcting_ghost_mailbox"></a>Correcting ghost mailbox</h3>
-<div class="paragraph">
-<p>This is a temporary workaround for the <strong>Ghost mailbox</strong> bug encountered
-using the Cassandra backend, as described in MAILBOX-322.</p>
-</div>
-<div class="paragraph">
-<p>You can use the mailbox merging feature in order to merge the old
-``ghosted'' mailbox with the new one.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/cassandra/mailbox/merging \
- -d '{"mergeOrigin":"{id1}", "mergeDestination":"{id2}"}' \
- -H "Content-Type: application/json"</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Will scedule a task for :</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Delete references to <code>id1</code> mailbox</p>
-</li>
-<li>
-<p>Move it’s messages into <code>id2</code> mailbox</p>
-</li>
-<li>
-<p>Union the rights of both mailboxes</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Task generation succeeded. Corresponding task id is returned.</p>
-</li>
-<li>
-<p>400: Unable to parse the body.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type <code>mailbox-merging</code> and
-the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "oldMailboxId":"5641376-02ed-47bd-bcc7-76ff6262d92a",
- "newMailboxId":"4555159-52ae-895f-ccb7-586a4412fb50",
- "totalMessageCount": 1,
- "messageMovedCount": 1,
- "messageFailedCount": 0
-}</pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_deleted_messages_vault"><a class="anchor" href="#_deleted_messages_vault"></a>Deleted Messages Vault</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The `Deleted Message Vault plugin' allows you to keep users deleted
-messages during a given retention time. This set of routes allow you to
-<em>restore</em> users deleted messages or export them in an archive.</p>
-</div>
-<div class="paragraph">
-<p>To move deleted messages in the vault, you need to specifically
-configure the DeletedMessageVault PreDeletionHook.</p>
-</div>
-<div class="sect2">
-<h3 id="_restore_deleted_messages"><a class="anchor" href="#_restore_deleted_messages"></a>Restore Deleted Messages</h3>
-<div class="paragraph">
-<p>Deleted messages of a specific user can be restored by calling the
-following endpoint:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST http://ip:port/deletedMessages/users/userToRestore@domain.ext?action=restore
-
-{
- "combinator": "and",
- "criteria": [
- {
- "fieldName": "subject",
- "operator": "containsIgnoreCase",
- "value": "Apache James"
- },
- {
- "fieldName": "deliveryDate",
- "operator": "beforeOrEquals",
- "value": "2014-10-30T14:12:00Z"
- },
- {
- "fieldName": "deletionDate",
- "operator": "afterOrEquals",
- "value": "2015-10-20T09:08:00Z"
- },
- {
- "fieldName": "recipients","
- "operator": "contains","
- "value": "recipient@james.org"
- },
- {
- "fieldName": "hasAttachment",
- "operator": "equals",
- "value": "false"
- },
- {
- "fieldName": "sender",
- "operator": "equals",
- "value": "sender@apache.org"
- },
- {
- "fieldName": "originMailboxes",
- "operator": "contains",
- "value": "02874f7c-d10e-102f-acda-0015176f7922"
- }
- ]
-};</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The requested Json body is made from a list of criterion objects which
-have the following structure:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "fieldName": "supportedFieldName",
- "operator": "supportedOperator",
- "value": "A plain string representing the matching value of the corresponding field"
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Deleted Messages which are matched with the <strong>all</strong> criterion in the query
-body will be restored. Here are a list of supported fieldName for the
-restoring:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>subject: represents for deleted message <code>subject</code> field matching.
-Supports below string operators:</p>
-<div class="ulist">
-<ul>
-<li>
-<p>contains</p>
-</li>
-<li>
-<p>containsIgnoreCase</p>
-</li>
-<li>
-<p>equals</p>
-</li>
-<li>
-<p>equalsIgnoreCase</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p>deliveryDate: represents for deleted message <code>deliveryDate</code> field
-matching. Tested value should follow the right date time with zone
-offset format (ISO-8601) like <code>2008-09-15T15:53:00+05:00</code> or
-<code>2008-09-15T15:53:00Z</code> Supports below date time operators:</p>
-<div class="ulist">
-<ul>
-<li>
-<p>beforeOrEquals: is the deleted message’s <code>deliveryDate</code> before or
-equals the time of tested value.</p>
-</li>
-<li>
-<p>afterOrEquals: is the deleted message’s <code>deliveryDate</code> after or
-equals the time of tested value</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p>deletionDate: represents for deleted message <code>deletionDate</code> field
-matching. Tested value & Supports operators: similar to <code>deliveryDate</code></p>
-</li>
-<li>
-<p>sender: represents for deleted message <code>sender</code> field matching. Tested
-value should be a valid mail address. Supports mail address operator:</p>
-<div class="ulist">
-<ul>
-<li>
-<p>equals: does the tested sender equal to the sender of the tested
-deleted message ?<br></p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p>recipients: represents for deleted message <code>recipients</code> field
-matching. Tested value should be a valid mail address. Supports list
-mail address operator:</p>
-<div class="ulist">
-<ul>
-<li>
-<p>contains: does the tested deleted message’s recipients contain tested
-recipient ?</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p>hasAttachment: represents for deleted message <code>hasAttachment</code> field
-matching. Tested value could be <code>false</code> or <code>true</code>. Supports boolean
-operator:</p>
-<div class="ulist">
-<ul>
-<li>
-<p>equals: does the tested deleted message’s hasAttachment property
-equal to the tested hasAttachment value?</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p>originMailboxes: represents for deleted message <code>originMailboxes</code>
-field matching. Tested value is a string serialized of mailbox id.
-Supports list mailbox id operators:</p>
-<div class="ulist">
-<ul>
-<li>
-<p>contains: does the tested deleted message’s originMailbox ids contain
-tested mailbox id ?</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Messages in the Deleted Messages Vault of a specified user that are
-matched with Query Json Object in the body will be appended to his
-`Restored-Messages' mailbox, which will be created if needed.</p>
-</div>
-<div class="paragraph">
-<p><strong>Note</strong>:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Query parameter <code>action</code> is required and should have the value
-<code>restore</code> to represent the restoring feature. Otherwise, a bad request
-response will be returned</p>
-</li>
-<li>
-<p>Query parameter <code>action</code> is case sensitive</p>
-</li>
-<li>
-<p>fieldName & operator passed to the routes are case sensitive</p>
-</li>
-<li>
-<p>Currently, we only support query combinator <code>and</code> value, otherwise,
-requests will be rejected</p>
-</li>
-<li>
-<p>If you only want to restore by only one criterion, the json body could
-be simplified to a single criterion:</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "fieldName": "subject",
- "operator": "containsIgnoreCase",
- "value": "Apache James"
-}</pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>For restoring all deleted messages, passing a query json with an empty
-criterion list to represent <code>matching all deleted messages</code>:</p>
-</li>
-</ul>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "combinator": "and",
- "criteria": []
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>Warning</strong>: Current web-admin uses <code>US</code> locale as the default. Therefore,
-there might be some conflicts when using String <code>containsIgnoreCase</code>
-comparators to apply on the String data of other special locales stored
-in the Vault. More details at
-<a href="https://issues.apache.org/jira/browse/MAILBOX-384">JIRA</a></p>
-</div>
-<div class="paragraph">
-<p>Response code:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Task for restoring deleted has been created</p>
-</li>
-<li>
-<p>400: Bad request:</p>
-<div class="ulist">
-<ul>
-<li>
-<p>action query param is not present</p>
-</li>
-<li>
-<p>action query param is not a valid action</p>
-</li>
-<li>
-<p>user parameter is invalid</p>
-</li>
-<li>
-<p>can not parse the JSON body</p>
-</li>
-<li>
-<p>Json query object contains unsupported operator, fieldName</p>
-</li>
-<li>
-<p>Json query object values violate parsing rules</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p>404: User not found</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type
-<code>deleted-messages-restore</code> and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "successfulRestoreCount": 47,
- "errorRestoreCount": 0,
- "user": "userToRestore@domain.ext"
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>while:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>successfulRestoreCount: number of restored messages</p>
-</li>
-<li>
-<p>errorRestoreCount: number of messages that failed to restore</p>
-</li>
-<li>
-<p>user: owner of deleted messages need to restore</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_export_deleted_messages"><a class="anchor" href="#_export_deleted_messages"></a>Export Deleted Messages</h3>
-<div class="paragraph">
-<p>Retrieve deleted messages matched with requested query from an user then
-share the content to a targeted mail address (exportTo)</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPOST 'http://ip:port/deletedMessages/users/userExportFrom@domain.ext?action=export&exportTo=userReceiving@domain.ext'
-
-BODY: is the json query has the same structure with Restore Deleted Messages section</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>Note</strong>: Json query passing into the body follows the same rules &
-restrictions like in <a href="#Restore_deleted_messages">Restore Deleted
-Messages</a></p>
-</div>
-<div class="paragraph">
-<p>Response code:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Task for exporting has been created</p>
-</li>
-<li>
-<p>400: Bad request:</p>
-<div class="ulist">
-<ul>
-<li>
-<p>exportTo query param is not present</p>
-</li>
-<li>
-<p>exportTo query param is not a valid mail address</p>
-</li>
-<li>
-<p>action query param is not present</p>
-</li>
-<li>
-<p>action query param is not a valid action</p>
-</li>
-<li>
-<p>user parameter is invalid</p>
-</li>
-<li>
-<p>can not parse the JSON body</p>
-</li>
-<li>
-<p>Json query object contains unsupported operator, fieldName</p>
-</li>
-<li>
-<p>Json query object values violate parsing rules</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p>404: User not found</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type
-<code>deleted-messages-export</code> and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "userExportFrom": "userToRestore@domain.ext",
- "exportTo": "userReceiving@domain.ext",
- "totalExportedMessages": 1432
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>while:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>userExportFrom: export deleted messages from this user</p>
-</li>
-<li>
-<p>exportTo: content of deleted messages have been shared to this mail
-address</p>
-</li>
-<li>
-<p>totalExportedMessages: number of deleted messages match with
-json query, then being shared to sharee.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_purge_deleted_messages"><a class="anchor" href="#_purge_deleted_messages"></a>Purge Deleted Messages</h3>
-<div class="paragraph">
-<p>You can overwrite `retentionPeriod' configuration in
-`deletedMessageVault' configuration file or use the default value of 1
-year.</p>
-</div>
-<div class="paragraph">
-<p>Purge all deleted messages older than the configured `retentionPeriod'</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/deletedMessages?scope=expired</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response code:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Task for purging has been created</p>
-</li>
-<li>
-<p>400: Bad request:</p>
-<div class="ulist">
-<ul>
-<li>
-<p>action query param is not present</p>
-</li>
-<li>
-<p>action query param is not a valid action</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>You may want to call this endpoint on a regular basis.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_permanently_remove_deleted_message"><a class="anchor" href="#_permanently_remove_deleted_message"></a>Permanently Remove Deleted Message</h3>
-<div class="paragraph">
-<p>Delete a Deleted Message with <code>MessageId</code></p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/deletedMessages/users/user@domain.ext/messages/3294a976-ce63-491e-bd52-1b6f465ed7a2</pre>
-</div>
-</div>
-<div class="paragraph">
-<p><a href="#_endpoints_returning_a_task">More details about endpoints returning
-a task</a>.</p>
-</div>
-<div class="paragraph">
-<p>Response code:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>201: Task for deleting message has been created</p>
-</li>
-<li>
-<p>400: Bad request:</p>
-<div class="ulist">
-<ul>
-<li>
-<p>user parameter is invalid</p>
-</li>
-<li>
-<p>messageId parameter is invalid</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p>404: User not found</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The scheduled task will have the following type
-<code>deleted-messages-delete</code> and the following <code>additionalInformation</code>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> {
- "userName": "user@domain.ext",
- "messageId": "3294a976-ce63-491e-bd52-1b6f465ed7a2"
- }</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>while: - user: delete deleted messages from this user - deleteMessageId:
-messageId of deleted messages will be delete</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_administrating_dlp_configuration"><a class="anchor" href="#_administrating_dlp_configuration"></a>Administrating DLP Configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>DLP (stands for Data Leak Prevention) is supported by James. A DLP
-matcher will, on incoming emails, execute regular expressions on email
-sender, recipients or content, in order to report suspicious emails to
-an administrator. WebAdmin can be used to manage these DLP rules on a
-per <code>senderDomain</code> basis.</p>
-</div>
-<div class="paragraph">
-<p><code>senderDomain</code> is domain of the sender of incoming emails, for example:
-<code>apache.org</code>, <code>james.org</code>,… Each <code>senderDomain</code> correspond to a distinct
-DLP configuration.</p>
-</div>
-<div class="sect2">
-<h3 id="_list_dlp_configuration_by_sender_domain"><a class="anchor" href="#_list_dlp_configuration_by_sender_domain"></a>List DLP configuration by sender domain</h3>
-<div class="paragraph">
-<p>Retrieve a DLP configuration for corresponding <code>senderDomain</code>, a
-configuration contains list of configuration items</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/dlp/rules/{senderDomain}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: A list of dlp configuration items is returned</p>
-</li>
-<li>
-<p>400: Invalid <code>senderDomain</code> or payload in request</p>
-</li>
-<li>
-<p>404: The domain does not exist.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This is an example of returned body. The rules field is a list of rules
-as described below.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"rules : [
- {
- "id": "1",
- "expression": "james.org",
- "explanation": "Find senders or recipients containing james[any char]org",
- "targetsSender": true,
- "targetsRecipients": true,
- "targetsContent": false
- },
- {
- "id": "2",
- "expression": "Find senders containing apache[any char]org",
- "explanation": "apache.org",
- "targetsSender": true,
- "targetsRecipients": false,
- "targetsContent": false
- }
-]}</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_store_dlp_configuration_by_sender_domain"><a class="anchor" href="#_store_dlp_configuration_by_sender_domain"></a>Store DLP configuration by sender domain</h3>
-<div class="paragraph">
-<p>Store a DLP configuration for corresponding <code>senderDomain</code>, if any item
-of DLP configuration in the request is stored before, it will not be
-stored anymore</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XPUT http://ip:port/dlp/rules/{senderDomain}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The body can contain a list of DLP configuration items formed by those
-fields: - <code>id</code>(String) is mandatory, unique identifier of the
-configuration item - <code>expression</code>(String) is mandatory, regular
-expression to match contents of targets - <code>explanation</code>(String) is
-optional, description of the configuration item -
-<code>targetsSender</code>(boolean) is optional and defaults to false. If true,
-<code>expression</code> will be applied to Sender and to From headers of the mail -
-<code>targetsContent</code>(boolean) is optional and defaults to false. If true,
-<code>expression</code> will be applied to Subject headers and textual bodies
-(text/plain and text/html) of the mail - <code>targetsRecipients</code>(boolean) is
-optional and defaults to false. If true, <code>expression</code> will be applied to
-recipients of the mail</p>
-</div>
-<div class="paragraph">
-<p>This is an example of returned body. The rules field is a list of rules
-as described below.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{"rules": [
- {
- "id": "1",
- "expression": "james.org",
- "explanation": "Find senders or recipients containing james[any char]org",
- "targetsSender": true,
- "targetsRecipients": true,
- "targetsContent": false
- },
- {
- "id": "2",
- "expression": "Find senders containing apache[any char]org",
- "explanation": "apache.org",
- "targetsSender": true,
- "targetsRecipients": false,
- "targetsContent": false
- }
-]}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: List of dlp configuration items is stored</p>
-</li>
-<li>
-<p>400: Invalid <code>senderDomain</code> or payload in request</p>
-</li>
-<li>
-<p>404: The domain does not exist.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_remove_dlp_configuration_by_sender_domain"><a class="anchor" href="#_remove_dlp_configuration_by_sender_domain"></a>Remove DLP configuration by sender domain</h3>
-<div class="paragraph">
-<p>Remove a DLP configuration for corresponding <code>senderDomain</code></p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XDELETE http://ip:port/dlp/rules/{senderDomain}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>204: DLP configuration is removed</p>
-</li>
-<li>
-<p>400: Invalid <code>senderDomain</code> or payload in request</p>
-</li>
-<li>
-<p>404: The domain does not exist.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_fetch_a_dlp_configuration_item_by_sender_domain_and_rule_id"><a class="anchor" href="#_fetch_a_dlp_configuration_item_by_sender_domain_and_rule_id"></a>Fetch a DLP configuration item by sender domain and rule id</h3>
-<div class="paragraph">
-<p>Retrieve a DLP configuration rule for corresponding <code>senderDomain</code> and a
-<code>ruleId</code></p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>curl -XGET http://ip:port/dlp/rules/{senderDomain}/rules/{ruleId}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Response codes:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>200: A dlp configuration item is returned</p>
-</li>
-<li>
-<p>400: Invalid <code>senderDomain</code> or payload in request</p>
-</li>
-<li>
-<p>404: The domain and/or the rule does not exist.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>This is an example of returned body.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>{
- "id": "1",
- "expression": "james.org",
- "explanation": "Find senders or recipients containing james[any char]org",
- "targetsSender": true,
- "targetsRecipients": true,
- "targetsContent": false
-}</pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../../_/js/site.js" data-ui-root-path="../../../../../_"></script>
-<script async src="../../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/run-docker.html b/james-project/3.6.0/servers/distributed/run-docker.html
deleted file mode 100644
index 724937f..0000000
--- a/james-project/3.6.0/servers/distributed/run-docker.html
+++ /dev/null
@@ -1,755 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Run with docker :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run.html">Run</a>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../index.html">Apache James Server</a></li>
- <li><a href="../index.html">Servers</a></li>
- <li><a href="../distributed.html">Distributed</a></li>
- <li><a href="run-docker.html">Run with docker</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="run-docker.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/run-docker.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Run with docker</h1>
-<div class="sect1">
-<h2 id="_running_via_docker_compose"><a class="anchor" href="#_running_via_docker_compose"></a>Running via docker-compose</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Requirements: docker & docker-compose installed.</p>
-</div>
-<div class="paragraph">
-<p>When you try James this way, you will use the most current state of James.
-It will be configured to run with Cassandra & ElasticSearch.
-All those three components will be started with a single command.</p>
-</div>
-<div class="paragraph">
-<p>You can retrieve the docker-compose file :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ wget https://raw.githubusercontent.com/apache/james-project/master/dockerfiles/run/docker-compose.yml</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Then, you just have to start the services:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ docker-compose up</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Wait a few seconds in order to have all those services start up. You will see the following log when James is available:
-james | Started : true</p>
-</div>
-<div class="paragraph">
-<p>A default domain, james.local, has been created. You can see this by running:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ docker exec james java -jar /root/james-cli.jar -h 127.0.0.1 -p 9999 listdomains</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>James will respond to IMAP port 143 and SMTP port 25.
-You have to create users before playing with james. You may also want to create other domains.
-Follow the 'Useful commands' section for more information about James CLI.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_run_with_docker"><a class="anchor" href="#_run_with_docker"></a>Run with docker</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_requirements"><a class="anchor" href="#_requirements"></a>Requirements</h3>
-<div class="paragraph">
-<p>Built artifacts should be in ./dockerfiles/run/guice/cassandra-rabbitmq/destination folder for cassandra.
-If you haven’t already:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> $ docker build -t james/project dockerfiles/compilation/java-11
- $ docker run -v $HOME/.m2:/root/.m2 -v $PWD:/origin \
--v $PWD/dockerfiles/run/guice/cassandra-rabbitmq/destination:/cassandra-rabbitmq/destination \
--t james/project -s HEAD</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_running"><a class="anchor" href="#_running"></a>Running</h3>
-<div class="paragraph">
-<p>You need a running <strong>cassandra</strong> in docker. To achieve this run:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ docker run -d --name=cassandra cassandra:3.11.10</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You need a running <strong>rabbitmq</strong> in docker. To achieve this run:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ docker run -d --name=rabbitmq rabbitmq:3.8.1-management</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You need a running <strong>Zenko Cloudserver</strong> objectstorage in docker. To achieve this run:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ docker run -d --env 'REMOTE_MANAGEMENT_DISABLE=1' --env 'SCALITY_ACCESS_KEY_ID=accessKey1' --env 'SCALITY_SECRET_ACCESS_KEY=secretKey1' --name=s3 zenko/cloudserver:8.2.6</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You need a running <strong>ElasticSearch</strong> in docker. To achieve this run:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ docker run -d --name=elasticsearch --env 'discovery.type=single-node' docker.elastic.co/elasticsearch/elasticsearch:7.10.2</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If you want to use all the JMAP search capabilities, you may also need to start Tika:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ docker run -d --name=tika apache/tika:1.24</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can find more explanation on the need of Tika in this page <a href="http://james.apache.org/server/config-elasticsearch.html" class="bare">http://james.apache.org/server/config-elasticsearch.html</a></p>
-</div>
-<div class="paragraph">
-<p>We need to provide the key we will use for TLS. For obvious reasons, this is not provided in this git.</p>
-</div>
-<div class="paragraph">
-<p>Copy your TLS keys to <code>run/guice/cassandra-rabbitmq/destination/conf/keystore</code> or generate it using the following command. The password must be <code>james72laBalle</code> to match default configuration.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ keytool -genkey -alias james -keyalg RSA -keystore dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/keystore</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Then we need to build james container :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ docker build -t james_run dockerfiles/run/guice/cassandra-rabbitmq</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>To run this container :</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre> $ docker run --hostname HOSTNAME -p "25:25" -p 80:80 -p "110:110" -p "143:143" -p "465:465" -p "587:587" -p "993:993" -p "127.0.0.1:8000:8000" --link cassandra:cassandra --link rabbitmq:rabbitmq
---link elasticsearch:elasticsearch --link tika:tika --link s3:s3.docker.test --name james_run -t james_run</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Where :</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>HOSTNAME: is the hostname you want to give to your James container. This DNS entry will be used to send mail to your James server.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Webadmin port binding is restricted to loopback as users are not authenticated by default on webadmin server. Thus you should avoid exposing it in production.
-Note that the above example assumes <code>127.0.0.1</code> is your loopback interface for convenience but you should change it if this is not the case on your machine.</p>
-</div>
-<div class="paragraph">
-<p>If you want to pass additional options to the underlying java command, you can configure a <em>JVM_OPTIONS</em> env variable, for example add:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>--env JVM_OPTIONS="-Xms256m -Xmx2048m"</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>To have log file accessible on a volume, add <strong>-v $PWD/logs:/logs</strong> option to the above command line, where <strong>$PWD/logs</strong> is your local directory to put files in.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_instrumentation"><a class="anchor" href="#_instrumentation"></a>Instrumentation</h3>
-<div class="paragraph">
-<p>You can use Glowroot to instrumentalize James. The provided guice docker files allow a simple way to do it.
-In order to activate Glowroot you need to run the container with the environment variable <em>GLOWROOT_ACTIVATED</em> set to <em>true</em>
-and to expose the glowroot instrumentation ui port.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>--env GLOWROOT_ACTIVATED=true -p "4000:4000"</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>By default, the Glowroot UI is accessible from every machines in the network as defined in the <em>destination/admin.json</em>.
-Which you could configure before building the image, if you want to restrict its accessibility to localhost for example.
-See the <a href="https://github.com/glowroot/glowroot/wiki/Agent-Installation-(with-Embedded-Collector)#user-content-optional-post-installation-steps">Glowroot post installation steps</a> for more details.</p>
-</div>
-<div class="paragraph">
-<p>Or by mapping the 4000 port to the IP of the desired network interface, for example <code>-p 127.0.0.1:4000:4000</code>.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_handling_attachment_indexing"><a class="anchor" href="#_handling_attachment_indexing"></a>Handling attachment indexing</h3>
-<div class="paragraph">
-<p>You can handle attachment text extraction before indexing in ElasticSearch. This makes attachments searchable. To enable this:</p>
-</div>
-<div class="paragraph">
-<p>Run tika:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ docker run --name tika apache/tika:1.24</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Add a link for the tika container in the above command line:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>$ docker run --hostname HOSTNAME -p "25:25" -p 80:80 -p "110:110" -p "143:143" -p "465:465" -p "587:587" -p "993:993" --link cassandra:cassandra --link rabbitmq:rabbitmq
---link elasticsearch:elasticsearch --link tika:tika --name james_run -t james_run</pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../_/js/site.js" data-ui-root-path="../../../../_"></script>
-<script async src="../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/distributed/run.html b/james-project/3.6.0/servers/distributed/run.html
deleted file mode 100644
index 79b0d55..0000000
--- a/james-project/3.6.0/servers/distributed/run.html
+++ /dev/null
@@ -1,712 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Distributed James Server — Run :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item is-current-page" data-depth="3">
- <a class="nav-link" href="run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../../index.html">Apache James Server</a></li>
- <li><a href="../index.html">Servers</a></li>
- <li><a href="../distributed.html">Distributed</a></li>
- <li><a href="run.html">Run</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version is-missing" href="../../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="run.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/distributed/run.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Distributed James Server — Run</h1>
-<div class="sect1">
-<h2 id="_building"><a class="anchor" href="#_building"></a>Building</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_requirements"><a class="anchor" href="#_requirements"></a>Requirements</h3>
-<div class="ulist">
-<ul>
-<li>
-<p>Java 11 SDK</p>
-</li>
-<li>
-<p>Docker ∕ ElasticSearch 7.10.2, RabbitMQ Management 3.3.7, S3 compatible
-ObjectStorage and Cassandra 3.11.10</p>
-</li>
-<li>
-<p>Maven 3</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_building_the_artifacts"><a class="anchor" href="#_building_the_artifacts"></a>Building the artifacts</h3>
-<div class="paragraph">
-<p>An usual compilation using maven will produce two artifacts into
-server/container/guice/cassandra-rabbitmq-guice/target directory:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>james-server-cassandra-rabbitmq-guice.jar</p>
-</li>
-<li>
-<p>james-server-cassandra-rabbitmq-guice.lib</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>You can for example run in the base of
-<a href="https://github.com/apache/james-project">this git repository</a>:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>mvn clean install</pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_running"><a class="anchor" href="#_running"></a>Running</h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_requirements_2"><a class="anchor" href="#_requirements_2"></a>Requirements</h3>
-<div class="ulist">
-<ul>
-<li>
-<p>Cassandra 3.11.10</p>
-</li>
-<li>
-<p>ElasticSearch 7.10.2</p>
-</li>
-<li>
-<p>RabbitMQ-Management 3.8.1</p>
-</li>
-<li>
-<p>Swift ObjectStorage 2.15.1 or Zenko Cloudserver or AWS S3</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_james_launch"><a class="anchor" href="#_james_launch"></a>James Launch</h3>
-<div class="paragraph">
-<p>To run james, you have to create a directory containing required
-configuration files.</p>
-</div>
-<div class="paragraph">
-<p>James requires the configuration to be in a subfolder of working
-directory that is called <strong>conf</strong>. You can get a sample directory for
-configuration from
-<a href="https://github.com/apache/james-project/tree/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf">dockerfiles/run/guice/cassandra-rabbitmq/destination/conf</a>.
-You might need to adapt it to your needs.</p>
-</div>
-<div class="paragraph">
-<p>You also need to generate a keystore in your conf folder with the
-following command:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ keytool -genkey -alias james -keyalg RSA -keystore conf/keystore</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You need to have a Cassandra, ElasticSearch, S3 and RabbitMQ instance
-running. You can either install the servers or launch them via docker:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ docker run -d -p 9042:9042 --name=cassandra cassandra:3.11.10
-$ docker run -d -p 9200:9200 --name=elasticsearch --env 'discovery.type=single-node' docker.elastic.co/elasticsearch/elasticsearch:7.10.2
-$ docker run -d -p 5672:5672 -p 15672:15672 --name=rabbitmq rabbitmq:3.8.1-management
-$ docker run -d --env 'REMOTE_MANAGEMENT_DISABLE=1' --env 'SCALITY_ACCESS_KEY_ID=accessKey1' --env 'SCALITY_SECRET_ACCESS_KEY=secretKey1' --name=s3 zenko/cloudserver:8.2.6</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Once everything is set up, you just have to run the jar with:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ java -Dworking.directory=. -jar target/james-server-cassandra-rabbitmq-guice.jar</code></pre>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_using_aws_s3_of_zenko_cloudserver"><a class="anchor" href="#_using_aws_s3_of_zenko_cloudserver"></a>Using AWS S3 of Zenko Cloudserver</h4>
-<div class="paragraph">
-<p>By default, James is configured with [Zenko Cloudserver](<a href="https://hub.docker.com/r/zenko/cloudserver" class="bare">https://hub.docker.com/r/zenko/cloudserver</a>) which is compatible with AWS S3, in <code>blobstore.propeties</code> as such:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">implementation=s3
-objectstorage.namespace=james
-objectstorage.s3.endPoint=http://s3.docker.test:8000/
-objectstorage.s3.region=eu-west-1
-objectstorage.s3.accessKeyId=accessKey1
-objectstorage.s3.secretKey=secretKey1</code></pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_guice_cassandra_rabbitmq_ldap"><a class="anchor" href="#_guice_cassandra_rabbitmq_ldap"></a>Guice-cassandra-rabbitmq-ldap</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>You can follow the same guide to build and run
-guice-cassandra-rabbitmq-s3-ldap artifact, except that:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>The <strong>jar</strong> and <strong>libs</strong> needs to be retrieve from
-server/container/guice/cassandra-rabbitmq-ldap-guice/target after
-compilation</p>
-</li>
-<li>
-<p>The sample configuration can be found in
-<a href="https://github.com/apache/james-project/tree/master/dockerfiles/run/guice/cassandra-rabbitmq-ldap/destination/conf">dockerfiles/run/guice/cassandra-rabbitmq-ldap/destination/conf</a></p>
-</li>
-<li>
-<p>You need to configure James to be connecting to a running LDAP server.
-The configuration file is located in
-<a href="https://github.com/apache/james-project/tree/master/dockerfiles/run/guice/cassandra-rabbitmq-ldap/destination/conf/usersrepository.xml">dockerfiles/run/guice/cassandra-rabbitmq-ldap/destination/conf/usersrepository.xml</a></p>
-</li>
-<li>
-<p>You can then launch James via this command:</p>
-</li>
-</ul>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ java -Dworking.directory=. -jar target/james-server-cassandra-rabbitmq-ldap-guice.jar</code></pre>
-</div>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../../_/js/site.js" data-ui-root-path="../../../../_"></script>
-<script async src="../../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/extendable.html b/james-project/3.6.0/servers/extendable.html
deleted file mode 100644
index 882a89f..0000000
--- a/james-project/3.6.0/servers/extendable.html
+++ /dev/null
@@ -1,548 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>James Extendable Mail Server :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item is-current-page" data-depth="2">
- <a class="nav-link" href="extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Server</a></li>
- <li><a href="index.html">Servers</a></li>
- <li><a href="extendable.html">Extendable</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../3.8.1/servers/extendable.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="extendable.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/extendable.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">James Extendable Mail Server</h1>
-<div class="paragraph">
-<p>(TODO)</p>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/index.html b/james-project/3.6.0/servers/index.html
deleted file mode 100644
index bd02fb3..0000000
--- a/james-project/3.6.0/servers/index.html
+++ /dev/null
@@ -1,667 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Apache James Mail Servers :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Server</a></li>
- <li><a href="index.html">Servers</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../3.8.1/servers/index.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="index.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/index.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Apache James Mail Servers</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>James offers five types of ready-made Mail Servers. The servers are intended
-for those with different needs, ranging from <a href="../concepts/user/index.html#Operators" class="xref page">Operators</a>
-who are interested in setting up a server for the first time, to experienced teams of
-<a href="../concepts/user/index.html#Developer" class="xref page">Developers</a>
-looking to deploy an advanced distributed system.
-Each of the servers has been tested and verified so you can
-deploy a production-grade
-<a href="#concepts/insert-link">Mail Server</a> with confidence.</p>
-</div>
-<div class="paragraph">
-<p>The available James Servers are:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="#demo">James Demo Mail Server</a></p>
-</li>
-<li>
-<p><a href="#basic">James Basic Mail Server</a></p>
-</li>
-<li>
-<p><a href="#extendable">James Extendable Mail Server</a></p>
-</li>
-<li>
-<p><a href="#distributed">James Distributed Mail Server</a></p>
-</li>
-<li>
-<p><a href="#test">James Test Server</a></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>If you are just checking out James for the first time, then we highly recommend
-investigating the servers in this order:</p>
-</div>
-<div class="olist arabic">
-<ol class="arabic">
-<li>
-<p>Initiate yourself with James by using the <a href="#demo">Demo Server</a></p>
-</li>
-<li>
-<p>Install the <a href="#basic">Basic Server</a></p>
-</li>
-<li>
-<p>If and only if the Basic Server is not enough, then try the <a href="#extendable">Extendable Server</a></p>
-</li>
-</ol>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="demo"><a class="anchor" href="#demo"></a>James Demo Server</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The <a href="demo.html" class="xref page">Demo Server</a> is intended for those who just want
-to give James a quick spin on their local machine to see what all
-the fuss is about.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="basic"><a class="anchor" href="#basic"></a>James Basic Mail Server</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>If you just want to get up and running quickly, if you have very simple needs,
-or you want to try deploying a mail server for the first time, then the
-<a href="basic/index.html" class="xref page"><strong>Basic Server</strong></a> is the right choice for you. If you are
-not sure which server you should be using, then this server is probably the right
-choice.</p>
-</div>
-<div class="paragraph">
-<p>This server is intended to be the simplest to set up and use in production.
-It has the least amount of complexity and configurations to worry about.
-The last thing you need is
-to have to resolve difficult issues on a production server when you have not
-yet acquired the requisite knowledge to deal with those issues. Using the
-<a href="basic/index.html" class="xref page"><strong>Basic Server</strong></a> will help you reduce the risk of running into
-production issues.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="extendable"><a class="anchor" href="#extendable"></a>James Extendable Mail Server</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>When your requirements start to get a little more serious, or you
-start to feel adventurous and want to begin your own email adventure,
-you can consider using the <a href="extendable.html" class="xref page"><strong>Extendable Server</strong></a>.</p>
-</div>
-<div class="paragraph">
-<p>This server is intended for experts who understand the consequences of
-what they are doing. It provides extension mechanisms, configurations,
-and integration points to customize its behavior. Unless you are processing
-millions of emails on a daily basis (in which case you should consider the
-<a href="#distributed">Distributed Server</a>), this server should cover just about
-any email needs you may have.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="distributed"><a class="anchor" href="#distributed"></a>James Distributed Mail Server</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The <a href="distributed.html" class="xref page"><strong>Distributed Server</strong></a> is a heavy-duty industrial
-enterprise mail server.</p>
-</div>
-<div class="paragraph">
-<p>This is the most feature-rich server, but also by far the most complex,
-and is intended for experts only.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="test"><a class="anchor" href="#test"></a>James Test Server</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The <a href="test.html" class="xref page"><strong>Test Server</strong></a> is, as the name suggests, for testing purposes.</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/run.html b/james-project/3.6.0/servers/run.html
deleted file mode 100644
index 837f76e..0000000
--- a/james-project/3.6.0/servers/run.html
+++ /dev/null
@@ -1,704 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Run James in Production :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Server</a></li>
- <li><a href="run.html">Run James in Production</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../3.8.1/servers/run.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="run.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/run.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">Run James in Production</h1>
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>James provides a number of <strong>profiles</strong> out of the box.
-These profiles have been tested and verified so you can
-get set up quickly with a production mail server that you
-can use with confidence.</p>
-</div>
-<div class="paragraph">
-<p>The available profiles are:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="#minimal">James Minimal Profile</a></p>
-</li>
-<li>
-<p><a href="#basic">James Basic Profile</a></p>
-</li>
-<li>
-<p><a href="#advanced">James Advanced Profile</a></p>
-</li>
-<li>
-<p><a href="#distributed">James Distributed Profile</a></p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="minimal"><a class="anchor" href="#minimal"></a>James Minimal Profile</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>If you are not sure which profile you should be using, then
-you probably ought to be using the <strong>James Minimal Profile</strong>.</p>
-</div>
-<div class="paragraph">
-<p>This profile is intended to be the simplest to set up and use in production.
-It has the least amount of dependencies and complexities. If you do not yet
-have a huge amount of emails to process, then usually the simplicity is
-well worth the loss of some functionality. The last thing you need is
-to have to resolve difficult issues on a production server when you have not
-yet acquired the requisite knowledge to deal with those issues. Using the
-<strong>James Minimal Profile</strong> will help you reduce the risk of running into
-production issues.</p>
-</div>
-<div class="paragraph">
-<p>This profile is:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Suggested for use with smaller deployments</p>
-</li>
-<li>
-<p>Appropriate for use by most operators</p>
-</li>
-<li>
-<p>The preferred choice for most installations</p>
-</li>
-<li>
-<p>Endowed with fewer dependencies, which makes it simpler and less risky to use in production</p>
-</li>
-<li>
-<p>Only dependent on your local file system for data storage, so very easy to manage</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>(TODO: Add link to details page)</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="basic"><a class="anchor" href="#basic"></a>James Basic Profile</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>This profile is intended to be relatively easy to use, but provides additional features with regards
-to data storage and management. Of course, these additional features come at the cost of more
-operational complexity. You will have to now deal with a relational database and all the fun
-that comes with it. However, if you are already an expert at relational database management,
-then this profile should be a natural choice for you.</p>
-</div>
-<div class="paragraph">
-<p>This profile is:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Suggested for smaller deployments that require data persisted in a relational database</p>
-</li>
-<li>
-<p>Appropriate for most operators provided that you understand relational databases and data indexing</p>
-</li>
-<li>
-<p>Less complex than most profiles, but also less performant</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>(TODO: Add link to details page)</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="advanced"><a class="anchor" href="#advanced"></a>James Advanced Profile</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>When your requirements start to get a little more serious
-(let’s say in the tens of millions of emails), then you may want to
-start to consider using the <strong>James Advanced Profile</strong>.</p>
-</div>
-<div class="paragraph">
-<p>This profile is:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Intended for use by experienced operators only</p>
-</li>
-<li>
-<p>Used for mid-sized to large deployments</p>
-</li>
-<li>
-<p>More performant than the Minimal and Basic Profiles, but also more complex</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>(TODO: Add link to details page)</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="distributed"><a class="anchor" href="#distributed"></a>James Distributed Profile</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The <strong>James Distributed Profile</strong> is a heavy-duty industrial enterprise mail server.</p>
-</div>
-<div class="paragraph">
-<p>This profile is:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Intended for use by experts only</p>
-</li>
-<li>
-<p>Use for large-scale distributed deployments</p>
-</li>
-<li>
-<p>The most feature-rich profile, but also by far the most complex</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>(TODO: Add link to details page)</p>
-</div>
-</div>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.6.0/servers/test.html b/james-project/3.6.0/servers/test.html
deleted file mode 100644
index 1cc93c0..0000000
--- a/james-project/3.6.0/servers/test.html
+++ /dev/null
@@ -1,548 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>James Test Server :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
- <link rel="stylesheet" href="../../../_/css/site.css">
- </head>
- <body class="article">
-<header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://james.apache.org"><img src="/_/img/james.svg" alt="james logo"> Apache James</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <div class="navbar-item"><strong>James server</strong></div>
- <a class="navbar-item" href="https://github.com/apache/james-project">Repository</a>
- <a class="navbar-item" href="https://issues.apache.org/jira/projects/JAMES/issues">Issue Tracker</a>
- <hr class="navbar-divider">
- <a class="navbar-item" href="https://james.apache.org/mime4j/index.html">Mime4J</a>
- <a class="navbar-item" href="https://james.apache.org/jsieve/index.html">jSieve</a>
- <a class="navbar-item" href="https://james.apache.org/jspf/index.html">jSPF</a>
- <a class="navbar-item" href="https://james.apache.org/jdkim/index.html">jDKIM</a>
- <a class="navbar-item" href="https://james.apache.org/hupa/index.html">HUPA</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Community</a>
- <div class="navbar-dropdown">
- <!-- Not ideal but dropping the version in the href requires tweaking james-projet docs module first -->
- <a class="navbar-item" href="/james-project/3.6.0/community/mailing-lists.html">Mailing lists</a>
- <a class="navbar-item" href="https://gitter.im/apache/james-project"><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a>
- <a class="navbar-item" href="https://twitter.com/ApacheJames">
- <span class="icon">
- <svg aria-hidden="true" data-icon="twitter" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
- <path fill="#57aaee" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path>
- </svg>
- </span> Twitter
- </a>
- <a class="navbar-item" href="#"> <svg class="octicon octicon-mark-github v-align-middle" viewBox="0 0 16 16" version="1.1" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> Github</a>
- </div>
- </div>
-<!-- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div> -->
- </div>
- </div>
- </nav>
-</header>
-<div class="body">
-<div class="nav-container" data-component="james-project" data-version="3.6.0">
- <aside class="nav">
- <div class="panels">
-<div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="../index.html">Apache James Server</a></h3>
-<ul class="nav-list">
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/index.html">Concepts</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/user/index.html">User Model</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/mail/index.html">Emails</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="#mail/messages/index.adoc">mail/messages/index.adoc</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/imf.adoc">mail/messages/imf.adoc</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="#mail/messages/mime.adoc">mail/messages/mime.adoc</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/protocols/index.html">Protocols</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/smtp.html">SMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/pop.html">POP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/imap.html">IMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/jmap.html">JMAP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/esmtp.html">ESMTP</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/protocols/lmtp.html">LMTP</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../concepts/storage/index.html">Storage</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/storage/mailbox.html">Mailboxes</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../concepts/storage/users.html">Users</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/processing/index.html">Processing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/configuration.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../concepts/glossary.html">Glossary</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Servers</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="demo.html">Demo</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="5-minute-demo.html">Short Demo</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="15-minute-demo.html">Long Demo</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="basic/index.html">Basic</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/context.html">Context</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/objectives.html">Objectives</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/concepts.html">Concepts</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/conf/index.html">Configuration</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="basic/help.html">Help</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="extendable.html">Extendable</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed.html">Distributed</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="distributed/objectives.html">Objectives and motivation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed/architecture/index.html">Architecture</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/architecture/consistency-model.html">Consistency Model</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/architecture/specialized-instances.html">Specialized instances</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="distributed/run.html">Run</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="distributed/run-docker.html">Run with docker</a>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed/configure/index.html">Configuration</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Protocols</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/imap.html">imapserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/jmap.html">jmap.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/jmx.html">jmx.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/smtp.html">smtpserver.xml & lmtpserver.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/smtp-hooks.html">Packaged SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/pop3.html">pop3server.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/webadmin.html">webadmin.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/ssl.html">SSL & TLS</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Storage dependencies</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/blobstore.html">blobstore.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/cassandra.html">cassandra.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/elasticsearch.html">elasticsearch.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/rabbitmq.html">rabbitmq.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/tika.html">tika.properties</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Core components</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/batchsizes.html">batchsizes.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/dns.html">dnsservice.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/domainlist.html">domainlist.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/healthcheck.html">healthcheck.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/mailetcontainer.html">mailetcontainer.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/mailets.html">Packaged Mailets</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/matchers.html">Packaged Matchers</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/mailrepositorystore.html">mailrepositorystore.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/recipientrewritetable.html">recipientrewritetable.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/usersrepository.html">usersrepository.xml</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="4">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Extensions</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/vault.html">deletedMessageVault.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/extensions.html">extensions.properties</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/listeners.html">listeners.xml</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/spam.html">Anti-Spam setup</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/remote-delivery-error-handling.html">About RemoteDelivery error handling</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/collecting-contacts.html">Contact collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/collecting-events.html">Event collection</a>
- </li>
- <li class="nav-item" data-depth="5">
- <a class="nav-link" href="distributed/configure/dsn.html">ESMTP DSN support</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed/operate/index.html">Operate</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/guide.html">Operator guide</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/logging.html">Logging</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/webadmin.html">WebAdmin REST administration API</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/metrics.html">Metrics</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/migrating.html">Migrating existing data</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/cli.html">Command Line Interface</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/operate/cassandra-migration.html">Cassandra migration</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="distributed/extending/index.html">Extending server behavior</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/extending/mail-processing.html">Custom mail processing components</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/extending/mailbox-listeners.html">Custom Mailbox Listeners</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/extending/smtp-hooks.html">Custom SMTP hooks</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="distributed/extending/webadmin-routes.html">Custom WebAdmin routes</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item is-current-page" data-depth="2">
- <a class="nav-link" href="test.html">Test</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../customization/index.html">Customization</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development/index.html">Developer Guide</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../community/index.html">Community</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/mailing-lists.html">Mailing lists</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/contributing.html">Contributing</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/guidelines.html">Guidelines</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/download.html">Download releases</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/website.html">Building and publishing the website</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/release.html">Creating an official Apache James release</a>
- </li>
- <li class="nav-item" data-depth="2">
- <a class="nav-link" href="../community/support.html">Professional support</a>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Apache Software Foundation</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/">ASF</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/getinvolved.html">Get involved</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/faq.html">FAQ</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/licenses/">Licenses</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/security/">Security</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="https://www.apache.org/foundation/thanks.html">Thanks</a>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </li>
-</ul>
- </nav>
-</div>
-<div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Apache James Server</span>
- <span class="version">3.6.0 Snapshot</span>
- </div>
- <ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component is-current">
- <div class="title"><a href="../../3.8.1/index.html">Apache James Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- <li class="version is-current">
- <a href="../index.html">3.6.0 Snapshot</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <div class="title"><a href="../../../james-site/latest/index.html">Apache James Site</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-site/latest/index.html">latest</a>
- </li>
- </ul>
- </li>
- </ul>
-</div>
- </div>
- </aside>
-</div>
-<main class="article">
-<div class="toolbar" role="navigation">
-<button class="nav-toggle"></button>
- <a href="../../../james-site/latest/homepage.html" class="home-link"></a>
-<nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../index.html">Apache James Server</a></li>
- <li><a href="index.html">Servers</a></li>
- <li><a href="test.html">Test</a></li>
- </ul>
-</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.6.0 Snapshot</button>
- <div class="version-menu">
- <a class="version" href="../../3.8.1/servers/test.html">3.8.1 SNAPSHOT</a>
- <a class="version is-current" href="test.html">3.6.0 Snapshot</a>
- </div>
-</div>
-<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/james-project-3.6.0/docs/modules/servers/pages/test.adoc">Edit this Page</a></div>
-</div>
- <div class="content">
-<aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
-</aside>
-<article class="doc">
-<h1 class="page">James Test Server</h1>
-<div class="paragraph">
-<p>(TODO)</p>
-</div>
-</article>
- </div>
-</main>
-</div>
-<footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
-</footer>
-<script id="site-script" src="../../../_/js/site.js" data-ui-root-path="../../../_"></script>
-<script async src="../../../_/js/vendor/highlight.js"></script>
- </body>
-</html>
\ No newline at end of file
diff --git a/james-project/3.8.0/community/contributing.html b/james-project/3.8.0/community/contributing.html
index 4308f63..43b817e 100644
--- a/james-project/3.8.0/community/contributing.html
+++ b/james-project/3.8.0/community/contributing.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Contributing :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -327,13 +316,6 @@
<li><a href="contributing.html">Contributing</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="contributing.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/community/contributing.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/community/pages/contributing.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -348,7 +330,7 @@
<p>This document defines the different ways available for contributing to the Apache James project.</p>
</div>
<div class="paragraph">
-<p>To keep you informed on James issues, subscribe to the relevant <a href="mailing-lists.html" class="xref page">mailing lists</a>.</p>
+<p>To keep you informed on James issues, subscribe to the relevant <a href="mailing-lists.html" class="page">mailing lists</a>.</p>
</div>
</div>
</div>
@@ -360,7 +342,7 @@
</div>
<div class="paragraph">
<p>Share your experiences with James, your needs, your enhancements proposition via the
-<a href="mailing-lists.html" class="xref page">mailing lists</a>, on <a href="https://gitter.im/apache/james-project">Gitter</a>, or on our
+<a href="mailing-lists.html" class="page">mailing lists</a>, on <a href="https://gitter.im/apache/james-project">Gitter</a>, or on our
<a href="https://issues.apache.org/jira/projects/JAMES/issues">Bug Tracker</a>.</p>
</div>
<div class="paragraph">
@@ -460,7 +442,7 @@
<div class="sectionbody">
<div class="paragraph">
<p>People can submit ideas, features or design changes proposals by discussing it through the
-<a href="mailing-lists.html" class="xref page">mailing lists</a>.</p>
+<a href="mailing-lists.html" class="page">mailing lists</a>.</p>
</div>
<div class="paragraph">
<p>Structuring design changes are tracked by <a href="https://github.com/joelparkerhenderson/architecture-decision-record">ADRs</a>
@@ -490,7 +472,7 @@
<h2 id="_how_to_contribute_some_code"><a class="anchor" href="#_how_to_contribute_some_code"></a>How to contribute some code?</h2>
<div class="sectionbody">
<div class="paragraph">
-<p>We encourage discussions prior code contributions on the <a href="mailing-lists.html" class="xref page">mailing lists</a>. For significant design
+<p>We encourage discussions prior code contributions on the <a href="mailing-lists.html" class="page">mailing lists</a>. For significant design
changes the writing of <a href="#_idea_or_design_proposals">ADRs</a> is encouraged.</p>
</div>
<div class="paragraph">
@@ -521,7 +503,7 @@
</div>
<div class="listingblock">
<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">JAMES-2285 My awesome commit title
+<pre class="highlightjs highlight"><code>JAMES-2285 My awesome commit title
Here is some more details about what my commit does, and the rationals of the choice I took.</code></pre>
</div>
@@ -621,7 +603,7 @@
</div>
<div class="listingblock">
<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">mvn validate</code></pre>
+<pre class="highlightjs highlight"><code>mvn validate</code></pre>
</div>
</div>
<div class="paragraph">
@@ -629,7 +611,7 @@
</div>
<div class="listingblock">
<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">mvn validate -PsortPom</code></pre>
+<pre class="highlightjs highlight"><code>mvn validate -PsortPom</code></pre>
</div>
</div>
<div class="paragraph">
diff --git a/james-project/3.8.0/community/download.html b/james-project/3.8.0/community/download.html
index 000bef4..36433e2 100644
--- a/james-project/3.8.0/community/download.html
+++ b/james-project/3.8.0/community/download.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Download Apache James releases :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -327,13 +316,6 @@
<li><a href="download.html">Download releases</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="download.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/community/download.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/community/pages/download.adoc">Edit this Page</a></div>
</div>
<div class="content">
diff --git a/james-project/3.8.0/community/guidelines.html b/james-project/3.8.0/community/guidelines.html
index a83ee66..9e887c6 100644
--- a/james-project/3.8.0/community/guidelines.html
+++ b/james-project/3.8.0/community/guidelines.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Apache James Project guidelines :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -327,13 +316,6 @@
<li><a href="guidelines.html">Guidelines</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="guidelines.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/community/guidelines.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/community/pages/guidelines.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -391,7 +373,7 @@
<h3 id="_mailing_list"><a class="anchor" href="#_mailing_list"></a>Mailing list</h3>
<div class="paragraph">
<p>The Apache committers' primary mailing list for discussion of issues and changes related to the project
-(<a href="mailing-lists.html#_server_developer_list" class="xref page"><a href="mailto:server-dev@james.apache.org">server-dev@james.apache.org</a></a>). Subscription to the list is open, but
+(<a href="mailing-lists.html#_server_developer_list" class="page"><a href="mailto:server-dev@james.apache.org">server-dev@james.apache.org</a></a>). Subscription to the list is open, but
only subscribers can post directly to the list.</p>
</div>
</div>
@@ -416,7 +398,7 @@
<p>Discussions of <a href="https://community.apache.org/newcommitter.html">new committers, new PMCs</a>, including proposition discussions, votes and process follow up.</p>
</li>
<li>
-<p>Handling of <a href="contributing.html#_reporting_security_vulnerabilities" class="xref page">security vulnerability reports</a>, and CVE publication.</p>
+<p>Handling of <a href="contributing.html#_reporting_security_vulnerabilities" class="page">security vulnerability reports</a>, and CVE publication.</p>
</li>
</ul>
</div>
@@ -442,8 +424,8 @@
</div>
<div class="paragraph">
<p>We actively rely on <a href="https://community.apache.org/committers/lazyConsensus.html">lazy consensus</a> for most of our
-decisions, be them validating <a href="contributing.html#_how_to_contribute_some_code" class="xref page">code changes</a>, enacting
-<a href="contributing.html#_idea_or_design_proposals" class="xref page">design decisions</a>.</p>
+decisions, be them validating <a href="contributing.html#_how_to_contribute_some_code" class="page">code changes</a>, enacting
+<a href="contributing.html#_idea_or_design_proposals" class="page">design decisions</a>.</p>
</div>
<div class="paragraph">
<p>All code modifications should achieve lazy consensus under the form of GitHub pull requests.</p>
@@ -456,7 +438,7 @@
<div class="ulist">
<ul>
<li>
-<p><a href="release.html" class="xref page">releases</a></p>
+<p><a href="release.html" class="page">releases</a></p>
</li>
<li>
<p>establishing a new sub-project</p>
diff --git a/james-project/3.8.0/community/index.html b/james-project/3.8.0/community/index.html
index e8ac98b..0d079cb 100644
--- a/james-project/3.8.0/community/index.html
+++ b/james-project/3.8.0/community/index.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Apache James Community :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -326,13 +315,6 @@
<li><a href="index.html">Community</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="index.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/community/index.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/community/pages/index.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -361,7 +343,7 @@
<p><a href="https://james.apache.org/">Apache James Website</a></p>
</li>
<li>
-<p><a href="mailing-lists.html" class="xref page">Mailing lists</a>: Subscribe to the appropriate Mailing Lists according to your interests and profile.</p>
+<p><a href="mailing-lists.html" class="page">Mailing lists</a>: Subscribe to the appropriate Mailing Lists according to your interests and profile.</p>
</li>
<li>
<p><a href="https://gitter.im/apache/james-project">Gitter chat room</a>: Chat in live with the community on Gitter.</p>
@@ -379,10 +361,10 @@
<p><a href="https://builds.apache.org/job/ApacheJames/">CI</a>: Check the status of James builds on our Jenkins CI.</p>
</li>
<li>
-<p><a href="download.html" class="xref page">Download releases</a>: Download artifacts and sources your need for the James Server and James libraries.</p>
+<p><a href="download.html" class="page">Download releases</a>: Download artifacts and sources your need for the James Server and James libraries.</p>
</li>
<li>
-<p><a href="support.html" class="xref page">Professional support</a>: Find a list of companies which can provide you some support on James.</p>
+<p><a href="support.html" class="page">Professional support</a>: Find a list of companies which can provide you some support on James.</p>
</li>
</ul>
</div>
@@ -399,7 +381,7 @@
and bug reports. We more than welcome non-coding contributions.</p>
</div>
<div class="paragraph">
-<p>You can find more information on how to contribute to the James project on the <a href="contributing.html" class="xref page">contributing</a> section.</p>
+<p>You can find more information on how to contribute to the James project on the <a href="contributing.html" class="page">contributing</a> section.</p>
</div>
</div>
</div>
@@ -409,10 +391,10 @@
<div class="ulist">
<ul>
<li>
-<p><a href="website.html" class="xref page">Building and publishing the website</a></p>
+<p><a href="website.html" class="page">Building and publishing the website</a></p>
</li>
<li>
-<p><a href="release.html" class="xref page">Creating an official Apache James release</a></p>
+<p><a href="release.html" class="page">Creating an official Apache James release</a></p>
</li>
</ul>
</div>
@@ -423,7 +405,7 @@
<div class="sectionbody">
<div class="paragraph">
<p>James is a project belonging to the <a href="https://www.apache.org/">Apache Software Foundation [ASF]</a>. Thus, the Apache Jame project
-is governed by a number of <a href="guidelines.html" class="xref page">guidelines</a> directly depending on the <strong>ASF</strong>.</p>
+is governed by a number of <a href="guidelines.html" class="page">guidelines</a> directly depending on the <strong>ASF</strong>.</p>
</div>
<div class="paragraph">
<p>If you wish to get more involved with the <strong>ASF</strong> community in general, those links might interest you as well:</p>
diff --git a/james-project/3.8.0/community/mailing-lists.html b/james-project/3.8.0/community/mailing-lists.html
index b28601c..be5e428 100644
--- a/james-project/3.8.0/community/mailing-lists.html
+++ b/james-project/3.8.0/community/mailing-lists.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Mailing lists :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -327,13 +316,6 @@
<li><a href="mailing-lists.html">Mailing lists</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="mailing-lists.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/community/mailing-lists.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/community/pages/mailing-lists.adoc">Edit this Page</a></div>
</div>
<div class="content">
diff --git a/james-project/3.8.0/community/release.html b/james-project/3.8.0/community/release.html
index ed9c026..da1d0af 100644
--- a/james-project/3.8.0/community/release.html
+++ b/james-project/3.8.0/community/release.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Creating an official Apache James release :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -327,13 +316,6 @@
<li><a href="release.html">Creating an official Apache James release</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="release.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/community/release.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/community/pages/release.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -482,7 +464,7 @@
</div>
<div class="listingblock">
<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">Subject: Call for vote: Apache James x.x.x
+<pre class="highlightjs highlight"><code>Subject: Call for vote: Apache James x.x.x
Hi,
@@ -522,7 +504,7 @@
</div>
<div class="listingblock">
<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">Hi all,
+<pre class="highlightjs highlight"><code>Hi all,
I am happy to announce you the vote for the x.x.x release did succeed.
@@ -553,7 +535,7 @@
</div>
<div class="listingblock">
<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">mkdir server/3.x.x
+<pre class="highlightjs highlight"><code>mkdir server/3.x.x
cd server/3.x.x
svn add .</code></pre>
</div>
@@ -576,7 +558,7 @@
</div>
<div class="listingblock">
<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">% cat /usr/local/bin/auto_sig
+<pre class="highlightjs highlight"><code>% cat /usr/local/bin/auto_sig
#/bin/bash
# This quick bash scipt intend to help commiters
@@ -610,7 +592,7 @@
</div>
<div class="listingblock">
<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">svn rm 3.5.0
+<pre class="highlightjs highlight"><code>svn rm 3.5.0
svn commit -m "Archive James release 3.5.0"</code></pre>
</div>
</div>
diff --git a/james-project/3.8.0/community/support.html b/james-project/3.8.0/community/support.html
index 635bf22..88794b8 100644
--- a/james-project/3.8.0/community/support.html
+++ b/james-project/3.8.0/community/support.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Professional support :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -327,13 +316,6 @@
<li><a href="support.html">Professional support</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="support.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/community/support.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/community/pages/support.adoc">Edit this Page</a></div>
</div>
<div class="content">
diff --git a/james-project/3.8.0/community/website.html b/james-project/3.8.0/community/website.html
index 9b0b7d7..d5f9d8c 100644
--- a/james-project/3.8.0/community/website.html
+++ b/james-project/3.8.0/community/website.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Building and publishing the website :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -327,13 +316,6 @@
<li><a href="website.html">Building and publishing the website</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="website.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/community/website.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/community/pages/website.adoc">Edit this Page</a></div>
</div>
<div class="content">
diff --git a/james-project/3.8.0/concepts/configuration.html b/james-project/3.8.0/concepts/configuration.html
index 44f0209..7cae205 100644
--- a/james-project/3.8.0/concepts/configuration.html
+++ b/james-project/3.8.0/concepts/configuration.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Configuration :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -327,13 +316,6 @@
<li><a href="configuration.html">Configuration</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="configuration.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/concepts/configuration.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/concepts/pages/configuration.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -354,7 +336,7 @@
</div>
<div class="paragraph">
<p>A "<strong>Configuration</strong>" is a <a href="https://martinfowler.com/bliki/ValueObject.html">value object</a>
-that communicates to a James server how the <a href="user/index.html#_operator" class="xref page">Operator</a> wishes the
+that communicates to a James server how the <a href="user/index.html#_operator" class="page">Operator</a> wishes the
server to behave. It is very similar to an interface, but yet it is not quite an interface
(which is why we call it something different).</p>
</div>
@@ -362,7 +344,7 @@
<p>An "interface" provides a means for an Operator to interact with a server as part of the
normal course of ongoing operations. Interfacing with the system essentially means either
reading the server’s current state, or updating the server’s current state. A typical example
-would be adding a new mailbox via the <a href="#concepts:???.adoc" class="xref unresolved">Useradmin API</a>. Each time the Operator
+would be adding a new mailbox via the <a href="#concepts:???.adoc" class="page unresolved">Useradmin API</a>. Each time the Operator
interacts with the system via an interface, although the <strong>state</strong> of the system may change,
the <strong>behavior</strong> of the system is not expected to change.</p>
</div>
diff --git a/james-project/3.8.0/concepts/glossary.html b/james-project/3.8.0/concepts/glossary.html
index 0bd8780..5b892cc 100644
--- a/james-project/3.8.0/concepts/glossary.html
+++ b/james-project/3.8.0/concepts/glossary.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Glossary :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -327,13 +316,6 @@
<li><a href="glossary.html">Glossary</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="glossary.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/concepts/glossary.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/concepts/pages/glossary.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -348,7 +330,7 @@
<dd>
<p>Any software application that acts as a POP Client or an IMAP Client.</p>
</dd>
-<dt class="hdlist1"><a href="messages/imf.html" class="xref page">IMF</a></dt>
+<dt class="hdlist1"><a href="messages/imf.html" class="page">IMF</a></dt>
<dd>
<p><strong>Internet Message Format</strong> (IMF) is the base specification that defines the
syntax of an email message.</p>
@@ -375,7 +357,7 @@
IMAP Clients.</p>
</dd>
<dt class="hdlist1">JMAP</dt>
-<dt class="hdlist1"><a href="messages/mime.html" class="xref page">MIME</a></dt>
+<dt class="hdlist1"><a href="messages/mime.html" class="page">MIME</a></dt>
<dd>
<p><strong>Multipurpose Internet Mail Extension</strong> (MIME) is a specification that extends
IMF, defining most of the "advanced" features of email.</p>
@@ -396,7 +378,7 @@
final MTA on the terminating side of a transmission. It is in some respects similar to
an MTA, but is local in scope and does not necessarily follow a known specification.</p>
</dd>
-<dt class="hdlist1"><a href="protocols/smtp.html" class="xref page">SMTP</a></dt>
+<dt class="hdlist1"><a href="protocols/smtp.html" class="page">SMTP</a></dt>
<dd>
<p><strong>Simple Mail Transfer Protocol</strong> (SMTP) is a protocol that specifies how to transmit
a valid email message from one MTA to another.</p>
diff --git a/james-project/3.8.0/concepts/index.html b/james-project/3.8.0/concepts/index.html
index 3e813d4..2a14666 100644
--- a/james-project/3.8.0/concepts/index.html
+++ b/james-project/3.8.0/concepts/index.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Apache James Core Concepts :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -326,13 +315,6 @@
<li><a href="index.html">Concepts</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="index.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/concepts/index.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/concepts/pages/index.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -376,7 +358,7 @@
write "mail".</p>
</div>
<div class="paragraph">
-<p><a href="mail/index.html" class="xref page">Email messages</a> are based on a few specifications
+<p><a href="mail/index.html" class="page">Email messages</a> are based on a few specifications
that are not easy to digest, so we make an effort to provide a simplified
model.</p>
</div>
@@ -390,7 +372,7 @@
To allow for this, obviously there must be a means of transmitting messages
from one user to another. A number of different protocols have emerged to
handle the various different requirements of using email in a practical
-manner. The most common <a href="protocols/index.html" class="xref page">transmission protocols</a>
+manner. The most common <a href="protocols/index.html" class="page">transmission protocols</a>
are SMTP, POP, and IMAP. More recently JMAP is an interesting protocol
that merits attention.</p>
</div>
@@ -404,7 +386,7 @@
a message would self-destruct immediately after being read.
For those of us who are not secret agents, we generally prefer to keep
a record of those messages that we receive. For this reason we need a means
-of <a href="storage/index.html" class="xref page">storing messages</a>.</p>
+of <a href="storage/index.html" class="page">storing messages</a>.</p>
</div>
</div>
</div>
@@ -413,7 +395,7 @@
<div class="sectionbody">
<div class="paragraph">
<p>There are many ways to peel a potato. James has its own particular
-<a href="processing/index.html" class="xref page">model for processing mail</a>,
+<a href="processing/index.html" class="page">model for processing mail</a>,
based mostly on the concept of a "Mailet". The idea of Mailet-based
processing was heavily inspired by the <a href="https://en.wikipedia.org/wiki/Java_servlet">Servlet</a>
concept.</p>
diff --git a/james-project/3.8.0/concepts/mail/index.html b/james-project/3.8.0/concepts/mail/index.html
index a7777f5..5f82748 100644
--- a/james-project/3.8.0/concepts/mail/index.html
+++ b/james-project/3.8.0/concepts/mail/index.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>All About Emails :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -327,13 +316,6 @@
<li><a href="index.html">Emails</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="index.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/concepts/mail/index.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/concepts/pages/mail/index.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -358,10 +340,10 @@
<div class="ulist">
<ul>
<li>
-<p><a href="../messages/index.html" class="xref page">Email Messages</a></p>
+<p><a href="../messages/index.html" class="page">Email Messages</a></p>
</li>
<li>
-<p><a href="../protocols/index.html" class="xref page">Transmission Protocols</a></p>
+<p><a href="../protocols/index.html" class="page">Transmission Protocols</a></p>
</li>
</ul>
</div>
diff --git a/james-project/3.8.0/concepts/messages/imf.html b/james-project/3.8.0/concepts/messages/imf.html
index 188fbe1..10bb51e 100644
--- a/james-project/3.8.0/concepts/messages/imf.html
+++ b/james-project/3.8.0/concepts/messages/imf.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Internet Message Format :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -329,13 +318,6 @@
<li><a href="imf.html">IMF</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="imf.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/concepts/messages/imf.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/concepts/pages/messages/imf.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -358,7 +340,7 @@
<div class="paragraph">
<p>IMF is very basic, and is limited to only specifying a syntax for text messages.
For the transmission of images, audio, or other types of data we need to make
-use of the <a href="#mail/messages/mime.adoc" class="xref unresolved">MIME</a> specification.
+use of the <a href="#mail/messages/mime.adoc" class="page unresolved">MIME</a> specification.
Although IMF forms the base standard upon which
email is based, email today is rarely used without MIME. We therefore consider
for practical purposes that an email message is essentially the equivalent of
diff --git a/james-project/3.8.0/concepts/messages/index.html b/james-project/3.8.0/concepts/messages/index.html
index ff7f0e0..ce4ec21 100644
--- a/james-project/3.8.0/concepts/messages/index.html
+++ b/james-project/3.8.0/concepts/messages/index.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Email Messages :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -328,13 +317,6 @@
<li><a href="index.html">Messages</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="index.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/concepts/messages/index.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/concepts/pages/messages/index.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -357,10 +339,10 @@
<div class="ulist">
<ul>
<li>
-<p><a href="imf.html" class="xref page">Internet Mail Format</a> (IMF)</p>
+<p><a href="imf.html" class="page">Internet Mail Format</a> (IMF)</p>
</li>
<li>
-<p><a href="mime.html" class="xref page">Multipurpose Internet Mail Extensions</a> (MIME)</p>
+<p><a href="mime.html" class="page">Multipurpose Internet Mail Extensions</a> (MIME)</p>
</li>
</ul>
</div>
diff --git a/james-project/3.8.0/concepts/messages/mime.html b/james-project/3.8.0/concepts/messages/mime.html
index f7c3e5b..e63ab83 100644
--- a/james-project/3.8.0/concepts/messages/mime.html
+++ b/james-project/3.8.0/concepts/messages/mime.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Multipurpose Internet Mail Extensions :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -329,13 +318,6 @@
<li><a href="mime.html">MIME</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="mime.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/concepts/messages/mime.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/concepts/pages/messages/mime.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -348,7 +330,7 @@
<h2 id="_overview"><a class="anchor" href="#_overview"></a>Overview</h2>
<div class="sectionbody">
<div class="paragraph">
-<p>The base format of an email message is <a href="imf.html" class="xref page">Internet Message Format"</a>,
+<p>The base format of an email message is <a href="imf.html" class="page">Internet Message Format"</a>,
but most contemporary messages use a format called
<a href="https://en.wikipedia.org/wiki/MIME">"Multipurpose Internet Mail Extensions"</a>.
MIME specifies how to extend a valid IMF message, dealing with character encodings,
diff --git a/james-project/3.8.0/concepts/processing/index.html b/james-project/3.8.0/concepts/processing/index.html
index cfd25f6..61b010e 100644
--- a/james-project/3.8.0/concepts/processing/index.html
+++ b/james-project/3.8.0/concepts/processing/index.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Mail Processing Domain Model :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -327,13 +316,6 @@
<li><a href="index.html">Processing</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="index.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/concepts/processing/index.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/concepts/pages/processing/index.adoc">Edit this Page</a></div>
</div>
<div class="content">
diff --git a/james-project/3.8.0/concepts/protocols/esmtp.html b/james-project/3.8.0/concepts/protocols/esmtp.html
index 6cba742..a755a08 100644
--- a/james-project/3.8.0/concepts/protocols/esmtp.html
+++ b/james-project/3.8.0/concepts/protocols/esmtp.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>SMTP Service Extensions (ESMTP) :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -328,13 +317,6 @@
<li><a href="esmtp.html">ESMTP</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="esmtp.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/concepts/protocols/esmtp.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/concepts/pages/protocols/esmtp.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -388,7 +370,7 @@
<div class="paragraph">
<p><a href="https://tools.ietf.org/html/rfc1869">RFC1869</a> ("SMTP Service Extensions") obsoletes <a href="#_rfc1651">RFC1651</a>, and
is essentially the final specification in which ESMTP was defined separately from SMTP. When this
-spec was obsoleted by <a href="smtp.html#RFC2821" class="xref page">RFC2821</a>, it was incorporated into the
+spec was obsoleted by <a href="smtp.html#RFC2821" class="page">RFC2821</a>, it was incorporated into the
SMTP specification.</p>
</div>
</div>
@@ -400,10 +382,10 @@
<div class="ulist">
<ul>
<li>
-<p><strong><a href="smtp.html" class="xref page">SMTP</a></strong>, because ESMTP defines an extension framework for SMTP</p>
+<p><strong><a href="smtp.html" class="page">SMTP</a></strong>, because ESMTP defines an extension framework for SMTP</p>
</li>
<li>
-<p><strong><a href="lmtp.html" class="xref page">LMTP</a></strong>, as LMTP is defined by the ESMTP framework</p>
+<p><strong><a href="lmtp.html" class="page">LMTP</a></strong>, as LMTP is defined by the ESMTP framework</p>
</li>
</ul>
</div>
diff --git a/james-project/3.8.0/concepts/protocols/imap.html b/james-project/3.8.0/concepts/protocols/imap.html
index 21dd894..a5ab444 100644
--- a/james-project/3.8.0/concepts/protocols/imap.html
+++ b/james-project/3.8.0/concepts/protocols/imap.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Internet Message Access Protocol (IMAP) :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -328,13 +317,6 @@
<li><a href="imap.html">IMAP</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="imap.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/concepts/protocols/imap.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/concepts/pages/protocols/imap.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -349,8 +331,8 @@
<div class="paragraph">
<p><a href="https://en.wikipedia.org/wiki/Internet_Message_Access_Protocol">Internet Message Access Protocol</a>,
or IMAP, is a protocol used by email clients to retrieve
-<a href="../messages/index.html" class="xref page">email messages</a> from a <a href="../glossary.html#email_server" class="xref page">mail server</a>.
-One could say that it is effectively in competition with <a href="pop.html" class="xref page">POP</a>
+<a href="../messages/index.html" class="page">email messages</a> from a <a href="../glossary.html#email_server" class="page">mail server</a>.
+One could say that it is effectively in competition with <a href="pop.html" class="page">POP</a>
because it accomplishes a function similar in nature, and most clients will force you
to choose one or the other.
These days, the natural choice of protocol tends to be IMAP rather than POP.</p>
@@ -497,14 +479,14 @@
<div class="ulist">
<ul>
<li>
-<p><strong><a href="pop.html" class="xref page">POP</a></strong> as a "competing" protocol</p>
+<p><strong><a href="pop.html" class="page">POP</a></strong> as a "competing" protocol</p>
</li>
<li>
-<p><strong><a href="../glossary.html#email_client" class="xref page">Email clients</a></strong>, as the client will provide the functionality of
+<p><strong><a href="../glossary.html#email_client" class="page">Email clients</a></strong>, as the client will provide the functionality of
an IMAP Client and connect to the IMAP Server</p>
</li>
<li>
-<p><strong><a href="smtp.html" class="xref page">SMTP</a></strong>, in that messages will normally be
+<p><strong><a href="smtp.html" class="page">SMTP</a></strong>, in that messages will normally be
delivered to the IMAP Server via SMTP.</p>
</li>
</ul>
diff --git a/james-project/3.8.0/concepts/protocols/index.html b/james-project/3.8.0/concepts/protocols/index.html
index 8044859..a9ce4a7 100644
--- a/james-project/3.8.0/concepts/protocols/index.html
+++ b/james-project/3.8.0/concepts/protocols/index.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Transmission Protocols :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -327,13 +316,6 @@
<li><a href="index.html">Protocols</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="index.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/concepts/protocols/index.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/concepts/pages/protocols/index.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -345,7 +327,7 @@
<div class="paragraph">
<p>The true value of email is that any one party can communicate with any
other party located virtually anywhere. All they need are a common understanding
-of a <a href="../messages/index.html" class="xref page">message format</a>, and a means of
+of a <a href="../messages/index.html" class="page">message format</a>, and a means of
transmitting the message.</p>
</div>
<div class="paragraph">
@@ -356,19 +338,19 @@
<div class="ulist">
<ul>
<li>
-<p><a href="smtp.html" class="xref page">Simple Mail Transfer</a></p>
+<p><a href="smtp.html" class="page">Simple Mail Transfer</a></p>
</li>
<li>
-<p><a href="pop.html" class="xref page">Post Office</a></p>
+<p><a href="pop.html" class="page">Post Office</a></p>
</li>
<li>
-<p><a href="imap.html" class="xref page">Internet Message Access</a></p>
+<p><a href="imap.html" class="page">Internet Message Access</a></p>
</li>
<li>
-<p><a href="jmap.html" class="xref page">JSON Meta Application</a></p>
+<p><a href="jmap.html" class="page">JSON Meta Application</a></p>
</li>
<li>
-<p><a href="lmtp.html" class="xref page">Local Mail Transfer</a></p>
+<p><a href="lmtp.html" class="page">Local Mail Transfer</a></p>
</li>
</ul>
</div>
diff --git a/james-project/3.8.0/concepts/protocols/jmap.html b/james-project/3.8.0/concepts/protocols/jmap.html
index 08e51cc..9ff531f 100644
--- a/james-project/3.8.0/concepts/protocols/jmap.html
+++ b/james-project/3.8.0/concepts/protocols/jmap.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>JSON Meta Application Protocol (JMAP) :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -328,13 +317,6 @@
<li><a href="jmap.html">JMAP</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="jmap.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/concepts/protocols/jmap.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/concepts/pages/protocols/jmap.adoc">Edit this Page</a></div>
</div>
<div class="content">
diff --git a/james-project/3.8.0/concepts/protocols/lmtp.html b/james-project/3.8.0/concepts/protocols/lmtp.html
index 2443438..e813c7b 100644
--- a/james-project/3.8.0/concepts/protocols/lmtp.html
+++ b/james-project/3.8.0/concepts/protocols/lmtp.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Local Mail Transfer Protocol (LMTP) :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -328,13 +317,6 @@
<li><a href="lmtp.html">LMTP</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="lmtp.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/concepts/protocols/lmtp.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/concepts/pages/protocols/lmtp.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -372,7 +354,7 @@
<div class="paragraph">
<p><a href="https://tools.ietf.org/html/rfc2033">RFC2033</a> ("Local Mail Transfer Protocol") was published
in 1996, and defines a simplified protocol for local mail delivery mainly inspired by
-<a href="esmtp.html" class="xref page">ESMTP</a>. It is the first, last, and only specification of its kind.</p>
+<a href="esmtp.html" class="page">ESMTP</a>. It is the first, last, and only specification of its kind.</p>
</div>
</div>
</div>
@@ -386,7 +368,7 @@
<div class="ulist">
<ul>
<li>
-<p><strong><a href="esmtp.html" class="xref page">ESMTP</a></strong>, as it is a derivative thereof</p>
+<p><strong><a href="esmtp.html" class="page">ESMTP</a></strong>, as it is a derivative thereof</p>
</li>
</ul>
</div>
diff --git a/james-project/3.8.0/concepts/protocols/pop.html b/james-project/3.8.0/concepts/protocols/pop.html
index a472dba..18de97b 100644
--- a/james-project/3.8.0/concepts/protocols/pop.html
+++ b/james-project/3.8.0/concepts/protocols/pop.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Post Office Protocol (POP) :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -328,13 +317,6 @@
<li><a href="pop.html">POP</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="pop.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/concepts/protocols/pop.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/concepts/pages/protocols/pop.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -350,11 +332,11 @@
<p>The <a href="https://en.wikipedia.org/wiki/Post_Office_Protocol">Post Office Protocol</a>,
or POP, is described in the original specification
as being "a simple method for workstations to dynamically access mail from
-a <a href="../storage/index.html" class="xref page">mailbox server</a>" (though interestingly "mailbox server"
+a <a href="../storage/index.html" class="page">mailbox server</a>" (though interestingly "mailbox server"
is never actually defined in this specification nor in later specifications. 🤔)</p>
</div>
<div class="paragraph">
-<p>POP was proposed as the first non-<a href="smtp.html" class="xref page">SMTP</a> protocol aimed
+<p>POP was proposed as the first non-<a href="smtp.html" class="page">SMTP</a> protocol aimed
at users for the purpose of retrieving emails stored remotely for local consumption.
POP was developed in pre-spam days, so was inherently a non-secure protocol.
It has been updated several times to address several issues, including lack of
@@ -406,7 +388,7 @@
<p><a href="https://tools.ietf.org/html/rfc918">RFC918</a> ("Post Office Protocol") was the original
specification published in 1984. The RFC "suggests a simple method for workstations
to dynamically access mail from a mailbox server."
-Like <a href="smtp.html" class="xref page">SMTP</a> that came before it, POP is a session-based
+Like <a href="smtp.html" class="page">SMTP</a> that came before it, POP is a session-based
protocol with a handful of defined commands.
This RFC was obsoleted shortly after its publication by <a href="#_rfc937">RFC937</a>.</p>
</div>
@@ -474,7 +456,7 @@
</div>
<div class="paragraph">
<p>This specification seems to imply that POP3 is used for "simple" transactions,
-and for more "advanced" transactions <a href="imap.html" class="xref page">IMAP</a> is available.</p>
+and for more "advanced" transactions <a href="imap.html" class="page">IMAP</a> is available.</p>
</div>
</div>
</div>
@@ -497,17 +479,17 @@
<div class="ulist">
<ul>
<li>
-<p><strong><a href="imap.html" class="xref page">IMAP</a></strong> as a "competing" protocol</p>
+<p><strong><a href="imap.html" class="page">IMAP</a></strong> as a "competing" protocol</p>
</li>
<li>
-<p><strong><a href="../glossary.html#email_client" class="xref page">Email clients</a></strong>, in that the client acts as a POP Client</p>
+<p><strong><a href="../glossary.html#email_client" class="page">Email clients</a></strong>, in that the client acts as a POP Client</p>
</li>
<li>
-<p><strong><a href="../storage/index.html" class="xref page">Storage</a></strong> in that messages are stored temporarily on
+<p><strong><a href="../storage/index.html" class="page">Storage</a></strong> in that messages are stored temporarily on
a ???? while awaiting transfer to the client</p>
</li>
<li>
-<p><strong><a href="smtp.html" class="xref page">SMTP</a></strong>, in that messages will normally be
+<p><strong><a href="smtp.html" class="page">SMTP</a></strong>, in that messages will normally be
delivered to the IMAP Server via SMTP.</p>
</li>
</ul>
diff --git a/james-project/3.8.0/concepts/protocols/smtp.html b/james-project/3.8.0/concepts/protocols/smtp.html
index 6fe521b..f28c7bf 100644
--- a/james-project/3.8.0/concepts/protocols/smtp.html
+++ b/james-project/3.8.0/concepts/protocols/smtp.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Simple Mail Transfer Protocol (SMTP) :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -328,13 +317,6 @@
<li><a href="smtp.html">SMTP</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="smtp.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/concepts/protocols/smtp.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/concepts/pages/protocols/smtp.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -349,7 +331,7 @@
<div class="paragraph">
<p>When the original specification for Simple Mail Transfer Protocol, or SMTP,
was published almost 40 years ago together with
-<a href="../messages/imf.html" class="xref page">IMF</a>, email as we know it today was born.</p>
+<a href="../messages/imf.html" class="page">IMF</a>, email as we know it today was born.</p>
</div>
</div>
</div>
@@ -380,8 +362,8 @@
the gory details, we recommend that you read this document.</p>
</div>
<div class="paragraph">
-<p>This specification has many dependencies with <a href="../messages/imf.html" class="xref page">IMF</a>,
-<a href="../messages/mime.html" class="xref page">MIME</a>, and other technical concepts, which can quickly
+<p>This specification has many dependencies with <a href="../messages/imf.html" class="page">IMF</a>,
+<a href="../messages/mime.html" class="page">MIME</a>, and other technical concepts, which can quickly
become utterly confusing.
Here, we provide a very short and simplified description of those portions of the
specification that we felt were interesting enough to repeat here.</p>
@@ -415,11 +397,11 @@
<div class="ulist">
<ul>
<li>
-<p><strong><a href="../messages/index.html" class="xref page">Email messages</a></strong>, in that the SMTP protocol exists to transfer
+<p><strong><a href="../messages/index.html" class="page">Email messages</a></strong>, in that the SMTP protocol exists to transfer
messages from one host to another</p>
</li>
<li>
-<p><strong><a href="../glossary.html#mta" class="xref page">MTA</a></strong>, in that the very nature of SMTP is about specifying how a message
+<p><strong><a href="../glossary.html#mta" class="page">MTA</a></strong>, in that the very nature of SMTP is about specifying how a message
gets transferred from one MTA to another</p>
</li>
</ul>
@@ -505,11 +487,11 @@
</tr>
<tr>
<td><i class="conum" data-value="3"></i><b>3</b></td>
-<td>Indicate that you want to send a mail from <a href="mailto:user02@james.local">user02@james.local</a>.</td>
+<td>Indicate that you want to send a mail from user02@james.local.</td>
</tr>
<tr>
<td><i class="conum" data-value="4"></i><b>4</b></td>
-<td>Indicate that the mail should be sent to <a href="mailto:user01@james.local">user01@james.local</a>.</td>
+<td>Indicate that the mail should be sent to user01@james.local.</td>
</tr>
<tr>
<td><i class="conum" data-value="5"></i><b>5</b></td>
@@ -535,7 +517,7 @@
</div>
<div class="paragraph">
<p>If you set up Thunderbird to connect to the server, you can confirm that the mail
-has indeed arrived in the mailbox of <a href="mailto:user01@james.local">user01@james.local</a>.</p>
+has indeed arrived in the mailbox of user01@james.local.</p>
</div>
<div class="paragraph">
<p>Pretty cool! Good thing we have James so we don’t have to always send emails manually.</p>
diff --git a/james-project/3.8.0/concepts/storage/index.html b/james-project/3.8.0/concepts/storage/index.html
index b19ced8..ebb196f 100644
--- a/james-project/3.8.0/concepts/storage/index.html
+++ b/james-project/3.8.0/concepts/storage/index.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Storage :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -327,13 +316,6 @@
<li><a href="index.html">Storage</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="index.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/concepts/storage/index.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/concepts/pages/storage/index.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -370,14 +352,14 @@
Many corporations use email for business purposes, which requires administration of
users within the organization.
Even individuals with a self-hosted email server want to ensure that their system does
-not get abused as an <a href="../glossary.html#open_relay" class="xref page">open relay</a>.</p>
+not get abused as an <a href="../glossary.html#open_relay" class="page">open relay</a>.</p>
</div>
<div class="paragraph">
<p>All of these types of concerns requires that the system maintain some kind of state,
whether that be the messages themselves, information about the system’s users,
and even in some cases user credentials. Keeping state requires a storage system.
The system of storage must work intimately with the various
-<a href="../protocols/index.html" class="xref page">protocols</a>.</p>
+<a href="../protocols/index.html" class="page">protocols</a>.</p>
</div>
<div class="paragraph">
<p>In this section, we describe the two principle types of storage that James manages:</p>
@@ -385,10 +367,10 @@
<div class="ulist">
<ul>
<li>
-<p><a href="mailbox.html" class="xref page">Mailboxes</a> for email storage, and</p>
+<p><a href="mailbox.html" class="page">Mailboxes</a> for email storage, and</p>
</li>
<li>
-<p><a href="users.html" class="xref page">User Repository</a> for data about Mailbox users.</p>
+<p><a href="users.html" class="page">User Repository</a> for data about Mailbox users.</p>
</li>
</ul>
</div>
diff --git a/james-project/3.8.0/concepts/storage/mailbox.html b/james-project/3.8.0/concepts/storage/mailbox.html
index d709c8d..9ed60e2 100644
--- a/james-project/3.8.0/concepts/storage/mailbox.html
+++ b/james-project/3.8.0/concepts/storage/mailbox.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Mailboxes :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -328,13 +317,6 @@
<li><a href="mailbox.html">Mailboxes</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="mailbox.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/concepts/storage/mailbox.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/concepts/pages/storage/mailbox.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -470,7 +452,7 @@
<div class="paragraph">
<p>The <a href="https://en.wikipedia.org/wiki/MIX_(email)">MIX</a> email storage format was developed by
<a href="https://en.wikipedia.org/wiki/Mark_Crispin">Mark Crispin</a>, the original author of the
-<a href="../protocols/imap.html" class="xref page">IMAP specification</a>. Its
+<a href="../protocols/imap.html" class="page">IMAP specification</a>. Its
<a href="https://www.mail-archive.com/imap-uw@u.washington.edu/msg00540.html">design goals</a> were:</p>
</div>
<div class="ulist">
@@ -532,19 +514,19 @@
<div class="ulist">
<ul>
<li>
-<p><strong><a href="../protocols/pop.html" class="xref page">POP</a></strong>, as the POP protocol mandates interaction
+<p><strong><a href="../protocols/pop.html" class="page">POP</a></strong>, as the POP protocol mandates interaction
with a user’s "mailbox"</p>
</li>
<li>
-<p><strong><a href="../protocols/imap.html" class="xref page">IMAP</a></strong>, as the IMAP protocol is all about storing
+<p><strong><a href="../protocols/imap.html" class="page">IMAP</a></strong>, as the IMAP protocol is all about storing
messages on an IMAP Server</p>
</li>
<li>
-<p><strong><a href="../glossary.html#email_client" class="xref page">Email clients</a></strong>, as the client will store mail locally, usually in the form
+<p><strong><a href="../glossary.html#email_client" class="page">Email clients</a></strong>, as the client will store mail locally, usually in the form
of a "mailbox"</p>
</li>
<li>
-<p><strong><a href="../protocols/smtp.html" class="xref page">SMTP</a></strong> as the protocol is related to transmitting
+<p><strong><a href="../protocols/smtp.html" class="page">SMTP</a></strong> as the protocol is related to transmitting
messages from one mailbox to another</p>
</li>
</ul>
diff --git a/james-project/3.8.0/concepts/storage/users.html b/james-project/3.8.0/concepts/storage/users.html
index ce3299c..aa6e3c7 100644
--- a/james-project/3.8.0/concepts/storage/users.html
+++ b/james-project/3.8.0/concepts/storage/users.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>User Repository :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -328,13 +317,6 @@
<li><a href="users.html">Users</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="users.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/concepts/storage/users.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/concepts/pages/storage/users.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -347,12 +329,12 @@
<h2 id="_overview"><a class="anchor" href="#_overview"></a>Overview</h2>
<div class="sectionbody">
<div class="paragraph">
-<p>Whereas <a href="mailbox.html" class="xref page">mailboxes</a> are clearly a core component of
+<p>Whereas <a href="mailbox.html" class="page">mailboxes</a> are clearly a core component of
any email system, user management is a lighter shade of gray.</p>
</div>
<div class="paragraph">
<p>On the one hand, mailboxes ought to match up with actual
-<a href="../user/index.html#_user" class="xref page">Users</a>, so there is
+<a href="../user/index.html#_user" class="page">Users</a>, so there is
a clear relationship between mailbox management and user management.
Because of this relationship, it is not at all strange to include a user respository
within an email system.</p>
diff --git a/james-project/3.8.0/concepts/user/index.html b/james-project/3.8.0/concepts/user/index.html
index 0c86644..a39e10e 100644
--- a/james-project/3.8.0/concepts/user/index.html
+++ b/james-project/3.8.0/concepts/user/index.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>James User Model :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -327,13 +316,6 @@
<li><a href="index.html">User Model</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="index.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/concepts/user/index.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/concepts/pages/user/index.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -346,7 +328,7 @@
<div class="sectionbody">
<div class="paragraph">
<p>For clarity, we have defined various roles for actors who interact
-with <a href="../../servers/index.html" class="xref page">James servers</a> in one way or another.
+with <a href="../../servers/index.html" class="page">James servers</a> in one way or another.
The deliverables we make available are produced with these roles in mind.
Note that any given person may play more than one role, even at the same
time.</p>
@@ -386,10 +368,10 @@
</div>
<div class="paragraph">
<p>More precisely, in typical cases a User will have an email client for reading and writing email. The
-<a href="../glossary.html" class="xref page">email client</a> will connect to the James server via
-<a href="../protocols/smtp.html" class="xref page">SMTP</a>,
-<a href="../protocols/pop.html" class="xref page">POP</a>, or
-<a href="../protocols/imap.html" class="xref page">IMAP</a>.
+<a href="../glossary.html" class="page">email client</a> will connect to the James server via
+<a href="../protocols/smtp.html" class="page">SMTP</a>,
+<a href="../protocols/pop.html" class="page">POP</a>, or
+<a href="../protocols/imap.html" class="page">IMAP</a>.
The User will have no indication anywhere that the server is a James server.</p>
</div>
</div>
@@ -406,10 +388,10 @@
</div>
<div class="paragraph">
<p>Apache James offers Operators a range of servers for various use cases, including:
- * A <a href="../../servers/basic/index.html" class="xref page">Basic Server</a> ideal for busy Operators who
+ * A <a href="../../servers/basic/index.html" class="page">Basic Server</a> ideal for busy Operators who
are interested in an easy-to-use self-hosting solution, but who may not have the
time to gain deep expertise
- * An <a href="#server/advanced/index.adoc" class="xref unresolved">Advanced Server</a> well-suited for Operators with
+ * An <a href="#server/advanced/index.adoc" class="page unresolved">Advanced Server</a> well-suited for Operators with
advanced skills and resources who are not daunted by getting their hands dirty
with configurations or using built-in extensions</p>
</div>
@@ -421,7 +403,7 @@
<div class="paragraph">
<p>An <strong>Integrator</strong> has some expertise with Java or a JVM-based language. Based
on this expertise the Integrator can perform more advanced server configurations and may
-develop <a href="#xxx.adoc" class="xref unresolved">Extensions</a> to customize the behavior of a James server.</p>
+develop <a href="#xxx.adoc" class="page unresolved">Extensions</a> to customize the behavior of a James server.</p>
</div>
<div class="paragraph">
<p>An Integrator does <strong>not</strong> need to download the source code or compile James.</p>
diff --git a/james-project/3.8.0/customization/index.html b/james-project/3.8.0/customization/index.html
index 6f032d5..79c215f 100644
--- a/james-project/3.8.0/customization/index.html
+++ b/james-project/3.8.0/customization/index.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Apache James Customization :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -326,13 +315,6 @@
<li><a href="index.html">Customization</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="index.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/customization/index.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/customization/pages/index.adoc">Edit this Page</a></div>
</div>
<div class="content">
diff --git a/james-project/3.8.0/development/deployment-tests.html b/james-project/3.8.0/development/deployment-tests.html
index 083e24a..c12162a 100644
--- a/james-project/3.8.0/development/deployment-tests.html
+++ b/james-project/3.8.0/development/deployment-tests.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>How to run deployment Tests :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -326,13 +315,6 @@
<li><a href="deployment-tests.html">How to run deployment Tests</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="deployment-tests.html">3.8.0 SNAPSHOT</a>
- <a class="version is-missing" href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/development/pages/deployment-tests.adoc">Edit this Page</a></div>
</div>
<div class="content">
diff --git a/james-project/3.8.0/development/index.html b/james-project/3.8.0/development/index.html
index 8ce07ff..cd867a3 100644
--- a/james-project/3.8.0/development/index.html
+++ b/james-project/3.8.0/development/index.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Apache James Developer Guide :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -326,13 +315,6 @@
<li><a href="index.html">Developer Guide</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="index.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/development/index.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/development/pages/index.adoc">Edit this Page</a></div>
</div>
<div class="content">
diff --git a/james-project/3.8.0/development/logging.html b/james-project/3.8.0/development/logging.html
index adfc79b..42bced2 100644
--- a/james-project/3.8.0/development/logging.html
+++ b/james-project/3.8.0/development/logging.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Logging in Apache James :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -327,13 +316,6 @@
<li><a href="logging.html">Logging in Apache James</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="logging.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/development/logging.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/development/pages/logging.adoc">Edit this Page</a></div>
</div>
<div class="content">
diff --git a/james-project/3.8.0/index.html b/james-project/3.8.0/index.html
index 25ffd63..b09ba8b 100644
--- a/james-project/3.8.0/index.html
+++ b/james-project/3.8.0/index.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Welcome :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -326,13 +315,6 @@
<li><a href="index.html">Welcome</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="index.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../3.6.0/index.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/ROOT/pages/index.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -355,7 +337,7 @@
<div class="ulist">
<ul>
<li>
-<p><a href="concepts/index.html" class="xref page">James Core Concepts</a></p>
+<p><a href="concepts/index.html" class="page">James Core Concepts</a></p>
<div class="ulist">
<ul>
<li>
@@ -367,7 +349,7 @@
</div>
</li>
<li>
-<p><a href="servers/index.html" class="xref page">James Servers</a></p>
+<p><a href="servers/index.html" class="page">James Servers</a></p>
<div class="ulist">
<ul>
<li>
@@ -379,7 +361,7 @@
</div>
</li>
<li>
-<p><a href="customization/index.html" class="xref page">Customization</a></p>
+<p><a href="customization/index.html" class="page">Customization</a></p>
<div class="ulist">
<ul>
<li>
@@ -392,7 +374,7 @@
</div>
</li>
<li>
-<p><a href="development/index.html" class="xref page">James Developer Guide</a></p>
+<p><a href="development/index.html" class="page">James Developer Guide</a></p>
<div class="ulist">
<ul>
<li>
@@ -403,7 +385,7 @@
</div>
</li>
<li>
-<p><a href="community/index.html" class="xref page">James Community</a></p>
+<p><a href="community/index.html" class="page">James Community</a></p>
<div class="ulist">
<ul>
<li>
@@ -416,7 +398,7 @@
</ul>
</div>
<div class="paragraph">
-<p>Please note that this Reference Documentation is a <strong>living document</strong>. It is subject to change. You are currently reading version 3.8.0. If you find anything that is unclear, unfinished, or confusing, please do not hestiate to <a href="community/index.html" class="xref page">lend us a hand</a>.</p>
+<p>Please note that this Reference Documentation is a <strong>living document</strong>. It is subject to change. You are currently reading version 3.8.0. If you find anything that is unclear, unfinished, or confusing, please do not hestiate to <a href="community/index.html" class="page">lend us a hand</a>.</p>
</div>
</article>
</div>
diff --git a/james-project/3.8.0/servers/15-minute-demo.html b/james-project/3.8.0/servers/15-minute-demo.html
index c0debd4..d866279 100644
--- a/james-project/3.8.0/servers/15-minute-demo.html
+++ b/james-project/3.8.0/servers/15-minute-demo.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Long Demo :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -328,13 +317,6 @@
<li><a href="15-minute-demo.html">Long Demo</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="15-minute-demo.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/servers/15-minute-demo.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/servers/pages/15-minute-demo.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -523,7 +505,7 @@
<div class="paragraph">
<p>After you have installed Thunderbird,
<a href="https://support.mozilla.org/en-US/kb/manual-account-configuration">manually set up an account</a>
-for <a href="mailto:user01@james.local">user01@james.local</a> using the following parameters:</p>
+for user01@james.local using the following parameters:</p>
</div>
<div class="ulist">
<ul>
@@ -534,7 +516,7 @@
<p>Your name: User 01</p>
</li>
<li>
-<p>Email address: <a href="mailto:user01@james.local">user01@james.local</a></p>
+<p>Email address: user01@james.local</p>
</li>
<li>
<p>SMTP server name: localhost</p>
@@ -552,7 +534,7 @@
<p>IMAP server name: localhost</p>
</li>
<li>
-<p>IMAP user name: <a href="mailto:user01@james.local">user01@james.local</a></p>
+<p>IMAP user name: user01@james.local</p>
</li>
<li>
<p>IMAP port: 143</p>
@@ -566,7 +548,7 @@
</ul>
</div>
<div class="paragraph">
-<p>Repeat the above for <a href="mailto:testuser@test.local">testuser@test.local</a>:</p>
+<p>Repeat the above for testuser@test.local:</p>
</div>
<div class="ulist">
<ul>
@@ -577,7 +559,7 @@
<p>Your name: Test User</p>
</li>
<li>
-<p>Email address: <a href="mailto:testuser@test.local">testuser@test.local</a></p>
+<p>Email address: testuser@test.local</p>
</li>
<li>
<p>SMTP server name: localhost</p>
@@ -595,7 +577,7 @@
<p>IMAP server name: localhost</p>
</li>
<li>
-<p>IMAP user name: <a href="mailto:testuser@test.local">testuser@test.local</a></p>
+<p>IMAP user name: testuser@test.local</p>
</li>
<li>
<p>IMAP port: 143</p>
@@ -705,7 +687,7 @@
</div>
<div class="listingblock">
<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">docker stop james ; docker rm james</code></pre>
+<pre class="highlightjs highlight"><code>docker stop james ; docker rm james</code></pre>
</div>
</div>
<div class="paragraph">
diff --git a/james-project/3.8.0/servers/5-minute-demo.html b/james-project/3.8.0/servers/5-minute-demo.html
index d954b47..313330c 100644
--- a/james-project/3.8.0/servers/5-minute-demo.html
+++ b/james-project/3.8.0/servers/5-minute-demo.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Short Demo :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -328,13 +317,6 @@
<li><a href="5-minute-demo.html">Short Demo</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="5-minute-demo.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/servers/5-minute-demo.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/servers/pages/5-minute-demo.adoc">Edit this Page</a></div>
</div>
<div class="content">
diff --git a/james-project/3.8.0/servers/basic/architecture.html b/james-project/3.8.0/servers/basic/architecture.html
index 8b90d6e..50f223a 100644
--- a/james-project/3.8.0/servers/basic/architecture.html
+++ b/james-project/3.8.0/servers/basic/architecture.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>James Basic Server — Architecture :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -328,13 +317,6 @@
<li><a href="architecture.html">Architecture</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="architecture.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/servers/basic/architecture.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/servers/pages/basic/architecture.adoc">Edit this Page</a></div>
</div>
<div class="content">
diff --git a/james-project/3.8.0/servers/basic/concepts.html b/james-project/3.8.0/servers/basic/concepts.html
index 9c191dc..7bcae76 100644
--- a/james-project/3.8.0/servers/basic/concepts.html
+++ b/james-project/3.8.0/servers/basic/concepts.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>James Basic Server — Background Concepts :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -328,13 +317,6 @@
<li><a href="concepts.html">Concepts</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="concepts.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/servers/basic/concepts.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/servers/pages/basic/concepts.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -350,19 +332,19 @@
<div class="ulist TODO: provide links and ensure that articles exist for each of these topics">
<ul class="TODO: provide links and ensure that articles exist for each of these topics">
<li>
-<p><a href="../../concepts/user/index.html" class="xref page">James User Model</a></p>
+<p><a href="../../concepts/user/index.html" class="page">James User Model</a></p>
</li>
<li>
-<p><a href="../../concepts/protocols/smtp.html" class="xref page">SMTP</a></p>
+<p><a href="../../concepts/protocols/smtp.html" class="page">SMTP</a></p>
</li>
<li>
-<p><a href="../../concepts/protocols/imap.html" class="xref page">IMAP</a></p>
+<p><a href="../../concepts/protocols/imap.html" class="page">IMAP</a></p>
</li>
<li>
<p>Secured email communications</p>
</li>
<li>
-<p><a href="../../concepts/storage/index.html" class="xref page">Email storage</a></p>
+<p><a href="../../concepts/storage/index.html" class="page">Email storage</a></p>
</li>
</ul>
</div>
diff --git a/james-project/3.8.0/servers/basic/conf/index.html b/james-project/3.8.0/servers/basic/conf/index.html
index 0093142..ce0e3aa 100644
--- a/james-project/3.8.0/servers/basic/conf/index.html
+++ b/james-project/3.8.0/servers/basic/conf/index.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>James Basic Mail Server Configuration :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -328,13 +317,6 @@
<li><a href="index.html">Configuration</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="index.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../../../3.6.0/servers/basic/conf/index.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/servers/pages/basic/conf/index.adoc">Edit this Page</a></div>
</div>
<div class="content">
diff --git a/james-project/3.8.0/servers/basic/context.html b/james-project/3.8.0/servers/basic/context.html
index 90febd1..2fd7308 100644
--- a/james-project/3.8.0/servers/basic/context.html
+++ b/james-project/3.8.0/servers/basic/context.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>James Basic Server — Context :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -328,13 +317,6 @@
<li><a href="context.html">Context</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="context.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/servers/basic/context.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/servers/pages/basic/context.adoc">Edit this Page</a></div>
</div>
<div class="content">
diff --git a/james-project/3.8.0/servers/basic/help.html b/james-project/3.8.0/servers/basic/help.html
index ecb8432..e67f431 100644
--- a/james-project/3.8.0/servers/basic/help.html
+++ b/james-project/3.8.0/servers/basic/help.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>James Basic Server — Where to get help :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -328,13 +317,6 @@
<li><a href="help.html">Help</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="help.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/servers/basic/help.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/servers/pages/basic/help.adoc">Edit this Page</a></div>
</div>
<div class="content">
diff --git a/james-project/3.8.0/servers/basic/index.html b/james-project/3.8.0/servers/basic/index.html
index 7bca285..a555b84 100644
--- a/james-project/3.8.0/servers/basic/index.html
+++ b/james-project/3.8.0/servers/basic/index.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>James Basic Mail Server :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -327,13 +316,6 @@
<li><a href="index.html">Basic</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="index.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/servers/basic/index.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/servers/pages/basic/index.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -343,7 +325,7 @@
<article class="doc">
<h1 class="page">James Basic Mail Server</h1>
<div class="paragraph">
-<p>The <strong>James Basic Server</strong> is intended for <a href="../../concepts/user/index.html#Operator" class="xref page">Operators</a>
+<p>The <strong>James Basic Server</strong> is intended for <a href="../../concepts/user/index.html#Operator" class="page">Operators</a>
who are just getting initiated with operating their own
<a href="#concepts/???">Self-Hosted</a> mail server.</p>
</div>
@@ -360,22 +342,22 @@
<div class="ulist">
<ul>
<li>
-<p><a href="context.html" class="xref page">The context of contemporary email</a></p>
+<p><a href="context.html" class="page">The context of contemporary email</a></p>
</li>
<li>
-<p><a href="objectives.html" class="xref page">Objectives and motivation of the Basic Server</a></p>
+<p><a href="objectives.html" class="page">Objectives and motivation of the Basic Server</a></p>
</li>
<li>
-<p><a href="concepts.html" class="xref page">Useful background concepts</a></p>
+<p><a href="concepts.html" class="page">Useful background concepts</a></p>
</li>
<li>
-<p><a href="architecture.html" class="xref page">Overview of architecture</a></p>
+<p><a href="architecture.html" class="page">Overview of architecture</a></p>
</li>
<li>
-<p><a href="conf/index.html" class="xref page">Configuration</a></p>
+<p><a href="conf/index.html" class="page">Configuration</a></p>
</li>
<li>
-<p><a href="help.html" class="xref page">Where to go for help</a></p>
+<p><a href="help.html" class="page">Where to go for help</a></p>
</li>
</ul>
</div>
diff --git a/james-project/3.8.0/servers/basic/objectives.html b/james-project/3.8.0/servers/basic/objectives.html
index fd82b37..283088c 100644
--- a/james-project/3.8.0/servers/basic/objectives.html
+++ b/james-project/3.8.0/servers/basic/objectives.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>James Basic Server — Objectives :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -328,13 +317,6 @@
<li><a href="objectives.html">Objectives</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="objectives.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/servers/basic/objectives.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/servers/pages/basic/objectives.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -394,7 +376,7 @@
<p>We have disabled all of the insecure communications and require SSL. If you have
a specific requirement to use an insecure protocol, or if the above list does not
satisfy your needs, then after having successfully set up this server you may want
-to move on to the <a href="../extendable.html" class="xref page">Extendable Server</a>.</p>
+to move on to the <a href="../extendable.html" class="page">Extendable Server</a>.</p>
</div>
</article>
</div>
diff --git a/james-project/3.8.0/servers/demo.html b/james-project/3.8.0/servers/demo.html
index 365853b..3cba7f3 100644
--- a/james-project/3.8.0/servers/demo.html
+++ b/james-project/3.8.0/servers/demo.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Server Demo :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -327,13 +316,6 @@
<li><a href="demo.html">Demo</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="demo.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/servers/demo.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/servers/pages/demo.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -349,7 +331,7 @@
<div class="ulist">
<ul>
<li>
-<p><a href="5-minute-demo.html" class="xref page">Short demo</a> (~5 minutes)</p>
+<p><a href="5-minute-demo.html" class="page">Short demo</a> (~5 minutes)</p>
<div class="ulist">
<ul>
<li>
@@ -362,7 +344,7 @@
</div>
</li>
<li>
-<p><a href="15-minute-demo.html" class="xref page">Long demo</a> (~15 minutes)</p>
+<p><a href="15-minute-demo.html" class="page">Long demo</a> (~15 minutes)</p>
<div class="ulist">
<ul>
<li>
diff --git a/james-project/3.8.0/servers/extendable.html b/james-project/3.8.0/servers/extendable.html
index 120f0b3..046307c 100644
--- a/james-project/3.8.0/servers/extendable.html
+++ b/james-project/3.8.0/servers/extendable.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>James Extendable Mail Server :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -327,13 +316,6 @@
<li><a href="extendable.html">Extendable</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="extendable.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/servers/extendable.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/servers/pages/extendable.adoc">Edit this Page</a></div>
</div>
<div class="content">
diff --git a/james-project/3.8.0/servers/index.html b/james-project/3.8.0/servers/index.html
index 6066af2..e63a480 100644
--- a/james-project/3.8.0/servers/index.html
+++ b/james-project/3.8.0/servers/index.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Apache James Mail Servers :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -326,13 +315,6 @@
<li><a href="index.html">Servers</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="index.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/servers/index.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/servers/pages/index.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -345,9 +327,9 @@
<div class="sectionbody">
<div class="paragraph">
<p>James offers five types of ready-made Mail Servers. The servers are intended
-for those with different needs, ranging from <a href="../concepts/user/index.html#Operators" class="xref page">Operators</a>
+for those with different needs, ranging from <a href="../concepts/user/index.html#Operators" class="page">Operators</a>
who are interested in setting up a server for the first time, to experienced teams of
-<a href="../concepts/user/index.html#Developer" class="xref page">Developers</a>
+<a href="../concepts/user/index.html#Developer" class="page">Developers</a>
looking to deploy an advanced distributed system.
Each of the servers has been tested and verified so you can
deploy a production-grade
@@ -398,7 +380,7 @@
<h2 id="demo"><a class="anchor" href="#demo"></a>James Demo Server</h2>
<div class="sectionbody">
<div class="paragraph">
-<p>The <a href="demo.html" class="xref page">Demo Server</a> is intended for those who just want
+<p>The <a href="demo.html" class="page">Demo Server</a> is intended for those who just want
to give James a quick spin on their local machine to see what all
the fuss is about.</p>
</div>
@@ -410,7 +392,7 @@
<div class="paragraph">
<p>If you just want to get up and running quickly, if you have very simple needs,
or you want to try deploying a mail server for the first time, then the
-<a href="basic/index.html" class="xref page"><strong>Basic Server</strong></a> is the right choice for you. If you are
+<a href="basic/index.html" class="page"><strong>Basic Server</strong></a> is the right choice for you. If you are
not sure which server you should be using, then this server is probably the right
choice.</p>
</div>
@@ -420,7 +402,7 @@
The last thing you need is
to have to resolve difficult issues on a production server when you have not
yet acquired the requisite knowledge to deal with those issues. Using the
-<a href="basic/index.html" class="xref page"><strong>Basic Server</strong></a> will help you reduce the risk of running into
+<a href="basic/index.html" class="page"><strong>Basic Server</strong></a> will help you reduce the risk of running into
production issues.</p>
</div>
</div>
@@ -431,7 +413,7 @@
<div class="paragraph">
<p>When your requirements start to get a little more serious, or you
start to feel adventurous and want to begin your own email adventure,
-you can consider using the <a href="extendable.html" class="xref page"><strong>Extendable Server</strong></a>.</p>
+you can consider using the <a href="extendable.html" class="page"><strong>Extendable Server</strong></a>.</p>
</div>
<div class="paragraph">
<p>This server is intended for experts who understand the consequences of
@@ -447,7 +429,7 @@
<h2 id="distributed"><a class="anchor" href="#distributed"></a>James Distributed Mail Server</h2>
<div class="sectionbody">
<div class="paragraph">
-<p>The <a href="../../../james-distributed-app/3.8.0/index.html" class="xref page"><strong>Distributed Server</strong></a> is a heavy-duty industrial
+<p>The <a href="#james-distributed-app:ROOT:index.adoc" class="page unresolved"><strong>Distributed Server</strong></a> is a heavy-duty industrial
enterprise mail server.</p>
</div>
<div class="paragraph">
@@ -460,7 +442,7 @@
<h2 id="test"><a class="anchor" href="#test"></a>James Test Server</h2>
<div class="sectionbody">
<div class="paragraph">
-<p>The <a href="test.html" class="xref page"><strong>Test Server</strong></a> is, as the name suggests, for testing purposes.</p>
+<p>The <a href="test.html" class="page"><strong>Test Server</strong></a> is, as the name suggests, for testing purposes.</p>
</div>
</div>
</div>
diff --git a/james-project/3.8.0/servers/run.html b/james-project/3.8.0/servers/run.html
index d2c4efa..7cb6662 100644
--- a/james-project/3.8.0/servers/run.html
+++ b/james-project/3.8.0/servers/run.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Run James in Production :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -326,13 +315,6 @@
<li><a href="run.html">Run James in Production</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="run.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/servers/run.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/servers/pages/run.adoc">Edit this Page</a></div>
</div>
<div class="content">
diff --git a/james-project/3.8.0/servers/test.html b/james-project/3.8.0/servers/test.html
index fd115da..d96b0e1 100644
--- a/james-project/3.8.0/servers/test.html
+++ b/james-project/3.8.0/servers/test.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>James Test Server :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.0 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.0/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.0/index.html">3.8.0 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.0 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -327,13 +316,6 @@
<li><a href="test.html">Test</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.0 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="test.html">3.8.0 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/servers/test.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/servers/pages/test.adoc">Edit this Page</a></div>
</div>
<div class="content">
diff --git a/james-project/3.8.1/community/contributing.html b/james-project/3.8.1/community/contributing.html
index c38da3c..0aad128 100644
--- a/james-project/3.8.1/community/contributing.html
+++ b/james-project/3.8.1/community/contributing.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Contributing :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -327,13 +316,6 @@
<li><a href="contributing.html">Contributing</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="contributing.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/community/contributing.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/community/pages/contributing.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -348,7 +330,7 @@
<p>This document defines the different ways available for contributing to the Apache James project.</p>
</div>
<div class="paragraph">
-<p>To keep you informed on James issues, subscribe to the relevant <a href="mailing-lists.html" class="xref page">mailing lists</a>.</p>
+<p>To keep you informed on James issues, subscribe to the relevant <a href="mailing-lists.html" class="page">mailing lists</a>.</p>
</div>
</div>
</div>
@@ -360,7 +342,7 @@
</div>
<div class="paragraph">
<p>Share your experiences with James, your needs, your enhancements proposition via the
-<a href="mailing-lists.html" class="xref page">mailing lists</a>, on <a href="https://gitter.im/apache/james-project">Gitter</a>, or on our
+<a href="mailing-lists.html" class="page">mailing lists</a>, on <a href="https://gitter.im/apache/james-project">Gitter</a>, or on our
<a href="https://issues.apache.org/jira/projects/JAMES/issues">Bug Tracker</a>.</p>
</div>
<div class="paragraph">
@@ -460,7 +442,7 @@
<div class="sectionbody">
<div class="paragraph">
<p>People can submit ideas, features or design changes proposals by discussing it through the
-<a href="mailing-lists.html" class="xref page">mailing lists</a>.</p>
+<a href="mailing-lists.html" class="page">mailing lists</a>.</p>
</div>
<div class="paragraph">
<p>Structuring design changes are tracked by <a href="https://github.com/joelparkerhenderson/architecture-decision-record">ADRs</a>
@@ -490,7 +472,7 @@
<h2 id="_how_to_contribute_some_code"><a class="anchor" href="#_how_to_contribute_some_code"></a>How to contribute some code?</h2>
<div class="sectionbody">
<div class="paragraph">
-<p>We encourage discussions prior code contributions on the <a href="mailing-lists.html" class="xref page">mailing lists</a>. For significant design
+<p>We encourage discussions prior code contributions on the <a href="mailing-lists.html" class="page">mailing lists</a>. For significant design
changes the writing of <a href="#_idea_or_design_proposals">ADRs</a> is encouraged.</p>
</div>
<div class="paragraph">
@@ -521,7 +503,7 @@
</div>
<div class="listingblock">
<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">JAMES-2285 My awesome commit title
+<pre class="highlightjs highlight"><code>JAMES-2285 My awesome commit title
Here is some more details about what my commit does, and the rationals of the choice I took.</code></pre>
</div>
@@ -621,7 +603,7 @@
</div>
<div class="listingblock">
<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">mvn validate</code></pre>
+<pre class="highlightjs highlight"><code>mvn validate</code></pre>
</div>
</div>
<div class="paragraph">
@@ -629,7 +611,7 @@
</div>
<div class="listingblock">
<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">mvn validate -PsortPom</code></pre>
+<pre class="highlightjs highlight"><code>mvn validate -PsortPom</code></pre>
</div>
</div>
<div class="paragraph">
diff --git a/james-project/3.8.1/community/download.html b/james-project/3.8.1/community/download.html
index 4ef927c..f9b2dad 100644
--- a/james-project/3.8.1/community/download.html
+++ b/james-project/3.8.1/community/download.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Download Apache James releases :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -327,13 +316,6 @@
<li><a href="download.html">Download releases</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="download.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/community/download.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/community/pages/download.adoc">Edit this Page</a></div>
</div>
<div class="content">
diff --git a/james-project/3.8.1/community/guidelines.html b/james-project/3.8.1/community/guidelines.html
index 28a5369..122fa39 100644
--- a/james-project/3.8.1/community/guidelines.html
+++ b/james-project/3.8.1/community/guidelines.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Apache James Project guidelines :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -327,13 +316,6 @@
<li><a href="guidelines.html">Guidelines</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="guidelines.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/community/guidelines.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/community/pages/guidelines.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -391,7 +373,7 @@
<h3 id="_mailing_list"><a class="anchor" href="#_mailing_list"></a>Mailing list</h3>
<div class="paragraph">
<p>The Apache committers' primary mailing list for discussion of issues and changes related to the project
-(<a href="mailing-lists.html#_server_developer_list" class="xref page"><a href="mailto:server-dev@james.apache.org">server-dev@james.apache.org</a></a>). Subscription to the list is open, but
+(<a href="mailing-lists.html#_server_developer_list" class="page"><a href="mailto:server-dev@james.apache.org">server-dev@james.apache.org</a></a>). Subscription to the list is open, but
only subscribers can post directly to the list.</p>
</div>
</div>
@@ -416,7 +398,7 @@
<p>Discussions of <a href="https://community.apache.org/newcommitter.html">new committers, new PMCs</a>, including proposition discussions, votes and process follow up.</p>
</li>
<li>
-<p>Handling of <a href="contributing.html#_reporting_security_vulnerabilities" class="xref page">security vulnerability reports</a>, and CVE publication.</p>
+<p>Handling of <a href="contributing.html#_reporting_security_vulnerabilities" class="page">security vulnerability reports</a>, and CVE publication.</p>
</li>
</ul>
</div>
@@ -442,8 +424,8 @@
</div>
<div class="paragraph">
<p>We actively rely on <a href="https://community.apache.org/committers/lazyConsensus.html">lazy consensus</a> for most of our
-decisions, be them validating <a href="contributing.html#_how_to_contribute_some_code" class="xref page">code changes</a>, enacting
-<a href="contributing.html#_idea_or_design_proposals" class="xref page">design decisions</a>.</p>
+decisions, be them validating <a href="contributing.html#_how_to_contribute_some_code" class="page">code changes</a>, enacting
+<a href="contributing.html#_idea_or_design_proposals" class="page">design decisions</a>.</p>
</div>
<div class="paragraph">
<p>All code modifications should achieve lazy consensus under the form of GitHub pull requests.</p>
@@ -456,7 +438,7 @@
<div class="ulist">
<ul>
<li>
-<p><a href="release.html" class="xref page">releases</a></p>
+<p><a href="release.html" class="page">releases</a></p>
</li>
<li>
<p>establishing a new sub-project</p>
diff --git a/james-project/3.8.1/community/index.html b/james-project/3.8.1/community/index.html
index e8de086..2307280 100644
--- a/james-project/3.8.1/community/index.html
+++ b/james-project/3.8.1/community/index.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Apache James Community :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -326,13 +315,6 @@
<li><a href="index.html">Community</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="index.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/community/index.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/community/pages/index.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -361,7 +343,7 @@
<p><a href="https://james.apache.org/">Apache James Website</a></p>
</li>
<li>
-<p><a href="mailing-lists.html" class="xref page">Mailing lists</a>: Subscribe to the appropriate Mailing Lists according to your interests and profile.</p>
+<p><a href="mailing-lists.html" class="page">Mailing lists</a>: Subscribe to the appropriate Mailing Lists according to your interests and profile.</p>
</li>
<li>
<p><a href="https://gitter.im/apache/james-project">Gitter chat room</a>: Chat in live with the community on Gitter.</p>
@@ -379,10 +361,10 @@
<p><a href="https://builds.apache.org/job/ApacheJames/">CI</a>: Check the status of James builds on our Jenkins CI.</p>
</li>
<li>
-<p><a href="download.html" class="xref page">Download releases</a>: Download artifacts and sources your need for the James Server and James libraries.</p>
+<p><a href="download.html" class="page">Download releases</a>: Download artifacts and sources your need for the James Server and James libraries.</p>
</li>
<li>
-<p><a href="support.html" class="xref page">Professional support</a>: Find a list of companies which can provide you some support on James.</p>
+<p><a href="support.html" class="page">Professional support</a>: Find a list of companies which can provide you some support on James.</p>
</li>
</ul>
</div>
@@ -399,7 +381,7 @@
and bug reports. We more than welcome non-coding contributions.</p>
</div>
<div class="paragraph">
-<p>You can find more information on how to contribute to the James project on the <a href="contributing.html" class="xref page">contributing</a> section.</p>
+<p>You can find more information on how to contribute to the James project on the <a href="contributing.html" class="page">contributing</a> section.</p>
</div>
</div>
</div>
@@ -409,10 +391,10 @@
<div class="ulist">
<ul>
<li>
-<p><a href="website.html" class="xref page">Building and publishing the website</a></p>
+<p><a href="website.html" class="page">Building and publishing the website</a></p>
</li>
<li>
-<p><a href="release.html" class="xref page">Creating an official Apache James release</a></p>
+<p><a href="release.html" class="page">Creating an official Apache James release</a></p>
</li>
</ul>
</div>
@@ -423,7 +405,7 @@
<div class="sectionbody">
<div class="paragraph">
<p>James is a project belonging to the <a href="https://www.apache.org/">Apache Software Foundation [ASF]</a>. Thus, the Apache Jame project
-is governed by a number of <a href="guidelines.html" class="xref page">guidelines</a> directly depending on the <strong>ASF</strong>.</p>
+is governed by a number of <a href="guidelines.html" class="page">guidelines</a> directly depending on the <strong>ASF</strong>.</p>
</div>
<div class="paragraph">
<p>If you wish to get more involved with the <strong>ASF</strong> community in general, those links might interest you as well:</p>
diff --git a/james-project/3.8.1/community/mailing-lists.html b/james-project/3.8.1/community/mailing-lists.html
index a9019fc..0bddb3f 100644
--- a/james-project/3.8.1/community/mailing-lists.html
+++ b/james-project/3.8.1/community/mailing-lists.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Mailing lists :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -327,13 +316,6 @@
<li><a href="mailing-lists.html">Mailing lists</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="mailing-lists.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/community/mailing-lists.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/community/pages/mailing-lists.adoc">Edit this Page</a></div>
</div>
<div class="content">
diff --git a/james-project/3.8.1/community/release.html b/james-project/3.8.1/community/release.html
index 1b66de2..c7a2dd8 100644
--- a/james-project/3.8.1/community/release.html
+++ b/james-project/3.8.1/community/release.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Creating an official Apache James release :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -327,13 +316,6 @@
<li><a href="release.html">Creating an official Apache James release</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="release.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/community/release.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/community/pages/release.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -482,7 +464,7 @@
</div>
<div class="listingblock">
<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">Subject: Call for vote: Apache James x.x.x
+<pre class="highlightjs highlight"><code>Subject: Call for vote: Apache James x.x.x
Hi,
@@ -522,7 +504,7 @@
</div>
<div class="listingblock">
<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">Hi all,
+<pre class="highlightjs highlight"><code>Hi all,
I am happy to announce you the vote for the x.x.x release did succeed.
@@ -553,7 +535,7 @@
</div>
<div class="listingblock">
<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">mkdir server/3.x.x
+<pre class="highlightjs highlight"><code>mkdir server/3.x.x
cd server/3.x.x
svn add .</code></pre>
</div>
@@ -576,7 +558,7 @@
</div>
<div class="listingblock">
<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">% cat /usr/local/bin/auto_sig
+<pre class="highlightjs highlight"><code>% cat /usr/local/bin/auto_sig
#/bin/bash
# This quick bash scipt intend to help commiters
@@ -610,7 +592,7 @@
</div>
<div class="listingblock">
<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">svn rm 3.5.0
+<pre class="highlightjs highlight"><code>svn rm 3.5.0
svn commit -m "Archive James release 3.5.0"</code></pre>
</div>
</div>
diff --git a/james-project/3.8.1/community/support.html b/james-project/3.8.1/community/support.html
index 4ccb0c9..d116acf 100644
--- a/james-project/3.8.1/community/support.html
+++ b/james-project/3.8.1/community/support.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Professional support :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -327,13 +316,6 @@
<li><a href="support.html">Professional support</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="support.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/community/support.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/community/pages/support.adoc">Edit this Page</a></div>
</div>
<div class="content">
diff --git a/james-project/3.8.1/community/website.html b/james-project/3.8.1/community/website.html
index 57526cc..6896a50 100644
--- a/james-project/3.8.1/community/website.html
+++ b/james-project/3.8.1/community/website.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Building and publishing the website :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -327,13 +316,6 @@
<li><a href="website.html">Building and publishing the website</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="website.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/community/website.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/community/pages/website.adoc">Edit this Page</a></div>
</div>
<div class="content">
diff --git a/james-project/3.8.1/concepts/configuration.html b/james-project/3.8.1/concepts/configuration.html
index 7cdbe61..3f3b369 100644
--- a/james-project/3.8.1/concepts/configuration.html
+++ b/james-project/3.8.1/concepts/configuration.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Configuration :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -327,13 +316,6 @@
<li><a href="configuration.html">Configuration</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="configuration.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/concepts/configuration.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/concepts/pages/configuration.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -354,7 +336,7 @@
</div>
<div class="paragraph">
<p>A "<strong>Configuration</strong>" is a <a href="https://martinfowler.com/bliki/ValueObject.html">value object</a>
-that communicates to a James server how the <a href="user/index.html#_operator" class="xref page">Operator</a> wishes the
+that communicates to a James server how the <a href="user/index.html#_operator" class="page">Operator</a> wishes the
server to behave. It is very similar to an interface, but yet it is not quite an interface
(which is why we call it something different).</p>
</div>
@@ -362,7 +344,7 @@
<p>An "interface" provides a means for an Operator to interact with a server as part of the
normal course of ongoing operations. Interfacing with the system essentially means either
reading the server’s current state, or updating the server’s current state. A typical example
-would be adding a new mailbox via the <a href="#concepts:???.adoc" class="xref unresolved">Useradmin API</a>. Each time the Operator
+would be adding a new mailbox via the <a href="#concepts:???.adoc" class="page unresolved">Useradmin API</a>. Each time the Operator
interacts with the system via an interface, although the <strong>state</strong> of the system may change,
the <strong>behavior</strong> of the system is not expected to change.</p>
</div>
diff --git a/james-project/3.8.1/concepts/glossary.html b/james-project/3.8.1/concepts/glossary.html
index 9ae6876..906a01c 100644
--- a/james-project/3.8.1/concepts/glossary.html
+++ b/james-project/3.8.1/concepts/glossary.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Glossary :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -327,13 +316,6 @@
<li><a href="glossary.html">Glossary</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="glossary.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/concepts/glossary.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/concepts/pages/glossary.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -348,7 +330,7 @@
<dd>
<p>Any software application that acts as a POP Client or an IMAP Client.</p>
</dd>
-<dt class="hdlist1"><a href="messages/imf.html" class="xref page">IMF</a></dt>
+<dt class="hdlist1"><a href="messages/imf.html" class="page">IMF</a></dt>
<dd>
<p><strong>Internet Message Format</strong> (IMF) is the base specification that defines the
syntax of an email message.</p>
@@ -375,7 +357,7 @@
IMAP Clients.</p>
</dd>
<dt class="hdlist1">JMAP</dt>
-<dt class="hdlist1"><a href="messages/mime.html" class="xref page">MIME</a></dt>
+<dt class="hdlist1"><a href="messages/mime.html" class="page">MIME</a></dt>
<dd>
<p><strong>Multipurpose Internet Mail Extension</strong> (MIME) is a specification that extends
IMF, defining most of the "advanced" features of email.</p>
@@ -396,7 +378,7 @@
final MTA on the terminating side of a transmission. It is in some respects similar to
an MTA, but is local in scope and does not necessarily follow a known specification.</p>
</dd>
-<dt class="hdlist1"><a href="protocols/smtp.html" class="xref page">SMTP</a></dt>
+<dt class="hdlist1"><a href="protocols/smtp.html" class="page">SMTP</a></dt>
<dd>
<p><strong>Simple Mail Transfer Protocol</strong> (SMTP) is a protocol that specifies how to transmit
a valid email message from one MTA to another.</p>
diff --git a/james-project/3.8.1/concepts/index.html b/james-project/3.8.1/concepts/index.html
index fcbcb68..54cac7d 100644
--- a/james-project/3.8.1/concepts/index.html
+++ b/james-project/3.8.1/concepts/index.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Apache James Core Concepts :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -326,13 +315,6 @@
<li><a href="index.html">Concepts</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="index.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/concepts/index.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/concepts/pages/index.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -376,7 +358,7 @@
write "mail".</p>
</div>
<div class="paragraph">
-<p><a href="mail/index.html" class="xref page">Email messages</a> are based on a few specifications
+<p><a href="mail/index.html" class="page">Email messages</a> are based on a few specifications
that are not easy to digest, so we make an effort to provide a simplified
model.</p>
</div>
@@ -390,7 +372,7 @@
To allow for this, obviously there must be a means of transmitting messages
from one user to another. A number of different protocols have emerged to
handle the various different requirements of using email in a practical
-manner. The most common <a href="protocols/index.html" class="xref page">transmission protocols</a>
+manner. The most common <a href="protocols/index.html" class="page">transmission protocols</a>
are SMTP, POP, and IMAP. More recently JMAP is an interesting protocol
that merits attention.</p>
</div>
@@ -404,7 +386,7 @@
a message would self-destruct immediately after being read.
For those of us who are not secret agents, we generally prefer to keep
a record of those messages that we receive. For this reason we need a means
-of <a href="storage/index.html" class="xref page">storing messages</a>.</p>
+of <a href="storage/index.html" class="page">storing messages</a>.</p>
</div>
</div>
</div>
@@ -413,7 +395,7 @@
<div class="sectionbody">
<div class="paragraph">
<p>There are many ways to peel a potato. James has its own particular
-<a href="processing/index.html" class="xref page">model for processing mail</a>,
+<a href="processing/index.html" class="page">model for processing mail</a>,
based mostly on the concept of a "Mailet". The idea of Mailet-based
processing was heavily inspired by the <a href="https://en.wikipedia.org/wiki/Java_servlet">Servlet</a>
concept.</p>
diff --git a/james-project/3.8.1/concepts/mail/index.html b/james-project/3.8.1/concepts/mail/index.html
index 622c0f0..c7d557b 100644
--- a/james-project/3.8.1/concepts/mail/index.html
+++ b/james-project/3.8.1/concepts/mail/index.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>All About Emails :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -327,13 +316,6 @@
<li><a href="index.html">Emails</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="index.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/concepts/mail/index.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/concepts/pages/mail/index.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -358,10 +340,10 @@
<div class="ulist">
<ul>
<li>
-<p><a href="../messages/index.html" class="xref page">Email Messages</a></p>
+<p><a href="../messages/index.html" class="page">Email Messages</a></p>
</li>
<li>
-<p><a href="../protocols/index.html" class="xref page">Transmission Protocols</a></p>
+<p><a href="../protocols/index.html" class="page">Transmission Protocols</a></p>
</li>
</ul>
</div>
diff --git a/james-project/3.8.1/concepts/messages/imf.html b/james-project/3.8.1/concepts/messages/imf.html
index 2614dc2..aea1232 100644
--- a/james-project/3.8.1/concepts/messages/imf.html
+++ b/james-project/3.8.1/concepts/messages/imf.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Internet Message Format :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -329,13 +318,6 @@
<li><a href="imf.html">IMF</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="imf.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/concepts/messages/imf.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/concepts/pages/messages/imf.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -358,7 +340,7 @@
<div class="paragraph">
<p>IMF is very basic, and is limited to only specifying a syntax for text messages.
For the transmission of images, audio, or other types of data we need to make
-use of the <a href="#mail/messages/mime.adoc" class="xref unresolved">MIME</a> specification.
+use of the <a href="#mail/messages/mime.adoc" class="page unresolved">MIME</a> specification.
Although IMF forms the base standard upon which
email is based, email today is rarely used without MIME. We therefore consider
for practical purposes that an email message is essentially the equivalent of
diff --git a/james-project/3.8.1/concepts/messages/index.html b/james-project/3.8.1/concepts/messages/index.html
index fa7fcc2..8771c3a 100644
--- a/james-project/3.8.1/concepts/messages/index.html
+++ b/james-project/3.8.1/concepts/messages/index.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Email Messages :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -328,13 +317,6 @@
<li><a href="index.html">Messages</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="index.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/concepts/messages/index.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/concepts/pages/messages/index.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -357,10 +339,10 @@
<div class="ulist">
<ul>
<li>
-<p><a href="imf.html" class="xref page">Internet Mail Format</a> (IMF)</p>
+<p><a href="imf.html" class="page">Internet Mail Format</a> (IMF)</p>
</li>
<li>
-<p><a href="mime.html" class="xref page">Multipurpose Internet Mail Extensions</a> (MIME)</p>
+<p><a href="mime.html" class="page">Multipurpose Internet Mail Extensions</a> (MIME)</p>
</li>
</ul>
</div>
diff --git a/james-project/3.8.1/concepts/messages/mime.html b/james-project/3.8.1/concepts/messages/mime.html
index 0fd2166..60f0e93 100644
--- a/james-project/3.8.1/concepts/messages/mime.html
+++ b/james-project/3.8.1/concepts/messages/mime.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Multipurpose Internet Mail Extensions :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -329,13 +318,6 @@
<li><a href="mime.html">MIME</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="mime.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/concepts/messages/mime.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/concepts/pages/messages/mime.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -348,7 +330,7 @@
<h2 id="_overview"><a class="anchor" href="#_overview"></a>Overview</h2>
<div class="sectionbody">
<div class="paragraph">
-<p>The base format of an email message is <a href="imf.html" class="xref page">Internet Message Format"</a>,
+<p>The base format of an email message is <a href="imf.html" class="page">Internet Message Format"</a>,
but most contemporary messages use a format called
<a href="https://en.wikipedia.org/wiki/MIME">"Multipurpose Internet Mail Extensions"</a>.
MIME specifies how to extend a valid IMF message, dealing with character encodings,
diff --git a/james-project/3.8.1/concepts/processing/index.html b/james-project/3.8.1/concepts/processing/index.html
index 4f68856..97d45fe 100644
--- a/james-project/3.8.1/concepts/processing/index.html
+++ b/james-project/3.8.1/concepts/processing/index.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Mail Processing Domain Model :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -327,13 +316,6 @@
<li><a href="index.html">Processing</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="index.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/concepts/processing/index.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/concepts/pages/processing/index.adoc">Edit this Page</a></div>
</div>
<div class="content">
diff --git a/james-project/3.8.1/concepts/protocols/esmtp.html b/james-project/3.8.1/concepts/protocols/esmtp.html
index 320323b..3e0a0b2 100644
--- a/james-project/3.8.1/concepts/protocols/esmtp.html
+++ b/james-project/3.8.1/concepts/protocols/esmtp.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>SMTP Service Extensions (ESMTP) :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -328,13 +317,6 @@
<li><a href="esmtp.html">ESMTP</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="esmtp.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/concepts/protocols/esmtp.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/concepts/pages/protocols/esmtp.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -388,7 +370,7 @@
<div class="paragraph">
<p><a href="https://tools.ietf.org/html/rfc1869">RFC1869</a> ("SMTP Service Extensions") obsoletes <a href="#_rfc1651">RFC1651</a>, and
is essentially the final specification in which ESMTP was defined separately from SMTP. When this
-spec was obsoleted by <a href="smtp.html#RFC2821" class="xref page">RFC2821</a>, it was incorporated into the
+spec was obsoleted by <a href="smtp.html#RFC2821" class="page">RFC2821</a>, it was incorporated into the
SMTP specification.</p>
</div>
</div>
@@ -400,10 +382,10 @@
<div class="ulist">
<ul>
<li>
-<p><strong><a href="smtp.html" class="xref page">SMTP</a></strong>, because ESMTP defines an extension framework for SMTP</p>
+<p><strong><a href="smtp.html" class="page">SMTP</a></strong>, because ESMTP defines an extension framework for SMTP</p>
</li>
<li>
-<p><strong><a href="lmtp.html" class="xref page">LMTP</a></strong>, as LMTP is defined by the ESMTP framework</p>
+<p><strong><a href="lmtp.html" class="page">LMTP</a></strong>, as LMTP is defined by the ESMTP framework</p>
</li>
</ul>
</div>
diff --git a/james-project/3.8.1/concepts/protocols/imap.html b/james-project/3.8.1/concepts/protocols/imap.html
index f993950..a608b9c 100644
--- a/james-project/3.8.1/concepts/protocols/imap.html
+++ b/james-project/3.8.1/concepts/protocols/imap.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Internet Message Access Protocol (IMAP) :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -328,13 +317,6 @@
<li><a href="imap.html">IMAP</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="imap.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/concepts/protocols/imap.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/concepts/pages/protocols/imap.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -349,8 +331,8 @@
<div class="paragraph">
<p><a href="https://en.wikipedia.org/wiki/Internet_Message_Access_Protocol">Internet Message Access Protocol</a>,
or IMAP, is a protocol used by email clients to retrieve
-<a href="../messages/index.html" class="xref page">email messages</a> from a <a href="../glossary.html#email_server" class="xref page">mail server</a>.
-One could say that it is effectively in competition with <a href="pop.html" class="xref page">POP</a>
+<a href="../messages/index.html" class="page">email messages</a> from a <a href="../glossary.html#email_server" class="page">mail server</a>.
+One could say that it is effectively in competition with <a href="pop.html" class="page">POP</a>
because it accomplishes a function similar in nature, and most clients will force you
to choose one or the other.
These days, the natural choice of protocol tends to be IMAP rather than POP.</p>
@@ -497,14 +479,14 @@
<div class="ulist">
<ul>
<li>
-<p><strong><a href="pop.html" class="xref page">POP</a></strong> as a "competing" protocol</p>
+<p><strong><a href="pop.html" class="page">POP</a></strong> as a "competing" protocol</p>
</li>
<li>
-<p><strong><a href="../glossary.html#email_client" class="xref page">Email clients</a></strong>, as the client will provide the functionality of
+<p><strong><a href="../glossary.html#email_client" class="page">Email clients</a></strong>, as the client will provide the functionality of
an IMAP Client and connect to the IMAP Server</p>
</li>
<li>
-<p><strong><a href="smtp.html" class="xref page">SMTP</a></strong>, in that messages will normally be
+<p><strong><a href="smtp.html" class="page">SMTP</a></strong>, in that messages will normally be
delivered to the IMAP Server via SMTP.</p>
</li>
</ul>
diff --git a/james-project/3.8.1/concepts/protocols/index.html b/james-project/3.8.1/concepts/protocols/index.html
index 44415a5..973fe5b 100644
--- a/james-project/3.8.1/concepts/protocols/index.html
+++ b/james-project/3.8.1/concepts/protocols/index.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Transmission Protocols :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -327,13 +316,6 @@
<li><a href="index.html">Protocols</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="index.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/concepts/protocols/index.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/concepts/pages/protocols/index.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -345,7 +327,7 @@
<div class="paragraph">
<p>The true value of email is that any one party can communicate with any
other party located virtually anywhere. All they need are a common understanding
-of a <a href="../messages/index.html" class="xref page">message format</a>, and a means of
+of a <a href="../messages/index.html" class="page">message format</a>, and a means of
transmitting the message.</p>
</div>
<div class="paragraph">
@@ -356,19 +338,19 @@
<div class="ulist">
<ul>
<li>
-<p><a href="smtp.html" class="xref page">Simple Mail Transfer</a></p>
+<p><a href="smtp.html" class="page">Simple Mail Transfer</a></p>
</li>
<li>
-<p><a href="pop.html" class="xref page">Post Office</a></p>
+<p><a href="pop.html" class="page">Post Office</a></p>
</li>
<li>
-<p><a href="imap.html" class="xref page">Internet Message Access</a></p>
+<p><a href="imap.html" class="page">Internet Message Access</a></p>
</li>
<li>
-<p><a href="jmap.html" class="xref page">JSON Meta Application</a></p>
+<p><a href="jmap.html" class="page">JSON Meta Application</a></p>
</li>
<li>
-<p><a href="lmtp.html" class="xref page">Local Mail Transfer</a></p>
+<p><a href="lmtp.html" class="page">Local Mail Transfer</a></p>
</li>
</ul>
</div>
diff --git a/james-project/3.8.1/concepts/protocols/jmap.html b/james-project/3.8.1/concepts/protocols/jmap.html
index f850c18..5b77a74 100644
--- a/james-project/3.8.1/concepts/protocols/jmap.html
+++ b/james-project/3.8.1/concepts/protocols/jmap.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>JSON Meta Application Protocol (JMAP) :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -328,13 +317,6 @@
<li><a href="jmap.html">JMAP</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="jmap.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/concepts/protocols/jmap.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/concepts/pages/protocols/jmap.adoc">Edit this Page</a></div>
</div>
<div class="content">
diff --git a/james-project/3.8.1/concepts/protocols/lmtp.html b/james-project/3.8.1/concepts/protocols/lmtp.html
index 6cf7a69..b650797 100644
--- a/james-project/3.8.1/concepts/protocols/lmtp.html
+++ b/james-project/3.8.1/concepts/protocols/lmtp.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Local Mail Transfer Protocol (LMTP) :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -328,13 +317,6 @@
<li><a href="lmtp.html">LMTP</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="lmtp.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/concepts/protocols/lmtp.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/concepts/pages/protocols/lmtp.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -372,7 +354,7 @@
<div class="paragraph">
<p><a href="https://tools.ietf.org/html/rfc2033">RFC2033</a> ("Local Mail Transfer Protocol") was published
in 1996, and defines a simplified protocol for local mail delivery mainly inspired by
-<a href="esmtp.html" class="xref page">ESMTP</a>. It is the first, last, and only specification of its kind.</p>
+<a href="esmtp.html" class="page">ESMTP</a>. It is the first, last, and only specification of its kind.</p>
</div>
</div>
</div>
@@ -386,7 +368,7 @@
<div class="ulist">
<ul>
<li>
-<p><strong><a href="esmtp.html" class="xref page">ESMTP</a></strong>, as it is a derivative thereof</p>
+<p><strong><a href="esmtp.html" class="page">ESMTP</a></strong>, as it is a derivative thereof</p>
</li>
</ul>
</div>
diff --git a/james-project/3.8.1/concepts/protocols/pop.html b/james-project/3.8.1/concepts/protocols/pop.html
index d12a6d1..b032b1b 100644
--- a/james-project/3.8.1/concepts/protocols/pop.html
+++ b/james-project/3.8.1/concepts/protocols/pop.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Post Office Protocol (POP) :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -328,13 +317,6 @@
<li><a href="pop.html">POP</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="pop.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/concepts/protocols/pop.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/concepts/pages/protocols/pop.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -350,11 +332,11 @@
<p>The <a href="https://en.wikipedia.org/wiki/Post_Office_Protocol">Post Office Protocol</a>,
or POP, is described in the original specification
as being "a simple method for workstations to dynamically access mail from
-a <a href="../storage/index.html" class="xref page">mailbox server</a>" (though interestingly "mailbox server"
+a <a href="../storage/index.html" class="page">mailbox server</a>" (though interestingly "mailbox server"
is never actually defined in this specification nor in later specifications. 🤔)</p>
</div>
<div class="paragraph">
-<p>POP was proposed as the first non-<a href="smtp.html" class="xref page">SMTP</a> protocol aimed
+<p>POP was proposed as the first non-<a href="smtp.html" class="page">SMTP</a> protocol aimed
at users for the purpose of retrieving emails stored remotely for local consumption.
POP was developed in pre-spam days, so was inherently a non-secure protocol.
It has been updated several times to address several issues, including lack of
@@ -406,7 +388,7 @@
<p><a href="https://tools.ietf.org/html/rfc918">RFC918</a> ("Post Office Protocol") was the original
specification published in 1984. The RFC "suggests a simple method for workstations
to dynamically access mail from a mailbox server."
-Like <a href="smtp.html" class="xref page">SMTP</a> that came before it, POP is a session-based
+Like <a href="smtp.html" class="page">SMTP</a> that came before it, POP is a session-based
protocol with a handful of defined commands.
This RFC was obsoleted shortly after its publication by <a href="#_rfc937">RFC937</a>.</p>
</div>
@@ -474,7 +456,7 @@
</div>
<div class="paragraph">
<p>This specification seems to imply that POP3 is used for "simple" transactions,
-and for more "advanced" transactions <a href="imap.html" class="xref page">IMAP</a> is available.</p>
+and for more "advanced" transactions <a href="imap.html" class="page">IMAP</a> is available.</p>
</div>
</div>
</div>
@@ -497,17 +479,17 @@
<div class="ulist">
<ul>
<li>
-<p><strong><a href="imap.html" class="xref page">IMAP</a></strong> as a "competing" protocol</p>
+<p><strong><a href="imap.html" class="page">IMAP</a></strong> as a "competing" protocol</p>
</li>
<li>
-<p><strong><a href="../glossary.html#email_client" class="xref page">Email clients</a></strong>, in that the client acts as a POP Client</p>
+<p><strong><a href="../glossary.html#email_client" class="page">Email clients</a></strong>, in that the client acts as a POP Client</p>
</li>
<li>
-<p><strong><a href="../storage/index.html" class="xref page">Storage</a></strong> in that messages are stored temporarily on
+<p><strong><a href="../storage/index.html" class="page">Storage</a></strong> in that messages are stored temporarily on
a ???? while awaiting transfer to the client</p>
</li>
<li>
-<p><strong><a href="smtp.html" class="xref page">SMTP</a></strong>, in that messages will normally be
+<p><strong><a href="smtp.html" class="page">SMTP</a></strong>, in that messages will normally be
delivered to the IMAP Server via SMTP.</p>
</li>
</ul>
diff --git a/james-project/3.8.1/concepts/protocols/smtp.html b/james-project/3.8.1/concepts/protocols/smtp.html
index 9a21ad0..0bf8cb3 100644
--- a/james-project/3.8.1/concepts/protocols/smtp.html
+++ b/james-project/3.8.1/concepts/protocols/smtp.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Simple Mail Transfer Protocol (SMTP) :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -328,13 +317,6 @@
<li><a href="smtp.html">SMTP</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="smtp.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/concepts/protocols/smtp.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/concepts/pages/protocols/smtp.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -349,7 +331,7 @@
<div class="paragraph">
<p>When the original specification for Simple Mail Transfer Protocol, or SMTP,
was published almost 40 years ago together with
-<a href="../messages/imf.html" class="xref page">IMF</a>, email as we know it today was born.</p>
+<a href="../messages/imf.html" class="page">IMF</a>, email as we know it today was born.</p>
</div>
</div>
</div>
@@ -380,8 +362,8 @@
the gory details, we recommend that you read this document.</p>
</div>
<div class="paragraph">
-<p>This specification has many dependencies with <a href="../messages/imf.html" class="xref page">IMF</a>,
-<a href="../messages/mime.html" class="xref page">MIME</a>, and other technical concepts, which can quickly
+<p>This specification has many dependencies with <a href="../messages/imf.html" class="page">IMF</a>,
+<a href="../messages/mime.html" class="page">MIME</a>, and other technical concepts, which can quickly
become utterly confusing.
Here, we provide a very short and simplified description of those portions of the
specification that we felt were interesting enough to repeat here.</p>
@@ -415,11 +397,11 @@
<div class="ulist">
<ul>
<li>
-<p><strong><a href="../messages/index.html" class="xref page">Email messages</a></strong>, in that the SMTP protocol exists to transfer
+<p><strong><a href="../messages/index.html" class="page">Email messages</a></strong>, in that the SMTP protocol exists to transfer
messages from one host to another</p>
</li>
<li>
-<p><strong><a href="../glossary.html#mta" class="xref page">MTA</a></strong>, in that the very nature of SMTP is about specifying how a message
+<p><strong><a href="../glossary.html#mta" class="page">MTA</a></strong>, in that the very nature of SMTP is about specifying how a message
gets transferred from one MTA to another</p>
</li>
</ul>
@@ -505,11 +487,11 @@
</tr>
<tr>
<td><i class="conum" data-value="3"></i><b>3</b></td>
-<td>Indicate that you want to send a mail from <a href="mailto:user02@james.local">user02@james.local</a>.</td>
+<td>Indicate that you want to send a mail from user02@james.local.</td>
</tr>
<tr>
<td><i class="conum" data-value="4"></i><b>4</b></td>
-<td>Indicate that the mail should be sent to <a href="mailto:user01@james.local">user01@james.local</a>.</td>
+<td>Indicate that the mail should be sent to user01@james.local.</td>
</tr>
<tr>
<td><i class="conum" data-value="5"></i><b>5</b></td>
@@ -535,7 +517,7 @@
</div>
<div class="paragraph">
<p>If you set up Thunderbird to connect to the server, you can confirm that the mail
-has indeed arrived in the mailbox of <a href="mailto:user01@james.local">user01@james.local</a>.</p>
+has indeed arrived in the mailbox of user01@james.local.</p>
</div>
<div class="paragraph">
<p>Pretty cool! Good thing we have James so we don’t have to always send emails manually.</p>
diff --git a/james-project/3.8.1/concepts/storage/index.html b/james-project/3.8.1/concepts/storage/index.html
index 2155877..2eacd19 100644
--- a/james-project/3.8.1/concepts/storage/index.html
+++ b/james-project/3.8.1/concepts/storage/index.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Storage :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -327,13 +316,6 @@
<li><a href="index.html">Storage</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="index.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/concepts/storage/index.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/concepts/pages/storage/index.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -370,14 +352,14 @@
Many corporations use email for business purposes, which requires administration of
users within the organization.
Even individuals with a self-hosted email server want to ensure that their system does
-not get abused as an <a href="../glossary.html#open_relay" class="xref page">open relay</a>.</p>
+not get abused as an <a href="../glossary.html#open_relay" class="page">open relay</a>.</p>
</div>
<div class="paragraph">
<p>All of these types of concerns requires that the system maintain some kind of state,
whether that be the messages themselves, information about the system’s users,
and even in some cases user credentials. Keeping state requires a storage system.
The system of storage must work intimately with the various
-<a href="../protocols/index.html" class="xref page">protocols</a>.</p>
+<a href="../protocols/index.html" class="page">protocols</a>.</p>
</div>
<div class="paragraph">
<p>In this section, we describe the two principle types of storage that James manages:</p>
@@ -385,10 +367,10 @@
<div class="ulist">
<ul>
<li>
-<p><a href="mailbox.html" class="xref page">Mailboxes</a> for email storage, and</p>
+<p><a href="mailbox.html" class="page">Mailboxes</a> for email storage, and</p>
</li>
<li>
-<p><a href="users.html" class="xref page">User Repository</a> for data about Mailbox users.</p>
+<p><a href="users.html" class="page">User Repository</a> for data about Mailbox users.</p>
</li>
</ul>
</div>
diff --git a/james-project/3.8.1/concepts/storage/mailbox.html b/james-project/3.8.1/concepts/storage/mailbox.html
index b535024..3197720 100644
--- a/james-project/3.8.1/concepts/storage/mailbox.html
+++ b/james-project/3.8.1/concepts/storage/mailbox.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Mailboxes :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -328,13 +317,6 @@
<li><a href="mailbox.html">Mailboxes</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="mailbox.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/concepts/storage/mailbox.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/concepts/pages/storage/mailbox.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -470,7 +452,7 @@
<div class="paragraph">
<p>The <a href="https://en.wikipedia.org/wiki/MIX_(email)">MIX</a> email storage format was developed by
<a href="https://en.wikipedia.org/wiki/Mark_Crispin">Mark Crispin</a>, the original author of the
-<a href="../protocols/imap.html" class="xref page">IMAP specification</a>. Its
+<a href="../protocols/imap.html" class="page">IMAP specification</a>. Its
<a href="https://www.mail-archive.com/imap-uw@u.washington.edu/msg00540.html">design goals</a> were:</p>
</div>
<div class="ulist">
@@ -532,19 +514,19 @@
<div class="ulist">
<ul>
<li>
-<p><strong><a href="../protocols/pop.html" class="xref page">POP</a></strong>, as the POP protocol mandates interaction
+<p><strong><a href="../protocols/pop.html" class="page">POP</a></strong>, as the POP protocol mandates interaction
with a user’s "mailbox"</p>
</li>
<li>
-<p><strong><a href="../protocols/imap.html" class="xref page">IMAP</a></strong>, as the IMAP protocol is all about storing
+<p><strong><a href="../protocols/imap.html" class="page">IMAP</a></strong>, as the IMAP protocol is all about storing
messages on an IMAP Server</p>
</li>
<li>
-<p><strong><a href="../glossary.html#email_client" class="xref page">Email clients</a></strong>, as the client will store mail locally, usually in the form
+<p><strong><a href="../glossary.html#email_client" class="page">Email clients</a></strong>, as the client will store mail locally, usually in the form
of a "mailbox"</p>
</li>
<li>
-<p><strong><a href="../protocols/smtp.html" class="xref page">SMTP</a></strong> as the protocol is related to transmitting
+<p><strong><a href="../protocols/smtp.html" class="page">SMTP</a></strong> as the protocol is related to transmitting
messages from one mailbox to another</p>
</li>
</ul>
diff --git a/james-project/3.8.1/concepts/storage/users.html b/james-project/3.8.1/concepts/storage/users.html
index ef5feb4..238d5eb 100644
--- a/james-project/3.8.1/concepts/storage/users.html
+++ b/james-project/3.8.1/concepts/storage/users.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>User Repository :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -328,13 +317,6 @@
<li><a href="users.html">Users</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="users.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/concepts/storage/users.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/concepts/pages/storage/users.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -347,12 +329,12 @@
<h2 id="_overview"><a class="anchor" href="#_overview"></a>Overview</h2>
<div class="sectionbody">
<div class="paragraph">
-<p>Whereas <a href="mailbox.html" class="xref page">mailboxes</a> are clearly a core component of
+<p>Whereas <a href="mailbox.html" class="page">mailboxes</a> are clearly a core component of
any email system, user management is a lighter shade of gray.</p>
</div>
<div class="paragraph">
<p>On the one hand, mailboxes ought to match up with actual
-<a href="../user/index.html#_user" class="xref page">Users</a>, so there is
+<a href="../user/index.html#_user" class="page">Users</a>, so there is
a clear relationship between mailbox management and user management.
Because of this relationship, it is not at all strange to include a user respository
within an email system.</p>
diff --git a/james-project/3.8.1/concepts/user/index.html b/james-project/3.8.1/concepts/user/index.html
index 8365a36..12269e5 100644
--- a/james-project/3.8.1/concepts/user/index.html
+++ b/james-project/3.8.1/concepts/user/index.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>James User Model :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -327,13 +316,6 @@
<li><a href="index.html">User Model</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="index.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/concepts/user/index.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/concepts/pages/user/index.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -346,7 +328,7 @@
<div class="sectionbody">
<div class="paragraph">
<p>For clarity, we have defined various roles for actors who interact
-with <a href="../../servers/index.html" class="xref page">James servers</a> in one way or another.
+with <a href="../../servers/index.html" class="page">James servers</a> in one way or another.
The deliverables we make available are produced with these roles in mind.
Note that any given person may play more than one role, even at the same
time.</p>
@@ -386,10 +368,10 @@
</div>
<div class="paragraph">
<p>More precisely, in typical cases a User will have an email client for reading and writing email. The
-<a href="../glossary.html" class="xref page">email client</a> will connect to the James server via
-<a href="../protocols/smtp.html" class="xref page">SMTP</a>,
-<a href="../protocols/pop.html" class="xref page">POP</a>, or
-<a href="../protocols/imap.html" class="xref page">IMAP</a>.
+<a href="../glossary.html" class="page">email client</a> will connect to the James server via
+<a href="../protocols/smtp.html" class="page">SMTP</a>,
+<a href="../protocols/pop.html" class="page">POP</a>, or
+<a href="../protocols/imap.html" class="page">IMAP</a>.
The User will have no indication anywhere that the server is a James server.</p>
</div>
</div>
@@ -406,10 +388,10 @@
</div>
<div class="paragraph">
<p>Apache James offers Operators a range of servers for various use cases, including:
- * A <a href="../../servers/basic/index.html" class="xref page">Basic Server</a> ideal for busy Operators who
+ * A <a href="../../servers/basic/index.html" class="page">Basic Server</a> ideal for busy Operators who
are interested in an easy-to-use self-hosting solution, but who may not have the
time to gain deep expertise
- * An <a href="#server/advanced/index.adoc" class="xref unresolved">Advanced Server</a> well-suited for Operators with
+ * An <a href="#server/advanced/index.adoc" class="page unresolved">Advanced Server</a> well-suited for Operators with
advanced skills and resources who are not daunted by getting their hands dirty
with configurations or using built-in extensions</p>
</div>
@@ -421,7 +403,7 @@
<div class="paragraph">
<p>An <strong>Integrator</strong> has some expertise with Java or a JVM-based language. Based
on this expertise the Integrator can perform more advanced server configurations and may
-develop <a href="#xxx.adoc" class="xref unresolved">Extensions</a> to customize the behavior of a James server.</p>
+develop <a href="#xxx.adoc" class="page unresolved">Extensions</a> to customize the behavior of a James server.</p>
</div>
<div class="paragraph">
<p>An Integrator does <strong>not</strong> need to download the source code or compile James.</p>
diff --git a/james-project/3.8.1/customization/index.html b/james-project/3.8.1/customization/index.html
index 216127c..3d70ccb 100644
--- a/james-project/3.8.1/customization/index.html
+++ b/james-project/3.8.1/customization/index.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Apache James Customization :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -326,13 +315,6 @@
<li><a href="index.html">Customization</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="index.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/customization/index.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/customization/pages/index.adoc">Edit this Page</a></div>
</div>
<div class="content">
diff --git a/james-project/3.8.1/development/deployment-tests.html b/james-project/3.8.1/development/deployment-tests.html
index e4ac3f5..dbfd343 100644
--- a/james-project/3.8.1/development/deployment-tests.html
+++ b/james-project/3.8.1/development/deployment-tests.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>How to run deployment Tests :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -326,13 +315,6 @@
<li><a href="deployment-tests.html">How to run deployment Tests</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="deployment-tests.html">3.8.1 SNAPSHOT</a>
- <a class="version is-missing" href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/development/pages/deployment-tests.adoc">Edit this Page</a></div>
</div>
<div class="content">
diff --git a/james-project/3.8.1/development/index.html b/james-project/3.8.1/development/index.html
index 4b0e557..7b6ab72 100644
--- a/james-project/3.8.1/development/index.html
+++ b/james-project/3.8.1/development/index.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Apache James Developer Guide :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -326,13 +315,6 @@
<li><a href="index.html">Developer Guide</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="index.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/development/index.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/development/pages/index.adoc">Edit this Page</a></div>
</div>
<div class="content">
diff --git a/james-project/3.8.1/development/logging.html b/james-project/3.8.1/development/logging.html
index 55707fe..c908330 100644
--- a/james-project/3.8.1/development/logging.html
+++ b/james-project/3.8.1/development/logging.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Logging in Apache James :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -327,13 +316,6 @@
<li><a href="logging.html">Logging in Apache James</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="logging.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/development/logging.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/development/pages/logging.adoc">Edit this Page</a></div>
</div>
<div class="content">
diff --git a/james-project/3.8.1/index.html b/james-project/3.8.1/index.html
index c73ae20..0b9ea2c 100644
--- a/james-project/3.8.1/index.html
+++ b/james-project/3.8.1/index.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Welcome :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -326,13 +315,6 @@
<li><a href="index.html">Welcome</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="index.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../3.6.0/index.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/ROOT/pages/index.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -355,7 +337,7 @@
<div class="ulist">
<ul>
<li>
-<p><a href="concepts/index.html" class="xref page">James Core Concepts</a></p>
+<p><a href="concepts/index.html" class="page">James Core Concepts</a></p>
<div class="ulist">
<ul>
<li>
@@ -367,7 +349,7 @@
</div>
</li>
<li>
-<p><a href="servers/index.html" class="xref page">James Servers</a></p>
+<p><a href="servers/index.html" class="page">James Servers</a></p>
<div class="ulist">
<ul>
<li>
@@ -379,7 +361,7 @@
</div>
</li>
<li>
-<p><a href="customization/index.html" class="xref page">Customization</a></p>
+<p><a href="customization/index.html" class="page">Customization</a></p>
<div class="ulist">
<ul>
<li>
@@ -392,7 +374,7 @@
</div>
</li>
<li>
-<p><a href="development/index.html" class="xref page">James Developer Guide</a></p>
+<p><a href="development/index.html" class="page">James Developer Guide</a></p>
<div class="ulist">
<ul>
<li>
@@ -403,7 +385,7 @@
</div>
</li>
<li>
-<p><a href="community/index.html" class="xref page">James Community</a></p>
+<p><a href="community/index.html" class="page">James Community</a></p>
<div class="ulist">
<ul>
<li>
@@ -416,7 +398,7 @@
</ul>
</div>
<div class="paragraph">
-<p>Please note that this Reference Documentation is a <strong>living document</strong>. It is subject to change. You are currently reading version 3.8.1. If you find anything that is unclear, unfinished, or confusing, please do not hestiate to <a href="community/index.html" class="xref page">lend us a hand</a>.</p>
+<p>Please note that this Reference Documentation is a <strong>living document</strong>. It is subject to change. You are currently reading version 3.8.1. If you find anything that is unclear, unfinished, or confusing, please do not hestiate to <a href="community/index.html" class="page">lend us a hand</a>.</p>
</div>
</article>
</div>
diff --git a/james-project/3.8.1/servers/15-minute-demo.html b/james-project/3.8.1/servers/15-minute-demo.html
index 22cfed9..fd2d93e 100644
--- a/james-project/3.8.1/servers/15-minute-demo.html
+++ b/james-project/3.8.1/servers/15-minute-demo.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Long Demo :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -328,13 +317,6 @@
<li><a href="15-minute-demo.html">Long Demo</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="15-minute-demo.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/servers/15-minute-demo.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/servers/pages/15-minute-demo.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -523,7 +505,7 @@
<div class="paragraph">
<p>After you have installed Thunderbird,
<a href="https://support.mozilla.org/en-US/kb/manual-account-configuration">manually set up an account</a>
-for <a href="mailto:user01@james.local">user01@james.local</a> using the following parameters:</p>
+for user01@james.local using the following parameters:</p>
</div>
<div class="ulist">
<ul>
@@ -534,7 +516,7 @@
<p>Your name: User 01</p>
</li>
<li>
-<p>Email address: <a href="mailto:user01@james.local">user01@james.local</a></p>
+<p>Email address: user01@james.local</p>
</li>
<li>
<p>SMTP server name: localhost</p>
@@ -552,7 +534,7 @@
<p>IMAP server name: localhost</p>
</li>
<li>
-<p>IMAP user name: <a href="mailto:user01@james.local">user01@james.local</a></p>
+<p>IMAP user name: user01@james.local</p>
</li>
<li>
<p>IMAP port: 143</p>
@@ -566,7 +548,7 @@
</ul>
</div>
<div class="paragraph">
-<p>Repeat the above for <a href="mailto:testuser@test.local">testuser@test.local</a>:</p>
+<p>Repeat the above for testuser@test.local:</p>
</div>
<div class="ulist">
<ul>
@@ -577,7 +559,7 @@
<p>Your name: Test User</p>
</li>
<li>
-<p>Email address: <a href="mailto:testuser@test.local">testuser@test.local</a></p>
+<p>Email address: testuser@test.local</p>
</li>
<li>
<p>SMTP server name: localhost</p>
@@ -595,7 +577,7 @@
<p>IMAP server name: localhost</p>
</li>
<li>
-<p>IMAP user name: <a href="mailto:testuser@test.local">testuser@test.local</a></p>
+<p>IMAP user name: testuser@test.local</p>
</li>
<li>
<p>IMAP port: 143</p>
@@ -705,7 +687,7 @@
</div>
<div class="listingblock">
<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">docker stop james ; docker rm james</code></pre>
+<pre class="highlightjs highlight"><code>docker stop james ; docker rm james</code></pre>
</div>
</div>
<div class="paragraph">
diff --git a/james-project/3.8.1/servers/5-minute-demo.html b/james-project/3.8.1/servers/5-minute-demo.html
index b06ae1c..563099d 100644
--- a/james-project/3.8.1/servers/5-minute-demo.html
+++ b/james-project/3.8.1/servers/5-minute-demo.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Short Demo :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -328,13 +317,6 @@
<li><a href="5-minute-demo.html">Short Demo</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="5-minute-demo.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/servers/5-minute-demo.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/servers/pages/5-minute-demo.adoc">Edit this Page</a></div>
</div>
<div class="content">
diff --git a/james-project/3.8.1/servers/basic/architecture.html b/james-project/3.8.1/servers/basic/architecture.html
index 3320ad5..64c606e 100644
--- a/james-project/3.8.1/servers/basic/architecture.html
+++ b/james-project/3.8.1/servers/basic/architecture.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>James Basic Server — Architecture :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -328,13 +317,6 @@
<li><a href="architecture.html">Architecture</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="architecture.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/servers/basic/architecture.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/servers/pages/basic/architecture.adoc">Edit this Page</a></div>
</div>
<div class="content">
diff --git a/james-project/3.8.1/servers/basic/concepts.html b/james-project/3.8.1/servers/basic/concepts.html
index b14d5d4..70f5c8f 100644
--- a/james-project/3.8.1/servers/basic/concepts.html
+++ b/james-project/3.8.1/servers/basic/concepts.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>James Basic Server — Background Concepts :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -328,13 +317,6 @@
<li><a href="concepts.html">Concepts</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="concepts.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/servers/basic/concepts.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/servers/pages/basic/concepts.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -350,19 +332,19 @@
<div class="ulist TODO: provide links and ensure that articles exist for each of these topics">
<ul class="TODO: provide links and ensure that articles exist for each of these topics">
<li>
-<p><a href="../../concepts/user/index.html" class="xref page">James User Model</a></p>
+<p><a href="../../concepts/user/index.html" class="page">James User Model</a></p>
</li>
<li>
-<p><a href="../../concepts/protocols/smtp.html" class="xref page">SMTP</a></p>
+<p><a href="../../concepts/protocols/smtp.html" class="page">SMTP</a></p>
</li>
<li>
-<p><a href="../../concepts/protocols/imap.html" class="xref page">IMAP</a></p>
+<p><a href="../../concepts/protocols/imap.html" class="page">IMAP</a></p>
</li>
<li>
<p>Secured email communications</p>
</li>
<li>
-<p><a href="../../concepts/storage/index.html" class="xref page">Email storage</a></p>
+<p><a href="../../concepts/storage/index.html" class="page">Email storage</a></p>
</li>
</ul>
</div>
diff --git a/james-project/3.8.1/servers/basic/conf/index.html b/james-project/3.8.1/servers/basic/conf/index.html
index c54d0ae..37c650d 100644
--- a/james-project/3.8.1/servers/basic/conf/index.html
+++ b/james-project/3.8.1/servers/basic/conf/index.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>James Basic Mail Server Configuration :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -328,13 +317,6 @@
<li><a href="index.html">Configuration</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="index.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../../../3.6.0/servers/basic/conf/index.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/servers/pages/basic/conf/index.adoc">Edit this Page</a></div>
</div>
<div class="content">
diff --git a/james-project/3.8.1/servers/basic/context.html b/james-project/3.8.1/servers/basic/context.html
index 96f9617..ca2cfa8 100644
--- a/james-project/3.8.1/servers/basic/context.html
+++ b/james-project/3.8.1/servers/basic/context.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>James Basic Server — Context :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -328,13 +317,6 @@
<li><a href="context.html">Context</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="context.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/servers/basic/context.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/servers/pages/basic/context.adoc">Edit this Page</a></div>
</div>
<div class="content">
diff --git a/james-project/3.8.1/servers/basic/help.html b/james-project/3.8.1/servers/basic/help.html
index 927a8d7..f813a7a 100644
--- a/james-project/3.8.1/servers/basic/help.html
+++ b/james-project/3.8.1/servers/basic/help.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>James Basic Server — Where to get help :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -328,13 +317,6 @@
<li><a href="help.html">Help</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="help.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/servers/basic/help.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/servers/pages/basic/help.adoc">Edit this Page</a></div>
</div>
<div class="content">
diff --git a/james-project/3.8.1/servers/basic/index.html b/james-project/3.8.1/servers/basic/index.html
index edd14af..75e6c0d 100644
--- a/james-project/3.8.1/servers/basic/index.html
+++ b/james-project/3.8.1/servers/basic/index.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>James Basic Mail Server :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -327,13 +316,6 @@
<li><a href="index.html">Basic</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="index.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/servers/basic/index.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/servers/pages/basic/index.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -343,7 +325,7 @@
<article class="doc">
<h1 class="page">James Basic Mail Server</h1>
<div class="paragraph">
-<p>The <strong>James Basic Server</strong> is intended for <a href="../../concepts/user/index.html#Operator" class="xref page">Operators</a>
+<p>The <strong>James Basic Server</strong> is intended for <a href="../../concepts/user/index.html#Operator" class="page">Operators</a>
who are just getting initiated with operating their own
<a href="#concepts/???">Self-Hosted</a> mail server.</p>
</div>
@@ -360,22 +342,22 @@
<div class="ulist">
<ul>
<li>
-<p><a href="context.html" class="xref page">The context of contemporary email</a></p>
+<p><a href="context.html" class="page">The context of contemporary email</a></p>
</li>
<li>
-<p><a href="objectives.html" class="xref page">Objectives and motivation of the Basic Server</a></p>
+<p><a href="objectives.html" class="page">Objectives and motivation of the Basic Server</a></p>
</li>
<li>
-<p><a href="concepts.html" class="xref page">Useful background concepts</a></p>
+<p><a href="concepts.html" class="page">Useful background concepts</a></p>
</li>
<li>
-<p><a href="architecture.html" class="xref page">Overview of architecture</a></p>
+<p><a href="architecture.html" class="page">Overview of architecture</a></p>
</li>
<li>
-<p><a href="conf/index.html" class="xref page">Configuration</a></p>
+<p><a href="conf/index.html" class="page">Configuration</a></p>
</li>
<li>
-<p><a href="help.html" class="xref page">Where to go for help</a></p>
+<p><a href="help.html" class="page">Where to go for help</a></p>
</li>
</ul>
</div>
diff --git a/james-project/3.8.1/servers/basic/objectives.html b/james-project/3.8.1/servers/basic/objectives.html
index d07fdee..2bb4b3b 100644
--- a/james-project/3.8.1/servers/basic/objectives.html
+++ b/james-project/3.8.1/servers/basic/objectives.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>James Basic Server — Objectives :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -328,13 +317,6 @@
<li><a href="objectives.html">Objectives</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="objectives.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../../3.6.0/servers/basic/objectives.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/servers/pages/basic/objectives.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -394,7 +376,7 @@
<p>We have disabled all of the insecure communications and require SSL. If you have
a specific requirement to use an insecure protocol, or if the above list does not
satisfy your needs, then after having successfully set up this server you may want
-to move on to the <a href="../extendable.html" class="xref page">Extendable Server</a>.</p>
+to move on to the <a href="../extendable.html" class="page">Extendable Server</a>.</p>
</div>
</article>
</div>
diff --git a/james-project/3.8.1/servers/demo.html b/james-project/3.8.1/servers/demo.html
index f381031..e0f084c 100644
--- a/james-project/3.8.1/servers/demo.html
+++ b/james-project/3.8.1/servers/demo.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Server Demo :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -327,13 +316,6 @@
<li><a href="demo.html">Demo</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="demo.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/servers/demo.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/servers/pages/demo.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -349,7 +331,7 @@
<div class="ulist">
<ul>
<li>
-<p><a href="5-minute-demo.html" class="xref page">Short demo</a> (~5 minutes)</p>
+<p><a href="5-minute-demo.html" class="page">Short demo</a> (~5 minutes)</p>
<div class="ulist">
<ul>
<li>
@@ -362,7 +344,7 @@
</div>
</li>
<li>
-<p><a href="15-minute-demo.html" class="xref page">Long demo</a> (~15 minutes)</p>
+<p><a href="15-minute-demo.html" class="page">Long demo</a> (~15 minutes)</p>
<div class="ulist">
<ul>
<li>
diff --git a/james-project/3.8.1/servers/extendable.html b/james-project/3.8.1/servers/extendable.html
index 6f0deb5..cf99e49 100644
--- a/james-project/3.8.1/servers/extendable.html
+++ b/james-project/3.8.1/servers/extendable.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>James Extendable Mail Server :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -327,13 +316,6 @@
<li><a href="extendable.html">Extendable</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="extendable.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/servers/extendable.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/servers/pages/extendable.adoc">Edit this Page</a></div>
</div>
<div class="content">
diff --git a/james-project/3.8.1/servers/index.html b/james-project/3.8.1/servers/index.html
index 2949bde..cacfef5 100644
--- a/james-project/3.8.1/servers/index.html
+++ b/james-project/3.8.1/servers/index.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Apache James Mail Servers :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -326,13 +315,6 @@
<li><a href="index.html">Servers</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="index.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/servers/index.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/servers/pages/index.adoc">Edit this Page</a></div>
</div>
<div class="content">
@@ -345,9 +327,9 @@
<div class="sectionbody">
<div class="paragraph">
<p>James offers five types of ready-made Mail Servers. The servers are intended
-for those with different needs, ranging from <a href="../concepts/user/index.html#Operators" class="xref page">Operators</a>
+for those with different needs, ranging from <a href="../concepts/user/index.html#Operators" class="page">Operators</a>
who are interested in setting up a server for the first time, to experienced teams of
-<a href="../concepts/user/index.html#Developer" class="xref page">Developers</a>
+<a href="../concepts/user/index.html#Developer" class="page">Developers</a>
looking to deploy an advanced distributed system.
Each of the servers has been tested and verified so you can
deploy a production-grade
@@ -398,7 +380,7 @@
<h2 id="demo"><a class="anchor" href="#demo"></a>James Demo Server</h2>
<div class="sectionbody">
<div class="paragraph">
-<p>The <a href="demo.html" class="xref page">Demo Server</a> is intended for those who just want
+<p>The <a href="demo.html" class="page">Demo Server</a> is intended for those who just want
to give James a quick spin on their local machine to see what all
the fuss is about.</p>
</div>
@@ -410,7 +392,7 @@
<div class="paragraph">
<p>If you just want to get up and running quickly, if you have very simple needs,
or you want to try deploying a mail server for the first time, then the
-<a href="basic/index.html" class="xref page"><strong>Basic Server</strong></a> is the right choice for you. If you are
+<a href="basic/index.html" class="page"><strong>Basic Server</strong></a> is the right choice for you. If you are
not sure which server you should be using, then this server is probably the right
choice.</p>
</div>
@@ -420,7 +402,7 @@
The last thing you need is
to have to resolve difficult issues on a production server when you have not
yet acquired the requisite knowledge to deal with those issues. Using the
-<a href="basic/index.html" class="xref page"><strong>Basic Server</strong></a> will help you reduce the risk of running into
+<a href="basic/index.html" class="page"><strong>Basic Server</strong></a> will help you reduce the risk of running into
production issues.</p>
</div>
</div>
@@ -431,7 +413,7 @@
<div class="paragraph">
<p>When your requirements start to get a little more serious, or you
start to feel adventurous and want to begin your own email adventure,
-you can consider using the <a href="extendable.html" class="xref page"><strong>Extendable Server</strong></a>.</p>
+you can consider using the <a href="extendable.html" class="page"><strong>Extendable Server</strong></a>.</p>
</div>
<div class="paragraph">
<p>This server is intended for experts who understand the consequences of
@@ -447,7 +429,7 @@
<h2 id="distributed"><a class="anchor" href="#distributed"></a>James Distributed Mail Server</h2>
<div class="sectionbody">
<div class="paragraph">
-<p>The <a href="../../../james-distributed-app/3.8.1/index.html" class="xref page"><strong>Distributed Server</strong></a> is a heavy-duty industrial
+<p>The <a href="#james-distributed-app:ROOT:index.adoc" class="page unresolved"><strong>Distributed Server</strong></a> is a heavy-duty industrial
enterprise mail server.</p>
</div>
<div class="paragraph">
@@ -460,7 +442,7 @@
<h2 id="test"><a class="anchor" href="#test"></a>James Test Server</h2>
<div class="sectionbody">
<div class="paragraph">
-<p>The <a href="test.html" class="xref page"><strong>Test Server</strong></a> is, as the name suggests, for testing purposes.</p>
+<p>The <a href="test.html" class="page"><strong>Test Server</strong></a> is, as the name suggests, for testing purposes.</p>
</div>
</div>
</div>
diff --git a/james-project/3.8.1/servers/run.html b/james-project/3.8.1/servers/run.html
index 15574da..f6e3d77 100644
--- a/james-project/3.8.1/servers/run.html
+++ b/james-project/3.8.1/servers/run.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Run James in Production :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -326,13 +315,6 @@
<li><a href="run.html">Run James in Production</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="run.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/servers/run.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/servers/pages/run.adoc">Edit this Page</a></div>
</div>
<div class="content">
diff --git a/james-project/3.8.1/servers/test.html b/james-project/3.8.1/servers/test.html
index 2330ac2..9027d10 100644
--- a/james-project/3.8.1/servers/test.html
+++ b/james-project/3.8.1/servers/test.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>James Test Server :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../../_/css/site.css">
</head>
<body class="article">
@@ -284,23 +284,12 @@
<span class="version">3.8.1 SNAPSHOT</span>
</div>
<ul class="components">
- <li class="component">
- <div class="title"><a href="../../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
<li class="component is-current">
<div class="title"><a href="../index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-current is-latest">
<a href="../index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component">
@@ -327,13 +316,6 @@
<li><a href="test.html">Test</a></li>
</ul>
</nav>
-<div class="page-versions">
- <button class="version-menu-toggle" title="Show other versions of page">3.8.1 SNAPSHOT</button>
- <div class="version-menu">
- <a class="version is-current" href="test.html">3.8.1 SNAPSHOT</a>
- <a class="version" href="../../3.6.0/servers/test.html">3.6.0 Snapshot</a>
- </div>
-</div>
<div class="edit-this-page"><a href="https://github.com/apache/james-project/blob/master/docs/modules/servers/pages/test.adoc">Edit this Page</a></div>
</div>
<div class="content">
diff --git a/james-site/latest/homepage.html b/james-site/latest/homepage.html
index 6342343..b8bd8a1 100644
--- a/james-site/latest/homepage.html
+++ b/james-site/latest/homepage.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Welcome to Apache James Project :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../_/css/site.css">
</head>
<body class="article">
@@ -71,22 +71,11 @@
</div>
<ul class="components">
<li class="component">
- <div class="title"><a href="../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
<div class="title"><a href="../../james-project/3.8.1/index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-latest">
<a href="../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component is-current">
diff --git a/james-site/latest/index.html b/james-site/latest/index.html
index ebf15ab..8d9ff7f 100644
--- a/james-site/latest/index.html
+++ b/james-site/latest/index.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Apache James website :: Apache James</title>
- <meta name="generator" content="Antora 3.1.2">
+ <meta name="generator" content="Antora 2.3.4">
<link rel="stylesheet" href="../../_/css/site.css">
</head>
<body class="article">
@@ -71,22 +71,11 @@
</div>
<ul class="components">
<li class="component">
- <div class="title"><a href="../../james-distributed-app/3.8.1/index.html">Apache James Distributed Server</a></div>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../james-distributed-app/3.8.1/index.html">3.8.1 SNAPSHOT</a>
- </li>
- </ul>
- </li>
- <li class="component">
<div class="title"><a href="../../james-project/3.8.1/index.html">Apache James Server</a></div>
<ul class="versions">
<li class="version is-latest">
<a href="../../james-project/3.8.1/index.html">3.8.1 SNAPSHOT</a>
</li>
- <li class="version">
- <a href="../../james-project/3.6.0/index.html">3.6.0 Snapshot</a>
- </li>
</ul>
</li>
<li class="component is-current">
diff --git a/sitemap-james-distributed-app.xml b/sitemap-james-distributed-app.xml
deleted file mode 100644
index a4deee0..0000000
--- a/sitemap-james-distributed-app.xml
+++ /dev/null
@@ -1,283 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/architecture/consistency-model.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/architecture/implemented-standards.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/architecture/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/architecture/specialized-instances.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/benchmark/db-benchmark.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/benchmark/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/benchmark/james-benchmark.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/configure/batchsizes.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/configure/blobstore.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/configure/cassandra.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/configure/collecting-contacts.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/configure/collecting-events.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/configure/dns.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/configure/domainlist.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/configure/dsn.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/configure/extensions.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/configure/healthcheck.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/configure/imap.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/configure/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/configure/jmap.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/configure/jmx.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/configure/jvm.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/configure/listeners.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/configure/mailetcontainer.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/configure/mailets.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/configure/mailrepositorystore.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/configure/matchers.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/configure/opensearch.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/configure/pop3.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/configure/queue.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/configure/rabbitmq.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/configure/recipientrewritetable.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/configure/redis.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/configure/remote-delivery-error-handling.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/configure/search.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/configure/sieve.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/configure/smtp-hooks.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/configure/smtp.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/configure/spam.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/configure/ssl.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/configure/tika.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/configure/usersrepository.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/configure/vault.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/configure/webadmin.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/extending/imap.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/extending/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/extending/mail-processing.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/extending/mailbox-listeners.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/extending/smtp-hooks.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/extending/webadmin-routes.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/objectives.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/operate/cassandra-migration.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/operate/cli.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/operate/guide.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/operate/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/operate/logging.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/operate/metrics.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/operate/migrating.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/operate/performanceChecklist.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/operate/security.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/operate/webadmin.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/run/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/run/k8s-checklist.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/run/k8s-logsMetrics.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/run/k8s-secrets.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/run/k8s-values.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/run/run-docker.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/run/run-java.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-distributed-app/3.8.1/run/run-kubernetes.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-</urlset>
diff --git a/sitemap-james-project.xml b/sitemap-james-project.xml
index 9892d46..a3db179 100644
--- a/sitemap-james-project.xml
+++ b/sitemap-james-project.xml
@@ -2,574 +2,186 @@
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<url>
<loc>https://james.apache.org/james-project/3.8.1/community/contributing.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/community/download.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/community/guidelines.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/community/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/community/mailing-lists.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/community/release.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/community/support.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/community/website.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/concepts/configuration.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/concepts/glossary.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/concepts/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/concepts/mail/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/concepts/messages/imf.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/concepts/messages/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/concepts/messages/mime.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/concepts/processing/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/concepts/protocols/esmtp.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/concepts/protocols/imap.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/concepts/protocols/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/concepts/protocols/jmap.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/concepts/protocols/lmtp.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/concepts/protocols/pop.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/concepts/protocols/smtp.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/concepts/storage/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/concepts/storage/mailbox.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/concepts/storage/users.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/concepts/user/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/customization/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/development/deployment-tests.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/development/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/development/logging.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/servers/15-minute-demo.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/servers/5-minute-demo.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/servers/basic/architecture.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/servers/basic/concepts.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/servers/basic/conf/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/servers/basic/context.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/servers/basic/help.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/servers/basic/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/servers/basic/objectives.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/servers/demo.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/servers/extendable.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/servers/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/servers/run.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-project/3.8.1/servers/test.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/community/contributing.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/community/download.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/community/guidelines.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/community/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/community/mailing-lists.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/community/release.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/community/support.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/community/website.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/concepts/configuration.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/concepts/glossary.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/concepts/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/concepts/mail/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/concepts/messages/imf.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/concepts/messages/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/concepts/messages/mime.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/concepts/processing/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/concepts/protocols/esmtp.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/concepts/protocols/imap.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/concepts/protocols/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/concepts/protocols/jmap.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/concepts/protocols/lmtp.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/concepts/protocols/pop.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/concepts/protocols/smtp.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/concepts/storage/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/concepts/storage/mailbox.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/concepts/storage/users.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/concepts/user/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/customization/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/development/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/development/logging.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/15-minute-demo.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/5-minute-demo.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/basic/architecture.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/basic/concepts.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/basic/conf/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/basic/context.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/basic/help.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/basic/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/basic/objectives.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/demo.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/architecture/consistency-model.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/architecture/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/architecture/specialized-instances.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/configure/batchsizes.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/configure/blobstore.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/configure/cassandra.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/configure/collecting-contacts.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/configure/collecting-events.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/configure/dns.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/configure/domainlist.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/configure/dsn.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/configure/elasticsearch.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/configure/extensions.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/configure/healthcheck.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/configure/imap.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/configure/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/configure/jmap.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/configure/jmx.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/configure/listeners.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/configure/mailetcontainer.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/configure/mailets.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/configure/mailrepositorystore.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/configure/matchers.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/configure/pop3.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/configure/rabbitmq.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/configure/recipientrewritetable.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/configure/remote-delivery-error-handling.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/configure/smtp-hooks.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/configure/smtp.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/configure/spam.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/configure/ssl.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/configure/tika.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/configure/usersrepository.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/configure/vault.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/configure/webadmin.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/extending/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/extending/mail-processing.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/extending/mailbox-listeners.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/extending/smtp-hooks.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/extending/webadmin-routes.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/objectives.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/operate/cassandra-migration.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/operate/cli.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/operate/guide.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/operate/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/operate/logging.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/operate/metrics.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/operate/migrating.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/operate/webadmin.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/run-docker.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/distributed/run.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/extendable.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/run.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
-</url>
-<url>
-<loc>https://james.apache.org/james-project/3.6.0/servers/test.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
</urlset>
diff --git a/sitemap-james-site.xml b/sitemap-james-site.xml
index 6df979b..28799db 100644
--- a/sitemap-james-site.xml
+++ b/sitemap-james-site.xml
@@ -2,10 +2,10 @@
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<url>
<loc>https://james.apache.org/james-site/latest/homepage.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
<url>
<loc>https://james.apache.org/james-site/latest/index.html</loc>
-<lastmod>2024-04-16T11:32:44.465Z</lastmod>
+<lastmod>2024-04-16T20:43:03.538Z</lastmod>
</url>
</urlset>
diff --git a/sitemap.xml b/sitemap.xml
index 5346adc..c0a0503 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -1,9 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?>
<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<sitemap>
-<loc>https://james.apache.org/sitemap-james-distributed-app.xml</loc>
-</sitemap>
-<sitemap>
<loc>https://james.apache.org/sitemap-james-project.xml</loc>
</sitemap>
<sitemap>
