summaryrefslogtreecommitdiffstats
path: root/doc/wiki/Plugins.QuotaClone.txt
blob: 56325f7024cdc0d475a0cf323824ac7a6925b961 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
Quota Clone Plugin
==================

(Requires v2.2.17+)

Quota clone plugin is useful when you want to store everybody's current quota
usage to a database, but you don't want to use the database as the
authoritative quota database. For example you might want to access everybody's
quota via Redis (or with SQL database, Redis is example here), but you don't
store the Redis database permanently so it could become empty once in a while.
In this case you can use e.g. <dict-file> [Quota.Dict.txt] or <count>
[Quota.Count.txt] as the authoritative quota database and make a copy of the
quota usage to Redis. From Redis you could then once in a while gather
everybody's current quota usage and send it to yet another place (e.g. for
statistics handling).

Every time quota is updated, the value is updated to the cloned dict. There are
race conditions with it so the quota may not always be 100% correct. The old
value is always replaced with the new one though (not just
incremented/decremented) so the cloned quota is never too much wrong.

The keys that are written to:

 * priv/quota/storage - storage usage in bytes
 * priv/quota/messages - count of messages

Configuration
-------------

---%<-------------------------------------------------------------------------
mail_plugins = $mail_plugins quota quota_clone
plugin {
  quota_clone_dict = redis:host=127.0.0.1:port=6379
}
---%<-------------------------------------------------------------------------

(This file was created from the wiki on 2019-06-19 12:42)