How to run the MailboxRestore tool on a remote computer ( ONLY)

Answer

Applies to

• GFI MailArchiver 2013 R2 build 20131111 or newer

The MailboxRestore tool can be run on a different computer than the GFI Archiver server itself.

This can be helpful in situations where one does not want to install Outlook on the server or if MAPI is not working properly on the server.

Notes

• 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.
• 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.
• This article assumes that no port changes were configured beforehand
• Traffic between the SERVER and the REMOTECOMPUTER must not be blocked on any of the mentioned ports
• The same .NET Framework requirement which applies to the SERVER applies to the REMOTECOMPUTER as well
• The same Microsoft Outlook respectively MAPI requirements applies to the MailboxRestore tool when run on the REMOTECOMPUTER compared to running it on the SERVER

High level overview

1. Edit certain configuration files on the SERVER in order to expose certain modules to be reachable via the network
2. Copy the MailboxRestore folder to the REMOTECOMPUTER
3. Edit certain configuration files of the MailboxRestore on the REMOTECOMPUTER in order to point it correctly to the SERVER

Procedure

In the procedure below the following will ports will be used - the ports must not be used by any other application on the server:

• The SERVER has the IP address: 192.168.0.100
• Core service WCF modules will be exposed via port: 18017 (TCP)
• Store service WCF modules will be exposed via port: 18018 (TCP)
• Core service remoting port has not been changed and uses the default: 8017 (TCP)
• Store service remoting port has not been changed and uses the default: 8018 (TCP)

Step 1 - Edit certain configuration files on the SERVER

1. Log into the SERVER
2. Stop all GFI Archiver services
3. Open the following file in Notepad: ..\GFI\Archiver\Core\Data\MArc.WCF.xml
4. Find the line which reads: <AppPort>-1</AppPort>
5. Edit the line so that it reads: <AppPort>18017</AppPort>
6. Save the file
7. Open the following file in Notepad: ..\GFI\Archiver\Store\Data\MArc.WCF.xml
8. Find the line which reads: <AppPort>-1</AppPort>
9. Edit the line so that it reads: <AppPort>18018</AppPort>
10. Save the file
11. Start all GFI Archiver services

Step 2 - Copy the MailboxRestore folder to the REMOTECOMPUTER

1. Copy the folder containing the Mailbox Restore tool from the SERVER to the REMOTECOMPUTER
   • For example, copy \\SERVER\c$\Program Files\GFI\Archiver\MailboxRestore\ to \\REMOTECOMPUTER\c$\MailboxRestore\

Step 3 - Edit certain configuration files of the MailboxRestore on the REMOTECOMPUTER
 

1. Log into the REMOTECOMPUTER
2. Open the following file in Notepad: c:\MailboxRestore\WCFClientSettings.xml
3. Edit the following lines according to the changes shown below:
   • Original:
     • <WCFServiceEndPoint ContractName="MArc.ConfigurationService.Base.ICSSettingsHolder" EndPoint="net.pipe://localhost/Core/CSService" />
     • <WCFServiceEndPoint ContractName="Store.Core.IEmailRetrieval" EndPoint="net.pipe://localhost/Store/CoreMessage" />
     • <WCFServiceEndPoint ContractName="Store.Core.IEmailMessageRetrieval" EndPoint="net.pipe://localhost/Store/EmailMessageRetrieval" />
     • <WCFServiceEndPoint ContractName="Store.Core.ISync" EndPoint="net.pipe://localhost/Store/EmailMessageRetrieval" />
   • Edit to:
     • <WCFServiceEndPoint ContractName="MArc.ConfigurationService.Base.ICSSettingsHolder" EndPoint="net.tcp://192.168.0.100:18017/Core/CSService" />
     • <WCFServiceEndPoint ContractName="Store.Core.IEmailRetrieval" EndPoint="net.tcp://192.168.0.100:18018/Store/CoreMessage" />
     • <WCFServiceEndPoint ContractName="Store.Core.IEmailMessageRetrieval" EndPoint="net.tcp://192.168.0.100:18018/Store/EmailMessageRetrieval" />
     • <WCFServiceEndPoint ContractName="Store.Core.ISync" EndPoint="net.tcp://192.168.0.100:18018/Store/EmailMessageRetrieval" />
4. Save the file
5. Open the following files in Notepad
   • c:\MailboxRestore\MailboxRestore.exe.config
   • c:\MailboxRestore\MailboxRestore_x64.exe.config
6. Edit the following lines according to the changes shown below:
   • Note that some of the following "wellknown type" lines might not exist in the file as some of them have been removed over time and are not used anymore in newer versions of the product. There is no need to add them, but the ones which do exist in the file must be edited as outlined below.
   • Original:
     • <wellknown type="MArc.CS.CSCoordinator, MArc.ConfigurationServices" url="tcp://localhost:8017/Core/CS"/>
     • <wellknown type="Store.Core.EmailMessageRetrieval, Store.Core" url="tcp://localhost:8018/Store/EmailRetrieval"/>
     • <wellknown type="MArc.Ada.Security.AdaAuthentication, MArc.Ada.Authentication" url="tcp://localhost:8017/Core/ADA"/>
     • <wellknown type="MArc.Ada.Services.AdaInformation, MArc.Ada.Services" url="tcp://localhost:8017/Core/Information"/>
   • Edit to:
     • <wellknown type="MArc.CS.CSCoordinator, MArc.ConfigurationServices" url="tcp://192.168.0.100:8017/Core/CS"/>
     • <wellknown type="Store.Core.EmailMessageRetrieval, Store.Core" url="tcp://192.168.0.100:8018/Store/EmailRetrieval"/>
     • <wellknown type="MArc.Ada.Security.AdaAuthentication, MArc.Ada.Authentication" url="tcp://192.168.0.100:8017/Core/ADA"/>
     • <wellknown type="MArc.Ada.Services.AdaInformation, MArc.Ada.Services" url="tcp://192.168.0.100:8017/Core/Information"/>
7. Save the files

At this point the MailboxRestore tool can be used on the REMOTECOMPUTER as well as the unedited version which is still present on the SERVER.