How do I increase logging for Exchange Migrator? (NETIQKB2201)

  • 7702201
  • 02-Feb-2007
  • 21-Jan-2008

Resolution

goal
How do I increase logging for Exchange Migrator?

fact
Exchange Migrator 1.x

fact
Exchange Migrator 2.x

fix
This is how you create the EMDevlog for Exchange Migrator (EM) versions 1.1 and later.

To increase logging for Exchange Migrator do the following:

  1. Make sure to close the Exchange Migrator MMC.
  2. Browse to C:\Program Files\Netiq\Exchange Migrator>EMDiagnosticUtil.exe.
  3. Double click the diagnostic utility and set the logging to "Maximum".
  4. Run a new migration
  5. After the migration click on the EMDiagnositcUtil.exe again and walk through the wizard.
  6. The logs are created in a Zip file (Exchange Migrator.zip) stored under the %root%:\Program Files\Netiq\Exchange Migrator\Logs directory.

You should only create this log if you are experiencing problems with a migration.

There are a few different logs for Exchange Migrator.

Exchange Migrator stores these files in the Logs folder under the installation folder. If you install Exchange Migrator in the default location, the log files are stored in Program Files/NetIQ/Exchange Migrator/Logs. You can view the log files after you run a migration wizard or by using a text editor, such as Notepad.

The database location file, EMAPluginsHarvest.log, identifies the location of the Exchange Migrator database filename, server, and path. The Exchange Migrator database is created in the folder where you install Exchange Migrator by default.

In the EMAppLog.txt application log file, Exchange Migrator writes migration operations, status, and error messages. Each time you perform an operation in Exchange Migrator, text about the operation is added to this log file. Review this file for details about errors or migration failures.

The detailed error log file, EMDevLog.txt, contains more detailed operations information. Normally, you enable this log only when communicating with NetIQ Technical Support representatives in the case of problems. Each time you perform an operation in Exchange Migrator, detailed operation results are added to this log file. The EMDevLog.txt file can grow rapidly. Be sure to disable this log file if you do not need this detailed information.

The following line is a sample message from a EMDevLog file:

<--DATE--> <-TIME-><S><-LN-> <--------DESCRIPTION-------->

2001-03-12 11:51:59+++(0485) Migrating from Exch5.5 to Exch2000

When you start the EMDevLog and the EMAppLog at the same time, the line numbers (labeled LN in the above sample) correspond to entries in both log files. A three-character code (labeled S in the above sample) in each line indicates the following message types:

%%% Start of log for the current session.

--- Status information.

+++ Completed successfully.

*** Not completed successfully.

*++ Warning: the application is trying to recover from a problem.

Additional symbols can appear in the EMDevLog file with the following message types:

::: General information

=== The value of a variable

>>> Entering a met



    Additional Information

    Formerly known as NETIQKB2201