You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@james.apache.org by bt...@apache.org on 2021/04/05 03:18:42 UTC
[james-project] branch master updated (7fe0c47 -> 0cd6ee7)
This is an automated email from the ASF dual-hosted git repository.
btellier pushed a change to branch master
in repository https://gitbox.apache.org/repos/asf/james-project.git.
from 7fe0c47 JAMES-3529 Validate version when set Filter (#346)
new 8800bfb JAMES-3302 Fix a dead link
new f6fe365 JAMES-3302 Advertise support for JMAP RFC-8620 & Draft deprecation
new eb6ff6d JAMES-3302 Picture for James extension mechanisms
new b84df39 JAMES-3302 Fix bad formatting due to a missing line break
new bc383b3 JAMES-3302 Remove run section for LDAP
new 53fe664 JAMES-3302 Fix a broken link
new 0cd6ee7 JAMES-3302 Add a warning about ElasticSearch metrics
The 7 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
Summary of changes:
.../assets/images/james-hexagons-extensions.png | Bin 0 -> 39191 bytes
docs/modules/servers/pages/distributed.adoc | 2 +-
.../pages/distributed/architecture/index.adoc | 8 ++++++--
.../architecture/specialized-instances.adoc | 2 ++
.../pages/distributed/configure/elasticsearch.adoc | 7 +++++--
.../distributed/configure/mailetcontainer.adoc | 2 +-
.../configure/recipientrewritetable.adoc | 2 +-
.../distributed/configure/usersrepository.adoc | 4 ++--
.../servers/pages/distributed/extending/index.adoc | 2 ++
docs/modules/servers/pages/distributed/run.adoc | 20 --------------------
10 files changed, 20 insertions(+), 29 deletions(-)
create mode 100644 docs/modules/servers/assets/images/james-hexagons-extensions.png
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@james.apache.org
For additional commands, e-mail: notifications-help@james.apache.org
[james-project] 05/07: JAMES-3302 Remove run section for LDAP
Posted by bt...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
btellier pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/james-project.git
commit bc383b316d0b4effc1543f83a58e808fc443585e
Author: Benoit Tellier <bt...@linagora.com>
AuthorDate: Fri Apr 2 18:40:35 2021 +0700
JAMES-3302 Remove run section for LDAP
Merged with the regular one.
---
.../pages/distributed/configure/usersrepository.adoc | 4 ++--
docs/modules/servers/pages/distributed/run.adoc | 20 --------------------
2 files changed, 2 insertions(+), 22 deletions(-)
diff --git a/docs/modules/servers/pages/distributed/configure/usersrepository.adoc b/docs/modules/servers/pages/distributed/configure/usersrepository.adoc
index 4f836d5..f321f42 100644
--- a/docs/modules/servers/pages/distributed/configure/usersrepository.adoc
+++ b/docs/modules/servers/pages/distributed/configure/usersrepository.adoc
@@ -40,8 +40,8 @@ acting on the behalf of any user.
== Configuring a LDAP
-If you run the LDAP fashion of the distributed server, you need to configure the properties for accessing
-your LDAP server in this file.
+Alternatively you can authenticate your users against a LDAP server. You need to configure
+the properties for accessing your LDAP server in this file.
Consult this link:https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq-ldap/destination/conf/usersrepository.xml[example]
to get some examples and hints.
diff --git a/docs/modules/servers/pages/distributed/run.adoc b/docs/modules/servers/pages/distributed/run.adoc
index ab1081f..16afdb8 100644
--- a/docs/modules/servers/pages/distributed/run.adoc
+++ b/docs/modules/servers/pages/distributed/run.adoc
@@ -83,24 +83,4 @@ objectstorage.s3.endPoint=http://s3.docker.test:8000/
objectstorage.s3.region=eu-west-1
objectstorage.s3.accessKeyId=accessKey1
objectstorage.s3.secretKey=secretKey1
-----
-
-== Guice-cassandra-rabbitmq-ldap
-
-You can follow the same guide to build and run
-guice-cassandra-rabbitmq-s3-ldap artifact, except that:
-
- * The *jar* and *libs* needs to be retrieve from
-server/container/guice/cassandra-rabbitmq-ldap-guice/target after
-compilation
- * The sample configuration can be found in
-https://github.com/apache/james-project/tree/master/dockerfiles/run/guice/cassandra-rabbitmq-ldap/destination/conf[dockerfiles/run/guice/cassandra-rabbitmq-ldap/destination/conf]
- * You need to configure James to be connecting to a running LDAP server.
-The configuration file is located in
-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]
- * You can then launch James via this command:
-
-[source,bash]
-----
-$ java -Dworking.directory=. -jar target/james-server-cassandra-rabbitmq-ldap-guice.jar
----
\ No newline at end of file
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@james.apache.org
For additional commands, e-mail: notifications-help@james.apache.org
[james-project] 01/07: JAMES-3302 Fix a dead link
Posted by bt...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
btellier pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/james-project.git
commit 8800bfbd9783d74febbc08c661c58ad06550112d
Author: Tellier Benoit <bt...@linagora.com>
AuthorDate: Fri Apr 2 16:48:07 2021 +0700
JAMES-3302 Fix a dead link
This was modified from https://james.staged.apache.org/james-project/3.6.0/servers/distributed.html
using the [edit this page] button <3
---
docs/modules/servers/pages/distributed.adoc | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/modules/servers/pages/distributed.adoc b/docs/modules/servers/pages/distributed.adoc
index 0022b66..4f147b1 100644
--- a/docs/modules/servers/pages/distributed.adoc
+++ b/docs/modules/servers/pages/distributed.adoc
@@ -18,7 +18,7 @@ This server is:
In this section of the documentation, we will introduce you to:
* xref:distributed/objectives.adoc[Objectives and motivation of the Distributed Server]
-* xref:distributed/architecture.adoc[Overview of architecture]
+* xref:distributed/architecture/index.adoc[Overview of architecture]
* xref:distributed/run.adoc[Running the Distributed Server]
* xref:distributed/run-docker.adoc[Run the Distributed Server with Docker]
* xref:distributed/configure/index.adoc[Configure the Distributed Server]
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@james.apache.org
For additional commands, e-mail: notifications-help@james.apache.org
[james-project] 03/07: JAMES-3302 Picture for James extension
mechanisms
Posted by bt...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
btellier pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/james-project.git
commit eb6ff6da93ba167f6a03033894840a761c9a2a81
Author: Benoit Tellier <bt...@linagora.com>
AuthorDate: Fri Apr 2 18:37:51 2021 +0700
JAMES-3302 Picture for James extension mechanisms
---
.../servers/assets/images/james-hexagons-extensions.png | Bin 0 -> 39191 bytes
.../servers/pages/distributed/extending/index.adoc | 2 ++
2 files changed, 2 insertions(+)
diff --git a/docs/modules/servers/assets/images/james-hexagons-extensions.png b/docs/modules/servers/assets/images/james-hexagons-extensions.png
new file mode 100644
index 0000000..6e228e2
Binary files /dev/null and b/docs/modules/servers/assets/images/james-hexagons-extensions.png differ
diff --git a/docs/modules/servers/pages/distributed/extending/index.adoc b/docs/modules/servers/pages/distributed/extending/index.adoc
index 27f578a..2eda09e 100644
--- a/docs/modules/servers/pages/distributed/extending/index.adoc
+++ b/docs/modules/servers/pages/distributed/extending/index.adoc
@@ -3,6 +3,8 @@
== Available extension mechanisms
+image::mail-processing-hexagons.png[Extension mechanisms for the Distributed Server]
+
The Distributed Server exposes several interfaces allowing the user to write custom extensions in
order to extend the Distributed Server behavior.
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@james.apache.org
For additional commands, e-mail: notifications-help@james.apache.org
[james-project] 04/07: JAMES-3302 Fix bad formatting due to a
missing line break
Posted by bt...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
btellier pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/james-project.git
commit b84df39c7a079f840d7b5ec8704b4b85bb77dd7d
Author: Benoit Tellier <bt...@linagora.com>
AuthorDate: Fri Apr 2 18:38:38 2021 +0700
JAMES-3302 Fix bad formatting due to a missing line break
---
.../servers/pages/distributed/architecture/specialized-instances.adoc | 2 ++
1 file changed, 2 insertions(+)
diff --git a/docs/modules/servers/pages/distributed/architecture/specialized-instances.adoc b/docs/modules/servers/pages/distributed/architecture/specialized-instances.adoc
index e13d75e..5c7365d 100644
--- a/docs/modules/servers/pages/distributed/architecture/specialized-instances.adoc
+++ b/docs/modules/servers/pages/distributed/architecture/specialized-instances.adoc
@@ -22,12 +22,14 @@ We speak of:
protocols configuration files to learn more.
- **Back-office servers** handles other services like:
+
- Mail processing.
- Remote delivery.
- Event processing.
- Task execution.
Front-line servers will likely not handle back office responsibilities (but be sure to have back-office servers that do!).
+
- xref:distributed/configure/mailetcontainer.adoc[Mail processing can be switched off].
- xref:distributed/configure/listeners.adoc[Mailbox event processing can be switched off].
- xref:distributed/configure/rabbitmq.adoc[Task execution can be switched off].
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@james.apache.org
For additional commands, e-mail: notifications-help@james.apache.org
[james-project] 02/07: JAMES-3302 Advertise support for JMAP
RFC-8620 & Draft deprecation
Posted by bt...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
btellier pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/james-project.git
commit f6fe365967839061fca45b69b846a08d7010a0d9
Author: Benoit Tellier <bt...@linagora.com>
AuthorDate: Fri Apr 2 18:29:27 2021 +0700
JAMES-3302 Advertise support for JMAP RFC-8620 & Draft deprecation
---
docs/modules/servers/pages/distributed/architecture/index.adoc | 8 ++++++--
1 file changed, 6 insertions(+), 2 deletions(-)
diff --git a/docs/modules/servers/pages/distributed/architecture/index.adoc b/docs/modules/servers/pages/distributed/architecture/index.adoc
index 0bbbb34..fc0ae77 100644
--- a/docs/modules/servers/pages/distributed/architecture/index.adoc
+++ b/docs/modules/servers/pages/distributed/architecture/index.adoc
@@ -29,11 +29,15 @@ The following protocols are supported and can be used to interact with the Distr
* xref:distributed/operate/webadmin.adoc[WebAdmin] REST Administration API
* *LMTP*
-The following protocols should be considered experimental
+The following protocols should be considered experimental:
-* *JMAP* (draft specification as defined link:https://github.com/apache/james-project/tree/master/server/protocols/jmap-draft/doc[here])
+* *JMAP* (RFC-8620 &RFC-8621 specifications and known limitations of the James implementation are defined link:https://github.com/apache/james-project/tree/master/server/protocols/jmap-rfc-8621/doc[here])
* *POP3*
+The following protocols should be considered deprecated:
+
+* *JMAP-draft* (draft specification as defined link:https://github.com/apache/james-project/tree/master/server/protocols/jmap-draft/doc[here])
+
== Topology
While it is perfectly possible to deploy homogeneous James instances, with the same configuration and thus the same
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@james.apache.org
For additional commands, e-mail: notifications-help@james.apache.org
[james-project] 06/07: JAMES-3302 Fix a broken link
Posted by bt...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
btellier pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/james-project.git
commit 53fe664866a5c58fc587b1ec914f66cb536267c7
Author: Benoit Tellier <bt...@linagora.com>
AuthorDate: Fri Apr 2 18:44:22 2021 +0700
JAMES-3302 Fix a broken link
---
docs/modules/servers/pages/distributed/configure/mailetcontainer.adoc | 2 +-
.../servers/pages/distributed/configure/recipientrewritetable.adoc | 2 +-
2 files changed, 2 insertions(+), 2 deletions(-)
diff --git a/docs/modules/servers/pages/distributed/configure/mailetcontainer.adoc b/docs/modules/servers/pages/distributed/configure/mailetcontainer.adoc
index c94d68b..06b9bf8 100644
--- a/docs/modules/servers/pages/distributed/configure/mailetcontainer.adoc
+++ b/docs/modules/servers/pages/distributed/configure/mailetcontainer.adoc
@@ -5,7 +5,7 @@ This documents explains how to configure Mail processing. Mails pass through 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
-xref:distributed/architecture.adoc#_mail_processing[the mailet container feature description].
+xref:distributed/architecture/index.adoc#_mail_processing[the mailet container feature description].
Apache James Server includes a number of xref:distributed/configure/mailets.adoc[Packaged Mailets] and
xref:distributed/configure/matchers.adoc[Packaged Matchers].
diff --git a/docs/modules/servers/pages/distributed/configure/recipientrewritetable.adoc b/docs/modules/servers/pages/distributed/configure/recipientrewritetable.adoc
index bdeb443..7d73b8b 100644
--- a/docs/modules/servers/pages/distributed/configure/recipientrewritetable.adoc
+++ b/docs/modules/servers/pages/distributed/configure/recipientrewritetable.adoc
@@ -1,7 +1,7 @@
= Distributed James Server — recipientrewritetable.xml
:navtitle: recipientrewritetable.xml
-Here are explanations on the different kinds about xref:distributed/architecture.adoc#_recipient_rewrite_tables[recipient rewritting].
+Here are explanations on the different kinds about xref:distributed/architecture/index.adoc#_recipient_rewrite_tables[recipient rewritting].
Consult this link:https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/recipientrewritetable.xml[example]
to get some examples and hints.
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@james.apache.org
For additional commands, e-mail: notifications-help@james.apache.org
[james-project] 07/07: JAMES-3302 Add a warning about ElasticSearch
metrics
Posted by bt...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
btellier pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/james-project.git
commit 0cd6ee7ee93bf5c677469fe195c54c78612610cd
Author: Benoit Tellier <bt...@linagora.com>
AuthorDate: Fri Apr 2 18:48:48 2021 +0700
JAMES-3302 Add a warning about ElasticSearch metrics
---
.../modules/servers/pages/distributed/configure/elasticsearch.adoc | 7 +++++--
1 file changed, 5 insertions(+), 2 deletions(-)
diff --git a/docs/modules/servers/pages/distributed/configure/elasticsearch.adoc b/docs/modules/servers/pages/distributed/configure/elasticsearch.adoc
index d9d8ef5..0b3fef1 100644
--- a/docs/modules/servers/pages/distributed/configure/elasticsearch.adoc
+++ b/docs/modules/servers/pages/distributed/configure/elasticsearch.adoc
@@ -111,6 +111,9 @@ xref:distributed/operate/webadmin.adoc#reindexing_all_mails[a full re-indexing]n
== Exporting metrics directly to ElasticSearch
+WARNING: A separate ElasticSearch server is required, as an ElasticSearch 6.3 is needed, which is
+not compatible with ElasticSearch 7.10, required by James.
+
For configuring the metric reporting on ElasticSearch :
.elasticsearch.properties content
@@ -136,7 +139,7 @@ For configuring the metric reporting on ElasticSearch :
== SSL Trusting Configuration
-By default James will use the system TrustStore to validate https server certificates, if the certificate on
+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.
.elasticsearch.properties content
@@ -195,4 +198,4 @@ You can configure to use which HostNameVerifier in the client.
| Optional. Default is *default*. default: using the default hostname verifier provided by apache http client.
accept_any_hostname: accept any host (not recommended).
-|===
\ No newline at end of file
+|===
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@james.apache.org
For additional commands, e-mail: notifications-help@james.apache.org