QuickMail Migration to Lotus Notes

	Home
	Main Page

	E-mail Solutions
	Migrations
	Integrations
	Gateways

	Application Development
	Internet / Java / XML
	Iris Recognition
	Custom Applications
	APPC / LU 6.2
	3270 EHLLAPI

	IT Integration
	Year 2000
	Legacy Applications
	Application Porting

	Mainframe Services
	Capacity Planning
	Performance Tuning
	Service Level Agreements
	Accounting & Chargeback

	About us
	Company Profile
	Major Projects
	Our Staff
	Our Partners
	Contact us

Migration to Lotus Notes.

Overview

This program allows QuickMail users to migrate their Mail Folders including Attachments, Personal Address Books and Personal Address Groups to Lotus Notes.

The program migrates both QuickMail PRO and QuickMail LAN versions.

It supports both MAC and PC platforms.

The program, QMNotes.exe, (the "Migrator" Program) is intended to be used by an administrator responsible for the migration.

The following network environment should be setup:

•	A shared ("root") sub-directory should be created which can be accessed by all QuickMail users;
•	under this root directory, create a "UserID" sub-directory for each user (you can use either their short name or full name as the sub-directory’s name);
•	each user should have write access to their sub-directory to copy their Mail Folders, Personal Address Books and Personal Address Groups;
•	the administrator’s workstation requires read access to the root and all sub-directories;
•	the administrator’s workstation should have "Manager" rights to all the Mail database files for the migrated users

QuickMail users ready for migration should copy their mail folders into a sub-directory named:

..\<user id>

on a server accessible by the administrator's workstation.

The administrator starts the program and selects all or some of the QuickMail users for migration.

The Migrator reads each user’s Mail Folders and files. It converts the data into an intermediate migration files (PRI and SEC). These files are read by LotusAgent.DLL supplied with the program to import data to Notes user’s Mail database file.

When the program runs, a set of log and error files are generated. The log files are in a tab-delimited format. The logs can be read using a text editor, but are best viewed in a spreadsheet. The error files are written in plain text, not tab-delimited.

QuickMail Address Books and Distribution Lists will be converted to QM_PAB.NSF (Notes Personal Address Book file) and sent to user’s Inbox .

Preparing for Migration

Mail Folders, Personal Address Books (PAB), Personal Address Groups(PAG):

•	QuickMail Folders are stored as PC/Mac sub-directories.
•	PABs and PAGs are stored as files.

For example Quick Mail PRO stores all the files in a QMail sub-directory:

All files and sub-directories from the QMail sub-directory should be copied to the <UserId> sub-directory described in the Overview above.

MAC Users can copy the files using our MRU utility program. This program runs on the MAC platform. It copies a source directory and renames all sub-directories and files (if necessary) to ensure that only valid WIN32 characters are used in the destination directory.

Program Description

The program is written in Microsoft Visual Basic 5.0 and can run on Win95 or NT platforms. The program is called QMNotes.exe. It invokes a series of wizard like screens. The following pages describe each form.

Startup Screen

Optional User Names File

This field points to a text file, which consists of a list of user names. If the file is not supplied, you can manually enter User IDs on the second screen.

To find a name, click on a user’s entry in the Address Book and check the "User name" or "Short name and/or Internet addresses" fields.

Note: user names are case sensitive.

Input Drive and Path: QuickMail Folders

Specifies the drive and path of the root sub-directory described in the Overview above.

For example:

Q:\QmailMig\UserData Select this sub-directory

…

Q:\QmailMig\UserData\RGens\Main.add

Q:\QmailMig\UserData\RGens\Managers.grp

Q:\QmailMig\UserData\RGens\InBox\

Q:\QmailMig\UserData\RGens\My Filed Mail\

Q:\QmailMig\UserData\RGens\Research\

…

Q:\QmailMig\UserData\VGukov

Q:\QmailMig\UserData\VGukov\MyAddr.add

Q:\QmailMig\UserData\VGukov\InBox\

Q:\QmailMig\UserData\VGukov\Jokes\

Q:\QmailMig\UserData\VGukov\Development\

PRO Version and LAN Version option buttons

Click the version from which the QuickMail users are migrating.

Notes Server

Location of Intermediate Files

Specifies the drive and path of a sub-directory where the intermediate migration files (.PRI and .SEC) created during migration will be stored.

Domino Server name

Enter the name of the Notes Domino server.

Log Files Drive and Path

Use the Browse button to select the Logfiles Drive and Path where the file(s) will be created.

1) A log file is created which summarizes the activity performed during a run. The file’s name is MIGRATOR.LOG.It is a TAB-delimited text file which can be read by a text editor but is best viewed in a spreadsheet. You may choose to re-run a migration for a particular user (i.e.: user has new mail they want migrated). New information from each run is appended to the file if it already exists. A title is generated at run-time to differentiate new data apart from previous runs.
The log describes each user’s migration under the headings:

"Migrated User's Name"
"Date & Time Migrated"
"Total # Folders"
"Total # Items"

2) During a particular user’s migration, any warnings or errors encountered will be written to a text file. This file is written in plain text and is not TAB-delimited. The file’s name is "<User Id> .Error". You may choose to re-run a migration for a particular user (i.e.: user has new mail they want migrated). New information from each run is appended to the file if it already exists. A title is generated at run-time to differentiate new data apart from previous runs.

Each warning/error specifies the:

•	Folder Name,
•	Mail item’s filename and
•	a description of the problem.

3) The two check boxes can be used to specify more logging files. If enabled (by clicking on the checkbox), each migrated user will have a log file created for them. These logs are overwritten if they already exist. Both of these log files will have a file name of with the following extensions:

•	.FolderLog for Folder Logs
•	.MailLog for Mail Item Logs

Folder Logs - generates a summary for each folder under the headings: "Folder Name", "Size", "Mail" (# of mail items in the folder) and "Date & Time Migrated"
Mail Item Logs - generates detailed information for each mail item under the headings: "Folder Name", "Sender", "Date", "Time", "Msg Size", "# lines", "Date & Time Migrated" and "Subject".

Password Prompt

Clicking the "Next" button will initialize a session with Notes and you will be prompted to supply your password:

A test database file QM_PAB.NSF is created in the intermediate files sub-directory. Once the password has been validated, the file is deleted.

User Input Screen

This screen displays the contents of the User Names File (if specified on the startup screen). The list box will be blank if no file was specified.

To edit this list, highlight a name. It will be displayed in the text box below. The text box can be edited:

•	Replace: updates the selected Mail file
•	Add: inserts a new Mail file
•	Delete: remove multiple selected entries

The edits are for run-time use only and do not update the file on disk.

User Selection Screen

This screen allows the administrator to select a subset of users for the current migration batch. The single arrows move highlighted names. Double arrows move all.

Migration Status Screen

This screen displays the migration progress for each selected user.

After the program finishes extracting QuickMail information into intermediate migration files for each user, Import component (LotusAgent.DLL) will be invoked.

Import progress windows will appear:

The user’s PAB and PAG are converted into a QM_PAB.NSF database in the intermediate files sub-directory. Once the user’s migration has finished, the file is deleted.

When the import component finishes, the next user’s data is extracted.

When all the selected users have been migrated, the screen will be changed