Import Volume

 

Prerequisites

 

A volume consists of:

 

a) Store data in a store directory. The root of the store path also contains a file called volumeinfo (metadata about the volume).

b) Index data in an index directory. Contains Lucene index files.

 

A volume can be imported/restored without b) index data, but not without a) store data. Furthermore, it must be encrypted using the same encryption passphrase as was supplied during setup. If not, follow the procedure to mount an unreadable volume.
 

Import Procedure

 

Windows Permission Note:  If the volume data resides on a remote drive/share, ensure that the MailArchiva service is assigned a logon account with sufficient privileges to read/write to the share.

 

To import a volume created in another system, click Configuration->Volumes then Import. Enter the location of the volume's existing index and store path, respectively.

 

Volume Status Description
ACTIVE or CLOSED The volume is recognized. It is most likely readable.
UNREADABLE The volume is likely encrypted using a different encryption key. Follow the procedure to mount an unreadable volume.
EJECTED MailArchiva does not have sufficient privileges to read/write from the location. Alternatively, the volume store path is missing a volumeinfo file in the root of the store path.

 

No Index Data

 

If no volume index data is available, the imported volume will need to be reindexed. During the import, choose an empty local directory where the volume index should reside (MailArchiva will create the directory location you specify automatically if not already present). Thereafter, click Save and then, assuming the volume status is either ACTIVE or CLOSED, reindex the newly imported volume.

 

VolumeInfo Missing

 

The volumeinfo file is a text file (editable using Notepad or vim) that typically resides in the root of the store path. It contains the unique volume id, created date, closed date, and volume status. It is possible to create a new volumeinfo file, by copying one over from an existing volume, editing using a text editor, and manually changing the ID slightly to another random hex value (one digit can be modified if so desired). Assuming the volume ID was changed, the volume must be reindexed.

 

 

 

 

Was this information helpful?

Found this information useful? Visit mailarchiva.com to learn more about MailArchiva.

The page cannot be found

The page you are looking for might have been removed, had its name changed, or is temporarily unavailable. Please make sure you spelled the page name correctly or use the search box.