Archive Partitions
******************

Archive partitions are defined by the "archivepartition-name" option
in imapd.conf(5):

   "archivepartition-name:" <none>

      The pathname of the archive partition *name*, corresponding to
      spool partition **partition-name**.  For any mailbox residing in
      a directory on **partition-name**, the archived messages will be
      stored in a corresponding directory on **archivepartition-
      name**. Note that not every **partition-name** option is
      strictly required to have a corresponding **archivepartition-
      name** option, but that without one there's no benefit to
      enabling archiving.

As is the case with metadata partitions, however, archive partitions
do not stand alone.  They are closely bound to Spool Directories as
defined by the accompanying "partition-name" directive.

Multiple partitions may be used for various reasons, such as to
distribute load between different storage pools or technologies.
Please consult Mail Spool Partitions for more details and use cases.

To define additional mail spools, add more "partition-name" entries to
imapd.conf(5) as needed.  For example, let's imagine we want to
migrate users to new partitions split by first character of the user's
last name, and add a partition for shared mailboxes (see Shared
Namespaces):

* Sample:

     defaultpartition: main
     partition-main: /var/spool/cyrus
     partition-am: /var/spool/cyrus-am
     partition-nz: /var/spool/cyrus-nz
     partition-shared: /var/spool/cyrus-shared

So, to add archiving to the system described above, we would need
something like this (again, building on our previous examples):

* Sample:

     defaultpartition: main
     partition-main: /var/spool/cyrus
     partition-am: /var/spool/cyrus-am
     partition-nz: /var/spool/cyrus-nz
     partition-shared: /var/spool/cyrus-shared
     archive_enabled: yes
     archivepartition-main: /var/spool/cyrusarchive/main
     archivepartition-am: /var/spool/cyrusarchive/am
     archivepartition-nz: /var/spool/cyrusarchive/nz
     archivepartition-shared: /var/spool/cyrusarchive/shared