Import Tools

From Enkive Wiki

Jump to: navigation, search

Contents

Alfresco Enkive Migration Tool

The Alfresco-Enkive migration tool can be found either on the enkive.org website or on our sourceforge page

  • Note that this tool has been tested in migrating to Enkive 1.0 from enkive 0.8.

This tool is used to migrate an alfresco-based enkive repository to the new mongodb-based enkive. To run this tool the alfresco-enkive should be stopped and the new enkive 1.0 should be started.

To use this tool the config/enkive-migrator.properties file must be updated to know the location of certain things. The dir.root, db.username, db.password, and db.url should be the same as your alfresco-enkive.

The enkive.targetMigrationServer.host and enkive.targetMigrationServer.port should be the same as your new enkive installation.

The migrator can then be run with the command:

java -cp ./*:./lib/*: com.linuxbox.enkive.EnkiveMigrator


Maildir Reader

The maildir reader will read through messages stored in a directory in maildir format and send them to enkive.

  • Note that the importer will not read messages stored in the 'Drafts' folder.
/opt/java/bin/java -cp $enkiveHome/enkive.jar:$enkiveHome/lib/*: com.linuxbox.enkive.importer.MailDirReader $directory $targethost $targetport
  • $enkiveHome should be replaced to the directory where enkive is installed
  • $directory is the directory you wish to import, the root of the maildir
  • $targethost is the host where enkive is running
  • $targetport is the port on which enkive's import tool port is listening, likely 2526


Filedir Reader

The filedir reader will attempt to send every file within a directory to Enkive. This import tool works recursively so it will attempt to send files in all subdirectories as well. This import tool is included with your enkive download and can be run with the command:

/opt/java/bin/java -cp $enkiveHome/enkive.jar:$enkiveHome/lib/*: com.linuxbox.enkive.importer.FileDirReader $directory $targethost $targetport

Several variables in that command need to be replaced:

  • $enkiveHome should be replaced to the directory where enkive is installed
  • $directory is the directory you wish to import
  • $targethost is the host where enkive is running
  • $targetport is the port on which enkive's import tool port is listening, likely 2526


Mbox Reader

The mbox reader will import messages stored in an mbox files. The tool should be pointed at a directory of mbox files and will loop through all files contained in that directory, however it will not do so recursively. It can be run with the following command:

/opt/java/bin/java -cp $enkiveHome/enkive.jar:$enkiveHome/lib/*: com.linuxbox.enkive.importer.MboxReader $directory $targethost $targetport

Several variables in that command need to be replaced:

  • $enkiveHome should be replaced to the directory where enkive is installed
  • $file is the mbox file you wish to import
  • $targethost is the host where enkive is running
  • $targetport is the port on which enkive's import tool port is listening, likely 2526


Handing Microsoft PST files

Getting PST files into Enkive requires converting them to a format that can be read by Enkive's FileDir reader or Mbox reader. You can use the "libpst" package in Linux to do this conversion, specifically, its "readpst" utility.

We recommend libpst version 0.6.63 or newer for converting PST files. Source tarballs and some binary packages can be found at http://www.five-ten-sg.com/libpst/.

A "readpst" command run against a PST file would look something like this:

readpst -b -e -o outputdir/ yourpstfile.pst

The email files would be found in whatever output directory you used. You can then run the FileDir reader on this directory as mentioned above:

/opt/java/bin/java -cp $enkiveHome/enkive.jar:$enkiveHome/lib/*: com.linuxbox.enkive.importer.FileDirReader outputdir/ $targethost $targetport


Personal tools