james-server-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From btell...@apache.org
Subject [02/15] james-project git commit: JAMES-2266 Add documentation for ghost mailbox correction
Date Fri, 05 Jan 2018 09:17:28 GMT
JAMES-2266 Add documentation for ghost mailbox correction


Project: http://git-wip-us.apache.org/repos/asf/james-project/repo
Commit: http://git-wip-us.apache.org/repos/asf/james-project/commit/800e88fa
Tree: http://git-wip-us.apache.org/repos/asf/james-project/tree/800e88fa
Diff: http://git-wip-us.apache.org/repos/asf/james-project/diff/800e88fa

Branch: refs/heads/master
Commit: 800e88fa8176f811ede932102a036044e5faa24b
Parents: 8da3ad0
Author: benwa <btellier@linagora.com>
Authored: Wed Dec 20 14:04:02 2017 +0700
Committer: benwa <btellier@linagora.com>
Committed: Fri Jan 5 16:06:36 2018 +0700

----------------------------------------------------------------------
 src/site/markdown/server/manage-webadmin.md | 44 ++++++++++++++++++++++++
 1 file changed, 44 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/james-project/blob/800e88fa/src/site/markdown/server/manage-webadmin.md
----------------------------------------------------------------------
diff --git a/src/site/markdown/server/manage-webadmin.md b/src/site/markdown/server/manage-webadmin.md
index d73651f..ed67ae0 100644
--- a/src/site/markdown/server/manage-webadmin.md
+++ b/src/site/markdown/server/manage-webadmin.md
@@ -466,6 +466,50 @@ The scheduled task will have the following type `CassandraMigration`
and the fol
 {"toVersion":2}
 ```
 
+## Correcting ghost mailbox
+
+This is a temporary workaround for the **Ghost mailbox** bug encountered using the Cassandra
backend, as described in MAILBOX-322.
+
+You can use the mailbox merging feature in order to merge the old "ghosted" mailbox with
the new one.
+
+```
+curl -XPOST http://ip:port/cassandra/mailbox/merging -d '{"mergeOrigin":"id1", "mergeDestination":"id2"}'
+```
+
+Will scedule a task for :
+
+ - Delete references to `id1` mailbox
+ - Move it's messages into `id2` mailbox
+ - Union the rights of both mailboxes
+
+The response to that request will be the scheduled `taskId` :
+
+```
+{"taskId":"5641376-02ed-47bd-bcc7-76ff6262d92a"}
+```
+
+Positionned headers:
+
+ - Location header indicates the location of the resource associated with the scheduled task.
Example:
+
+```
+Location: /tasks/3294a976-ce63-491e-bd52-1b6f465ed7a2
+```
+
+Response codes:
+
+ - 201: Success. Corresponding task id is returned.
+ - 400: Unable to parse the body.
+
+The scheduled task will have the following type `mailboxMerging` and the following `additionalInformation`:
+
+```
+{
+  "oldMailboxId":"5641376-02ed-47bd-bcc7-76ff6262d92a",
+  "newMailboxId":"4555159-52ae-895f-ccb7-586a4412fb50"
+}
+```
+
 ## Creating address group
 
 You can use **webadmin** to define address groups.


---------------------------------------------------------------------
To unsubscribe, e-mail: server-dev-unsubscribe@james.apache.org
For additional commands, e-mail: server-dev-help@james.apache.org


Mime
View raw message