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 e6b89b303becd4b2772ea8959d039f3663b0c88a
Author: LanKhuat <khuatdang...@gmail.com>
AuthorDate: Mon May 25 16:27:46 2020 +0700
JAMES-3184 Update webadmin documentation
---
src/site/markdown/server/manage-webadmin.md | 68 +++++++++++++++++++++++++++++
1 file changed, 68 insertions(+)
diff --git a/src/site/markdown/server/manage-webadmin.md
b/src/site/markdown/server/manage-webadmin.md
index 884ddc5..8f2f797 100644
--- a/src/site/markdown/server/manage-webadmin.md
+++ b/src/site/markdown/server/manage-webadmin.md
@@ -579,10 +579,26 @@ curl -XPOST http://ip:port/mailboxes?task=reIndex
Will schedule a task for reIndexing all the mails stored on this James server.
+[More details about endpoints returning a task](#Endpoints_returning_a_task).
+
+An admin can specify the concurrency that should be used when running the task:
+
+ - `messagesPerSecond` rate at which messages should be processed per second.
Default is 50.
+
+This optional parameter must have a strictly positive integer as a value and
be passed as query parameter.
+
+Example:
+
+curl -XPOST http://ip:port/mailboxes?task=reIndex&messagesPerSecond=200
+
The scheduled task will have the following type `full-reindexing` and the
following `additionalInformation`:
```
{
+ "type":"full-reindexing",
+ "runningOptions":{
+ "messagesPerSecond":200
+ },
"successfullyReprocessedMailCount":18,
"failedReprocessedMailCount": 3,
"failures": {
@@ -594,16 +610,36 @@ The scheduled task will have the following type
`full-reindexing` and the follow
##### Fixing previously failed ReIndexing
+Will schedule a task for reIndexing all the mails which had failed to be
indexed from the ReIndexingAllMails task.
+
Given `bbdb69c9-082a-44b0-a85a-6e33e74287a5` being a `taskId` generated for a
reIndexing tasks
```
curl -XPOST
'http://ip:port/mailboxes?task=reIndex&reIndexFailedMessagesOf=bbdb69c9-082a-44b0-a85a-6e33e74287a5'
```
+[More details about endpoints returning a task](#Endpoints_returning_a_task).
+
+An admin can specify the concurrency that should be used when running the task:
+
+ - `messagesPerSecond` rate at which messages should be processed per second.
Default is 50.
+
+This optional parameter must have a strictly positive integer as a value and
be passed as query parameter.
+
+Example:
+
+```
+curl -XPOST
http://ip:port/mailboxes?task=reIndex&reIndexFailedMessagesOf=bbdb69c9-082a-44b0-a85a-6e33e74287a5&messagesPerSecond=200
+```
+
The scheduled task will have the following type `error-recovery-indexation`
and the following `additionalInformation`:
```
{
+ "type":"error-recovery-indexation"
+ "runningOptions":{
+ "messagesPerSecond":200
+ },
"successfullyReprocessedMailCount":18,
"failedReprocessedMailCount": 3,
"failures": {
@@ -630,6 +666,18 @@ Note that 'mailboxId' path parameter needs to be a
(implementation dependent) va
[More details about endpoints returning a task](#Endpoints_returning_a_task).
+An admin can specify the concurrency that should be used when running the task:
+
+ - `messagesPerSecond` rate at which messages should be processed per second.
Default is 50.
+
+This optional parameter must have a strictly positive integer as a value and
be passed as query parameter.
+
+Example:
+
+```
+curl -XPOST
http://ip:port/mailboxes/{mailboxId}?task=reIndex&messagesPerSecond=200
+```
+
Response codes:
- 201: Success. Corresponding task id is returned.
@@ -639,6 +687,10 @@ The scheduled task will have the following type
`mailbox-reindexing` and the fol
```
{
+ "type":"mailbox-reindexing",
+ "runningOptions":{
+ "messagesPerSecond":200
+ },
"mailboxId":"{mailboxId}",
"successfullyReprocessedMailCount":18,
"failedReprocessedMailCount": 3,
@@ -939,6 +991,18 @@ Will schedule a task for reIndexing all the mails in
"u...@domain.com" mailboxes
[More details about endpoints returning a task](#Endpoints_returning_a_task).
+An admin can specify the concurrency that should be used when running the task:
+
+ - `messagesPerSecond` rate at which messages should be processed per second.
Default is 50.
+
+This optional parameter must have a strictly positive integer as a value and
be passed as query parameter.
+
+Example:
+
+```
+curl -XPOST
http://ip:port/users/{usernameToBeUsed}/mailboxes?task=reIndex&messagesPerSecond=200
+```
+
Response codes:
- 201: Success. Corresponding task id is returned.
@@ -948,6 +1012,10 @@ The scheduled task will have the following type
`user-reindexing` and the follow
```
{
+ "type":"user-reindexing",
+ "runningOptions":{
+ "messagesPerSecond":200
+ },
"user":"u...@domain.com",
"successfullyReprocessedMailCount":18,
"failedReprocessedMailCount": 3,
---------------------------------------------------------------------
To unsubscribe, e-mail: server-dev-unsubscr...@james.apache.org
For additional commands, e-mail: server-dev-h...@james.apache.org
