1.1 --- a/docs/wiki/Resources Thu Apr 21 23:20:57 2016 +0200
1.2 +++ b/docs/wiki/Resources Thu Apr 21 23:41:54 2016 +0200
1.3 @@ -372,7 +372,8 @@
1.4
1.5 ==== Initialising Quotas ====
1.6
1.7 -Within the journal storage area (described in the [[../FilesystemUsage|filesystem guide]]),
1.8 +Within the journal storage area (described in the
1.9 +[[../FilesystemUsage|filesystem guide]] and [[../DatabaseStore|database guide]]),
1.10 a quota group directory must be initialised with a `limits` file indicating
1.11 the amount of time that can be occupied by the cumulative total of all events
1.12 scheduled by an individual user or a group of which they are a member. For
1.13 @@ -395,6 +396,35 @@
1.14 particular user will be unable to reserve the resource unless defined as a
1.15 member of a group listed in the `limits` file, as described below.
1.16
1.17 +{{{{#!wiki tip
1.18 +In a deployment using the [[../FileStore|file store]], files as described
1.19 +above and below hold mappings and definitions in the given format. In a
1.20 +deployment using the [[../DatabaseStore|database store]], database tables
1.21 +hold such mappings with each column dedicated to a particular kind of
1.22 +information.
1.23 +
1.24 +The examples here can be transcribed by just taking each
1.25 +element and putting it in the appropriate column within a table, making
1.26 +sure to set the `quota` column to indicate which quota is involved. For
1.27 +example, to set the above limits in PostgreSQL, the following operations
1.28 +may be used:
1.29 +
1.30 +{{{
1.31 +insert into quota_limits (quota, user_group, quota_limit) values (
1.32 + 'mailto:resource-car-cadillac@example.com',
1.33 + 'mailto:vincent.vole@example.com',
1.34 + 'PT10H');
1.35 +insert into quota_limits (quota, user_group, quota_limit) values (
1.36 + 'mailto:resource-car-cadillac@example.com',
1.37 + '*',
1.38 + 'PT10H');
1.39 +}}}
1.40 +
1.41 +Here, the `quota` column is set to `mailto:resource-car-cadillac@example.com`.
1.42 +In a file-based journal, the equivalent `limits` file would be placed within a
1.43 +quota directory having the name `mailto:resource-car-cadillac@example.com`.
1.44 +}}}}
1.45 +
1.46 ==== Sharing Quotas Across Users ====
1.47
1.48 When the use of resources is to be shared between users in such a way that