Overview

This article describes two important settings and the process to configure them for GFI Archiver.

• EWS batch size: This setting describes how many emails are downloaded from the journal mailbox (Core) or a user mailbox (Import Export Tool) per batch. Increasing this value can increase the number of emails downloaded, which can be useful in environments with a high mail flow. The keys are named slightly different in Core (EWSNumbItems) and the Import-Export Tool (EWSNumItems).
• EWS timeout: This setting controls how long GFI Archiver waits for EWS to respond to a query before giving up (hitting the timeout). This can be helpful if Microsoft Exchange is slow, overloaded or if the journal mailbox contains a large number of items.

These settings are independent of each other.

Environment

GFI MailArchiver 6.4 or later

Process

NOTE: This procedure requires to edit files manually. If edited incorrectly it can leave the server in a non-operational state. Please keep backups of any file which is edited throughout this article before saving any changes to them.

Increasing the EWS batch size and EWS timeout for downloading emails from the journal mailbox

1. Stop all GFI Archiver services.
2. Open the folder:
   • GFI MailArchiver 2014 or newer: ..\InstallationFolder\Core\Data
   • GFI MailArchiver 2013 or older: ..\InstallationFolder\Core2\Data
3. Open the product.config file in Notepad.
4. Add the following keys within the <appSettings> section (edit it if it should exist already):
   1. For increasing the EWS batch size:
      

      <add key="EWSNumbItems" value="50"/>

      NOTE: Default is 5. Do not set this value higher than 100.

   2. For increasing the EWS timeout:
      

      <add key="EWSTimeout" value="150000"/>

      Note: Timeout value is in milliseconds, and must be 10000 or greater
5. Save the file.
6. Start all GFI Archiver services.
   
   

Increasing the EWS batch size for the Import-Export Tool downloading emails from Microsoft Exchange

1. Close the Import-Export Tool if it is open.
2. Open the folder: ..\InstallationFolder\MarcImportExport
3. Open MArcImportExport.exe.config or MArcImportExport_x64.exe.config (depending on the version of the tool that is to be used) in Notepad.
4. For GFI Archiver 2014 or Earlier:
   Add the following after the line </configSections>:

   <appSettings> 
   <add key="EWSNumItems" value="50" /> 
   </appSettings>

   For GFI Archiver 2015 or Later:
   Add the following after the line <appSettings>:
   

   <add key="EWSNumItems" value="50" />

   CAUTION! Do not set this value higher than 100.
5. Save the file.

NOTE: When upgrading to a newer version of GFI Archiver, installation files mentioned in this procedure will be overwritten with default versions making the changes void and ineffective. It is therefore suggested to keep a record of this procedure and follow it once again directly after upgrading to keep this functionality intact.