Ingest EML files from disk

If you are moving the email archive from another solution provider you may have an option to extract the emails to disk.  With the files in a raw EML format the Mailsphere ingest tool can be used to securely move these emails to the Mailsphere archive.

Prerequisites

Properties File Example

The following sample of the properties file shows where the API user credentials need to be added.

# This is example configuration of MailSync ingestion tool
# This is example for eml ingestion
# host and port of MailsphereUI server
mailsync.mailsphere.host=https://portal.mailsphere.co.uk
mailsync.mailsphere.port=443
# user with priviledges to access REST interface
mailsync.mailsphere.user=[***ADD API USER ID***]
# Password for mailsphere, if left commented out or empty it will be requested
mailsync.mailsphere.password=[***ADD API USER PASSWORD***]
# number of threads to run
number-of-threads=2
# go through zip files
ingest-zip=false
# ingest plain eml files
ingest-eml=true

Run the EML Ingest

Run the EML Ingest

Copy the three files found in the EMLIngest.zip to a level below the root of the folder where you have the EML files stored.

Using the above screen shot as an example, the EML files are stored in:

C:\EML\ROOT_OF_EML_FILES\

The three files contained in EMLINGEST.zip are located in:

C:\EML\

You can use a different configuration to this but try to keep the tool in the parent of the root folder for the EML files.

If you're using Windows, open the command prompt and navigate to the root of the folder where you have stored the EML files.

Run the following command in the command prompt:

java -Xms1024m -Xmx2048m -XX:MaxPermSize=1024m -XX:MaxNewSize=1024m -Djavax.net.ssl.keyStore=mailspherewks -Djavax.net.ssl.keyStorePassword=ingest_ms -jar mailsphere-mail-sync-1.2.18.jar ingest-eml mailsync-eml.properties ROOT_OF_EML_FILES

Note: Remember to change the red text at the end of this to reference your folder name.