Mount Unreadable Volume

MailArchiva volumes are encrypted using a passphrase supplied during setup. It is possible to mount an encrypted volume using a different passphrase. To do this, either:

• the original server.conf must be in your possession (in this case, follow step a) below) OR
• the encryption passphrase must be known (in this case, follow step b) below)

a) Mount a volume using a security passphrase in old server.conf

The below steps assume you are in possession of the server.conf used when the volume data was archived.

1. Ensure that the affected volume is unmounted. Click Unmount in Configuration->Volumes, as necessary.
2. Using a text editor, copy the value of security.passhrase from the old systems server.conf file (main server configuration).
   e.g. security.passhrase=rtQAVHuVq3RejKo5ViHRsttwImTOUjyM/6B72uA+amU=
3. Using a text editor, edit the volumeinfo file in the root of the volume's store path. Add the following line equivalent:
   passphrase:rtQAVHuVq3RejKo5ViHRsttwImTOUjyM/6B72uA+amU=
4. Delete the signature line (if necessary). Save the volumeinfo file
5. Either mount the volume (if present) or import the volume in Configuration->Volumes. Click Save.

b) Mount a volume using plain text passphrase

1. Ensure that the affected volume is unmounted. Click Unmount in Configuration->Volumes, as necessary.
2. Using a text editor, edit the volumeinfo file in the root of the volume's store path. Add the following line equivalent:
   passphrase:[plaintext-password]
3. Delete the signature line (if necessary). Save the volumeinfo file
4. Mount the volume in Configuration->Volumes
5. Either mount the volume (if present) or import the volume in Configuration->Volumes. Click Save.

Once the volume is mounted successfully, use the merge volume feature to transfer the data to the new volume, as desired.
 

Mismatched Volume Format

MailArchiva may not be able to read volume data due to volume format mismatch. If there are .zz files in the volume store directory, then the volume format should be set to V2 in the volumeinfo file. Alternatively, if there are .MRC files in volume store subdirectories, set the volume format to V1, otherwise set it to V3. If you still cannot access email data, you may also try setting the volume format to V0.