Exchange Removal

Introduction

The Exchange Removal post processing adapter allows deletion of Exchange mails that were previously imported.

The term post processing job is used in migration-center for describing a component which executes a set of operations on objects that were previously imported.

Post processing jobs work as importer jobs that can be run at any time, and can even be executed repeatedly. For every run a detailed history and log file are created. Multiple post processing jobs can be created or run at a time, each being defined by a unique name, a set of configuration parameters and a description (optional).

Deleting mails from Exchange server

The Exchange Removal post-processing was created to delete emails from Exchange Server after they have been imported with a migration-center importer. The adapter will accept any migset that contains imported documents. All imported objects will be processed by the adapter in the following way:

• If the Exchange email was deleted previously by Documentum importer or by a previous run of the Exchange Removal adapter then the object will be ignored

• If the Exchange email was not deleted previously, the adapter will connect to the Exchange Server where the email was scanned from and delete it. If the object could not be deleted because any reason an appropriate error will be logged in the run report log so the user can see that and fix the errors manually.

Before actually deleting a mail from Exchange server, a backup is made at the location specified by the backupLocation parameter. The mail is saved as .eml file and its metadata is saved as an xml file that is recognizable by the filesystem scanner. If the backupLocation parameter is empty, the emails will not be backed up.

Exchange Removal properties

To create a new Exchange Removal job you must create a new importer and specify the respective adapter type in the importer’s Properties window – from the list of available adapters “ExchangeRemoval” must be selected. Once the adapter type has been selected, the Parameters list will be populated with the parameters specific to the selected adapter type, in this case the ExchangeRemoval adapter’s properties.

The Properties window of an importer can be accessed by double-clicking an importer in the list, or selecting the Properties button or entry from the toolbar or context menu.

Common importer parameters

Configuration parameters	Values
Name	Enter a unique name for this importer Mandatory
Adapter type	Select ExchangeRemoval from the list of available adapters Mandatory
Location	Select the Job Server location where this job should be run. Job Servers are defined in the Jobserver window. If no Job Server has been created by the user to this point, migration-center will prompt the user to define a Job Server Location when saving the Importer. Mandatory
Description	Enter a description for this job (optional)

Exchange Removal parameters

The configuration parameters available for the Exchange Removal adapter are described below:

Configuration parameters	Values
backupLocation	The location on the filesystem where the mails and their metadata will be saved before they are deleted from the Exchange server. The metadata will be saved in xml files that will be recognized by filesystem scanner. If the parameter is empty the mails will not be backed up.
numberOfThreads	The number of concurrent threads that will be used for deleting emails from Exchange server. Mandatory
loggingLevel	Sets the verbosity of the log file. Values: 1 - logs only errors during scan 2 - is the default value reporting all warnings and errors 3 - logs all successfully performed operations in addition to any warnings or errors 4 - logs all events (for debugging only, use only if instructed by fme product support since it generates a very large amount of output. Do not use in production) Mandatory

Log files

A complete history is available for any Exchange Removal job from the respective items’ History window. It is accessible through the History button/menu entry on the toolbar/context menu. The History window displays a list of all runs for the selected job together with additional information, such as the number of processed objects, the start and ending time and the status.

Double clicking an entry or clicking the Open button on the toolbar opens the log file created by that run. The log file contains more information about the run of the selected job:

• Version information of the migration-center Server Components the job was run with

• The parameters the job was run with

• Execution Summary that contains the total number of objects processed, the number of documents and folders scanned or imported, the count of warnings and errors that occurred during runtime.

Log files generated by the Exchange Removal can be found in the Server Components installation folder of the machine where the job was run, e.g. …\fme AG\migration-center Server Components <Version>\logs

The amount of information written to the log files depends on the setting specified in the ‘loggingLevel’ start parameter for the respective job.