MAIL AND DIRECTORY MIGRATION
Running the upgrade wizard
Users start the upgrade wizard by opening the upgrade notification message received after migration and clicking a button in the message body or by using desktop shortcut. You must have previously installed the upgrade wizard either locally, as part of the user's Lotus Notes client, or on a shared network directory. You send upgrade notification messages to users' Notes mail files after migrating their mail boxes with the upgrade tools in the Domino Administrator.

After a user launches the upgrade wizard, it automatically checks for a Lotus Notes installation on the user's workstation. If a Notes program directory is not found, the wizard fails to load.

The upgrade wizard obtains information about the Notes environment from the active NOTES.INI file in the Notes Data directory and from the upgrade notification message. For users migrating from cc:Mail 2.x and cc:Mail 6.x, the upgrade wizard also obtains information from PRIVDIR.INI on the user's workstation.

Users must run the upgrade wizard from a Lotus Notes client that is either installed on the same computer as the mail data they want to migrate, or at least has access to this data.

Running the upgrade wizard from a desktop shortcut

Alternately, you can create a desktop shortcut from which users can run the upgrade wizard. The shortcut must point to the location where you installed the upgrade wizard and must specify a target application as follows:


By default, the "Start in" field on the Shortcut property page specifies the directory where the upgrade application resides as the starting point for selecting archive files to migrate.

Information the upgrade wizard obtains from the upgrade notification message

The Upgrade Notification message provides information that the upgrade wizard uses to migrate personal mail data. The wizard obtains the following information from the upgrade message:


The cc:Mail to Lotus Notes upgrade wizard uses the message ID to find the message in the user's mail file, so that it can read gateway mapping information for processing archives and private addresses.

Information the upgrade wizard obtains from the NOTES.INI file

The upgrade wizard obtains additional information from the active NOTES.INI file in the Notes Data directory on the user's workstation. If a NOTES.INI file is not found in the Notes Data directory, the wizard searches for it in the Program directory, and then along the system path. The upgrade wizard obtains information from the following values in the NOTES.INI file:
InformationNOTES.INI setting
Personal Address Book (PAB)First entry in "NAMES="
Location of the Notes Data directoryValue of "Directory="
Notes mail file nameValue of "MailFile="
User credentials (password, etc.)Value of "KeyFileName="
The default file name for the Personal Address Book file is NAMES.NSF, which is stored in the local Notes Data directory. The value of the "MailFile" field indicates the name of the active mail as specified in a user's current Location document.