|
|
|
| USING
TRANSEND MIGRATOR FOR NOVELL GROUPWISE TO MICROSOFT
OUTLOOK/EXCHANGE CONVERSIONS |
|
|
|
|
Updated May 10, 2004 |
| |
| OVERVIEW |
|
|
|
| Transend® Migrator is a client-based utility for converting the following Novell GroupWise data to Outlook/Exchange:
|
| |
- Messages/Folders
- Local Archives
- Address Books
- Calendars
- To-Do
|
| GroupWise versions 5.x, 6.x or higher are supported. All versions of Outlook/Exchange are supported. Both the GroupWise and Outlook clients need to be installed on the PC running Transend Migrator, which can be installed on a network drive or the end user's PC.
|
| |
| Transend Migrator typically is run from the end user's PC, but can also be run for multiple users from a central location (see below Running Transend Migrator from a Central Location). Transend Migrator includes both a graphical Windows interface with easy to follow wizard-like instructions as well as a powerful command line batch mode processor.
|
| |
| GroupWise data can be converted to the user's Exchange mailbox or an Outlook .pst file. Transend Migrator provides a report of the completed migration and generates a detailed log file. |
| |
| MESSAGE/FOLDER
AND ARCHIVE CONVERSION |
|
|
|
| Messages are converted from the GroupWise file cabinet (post office database) or local archives. Archive conversion requires GroupWise client 5.5 or above. The GroupWise folder hierarchy is maintained in Outlook (in either the Exchange server mailbox or a .pst file). All message properties are maintained, including: to/from addresses, cc and bcc fields, dates, message priority and subject. Attachments are converted and maintained with the migrated messages or can be detached from the message and copied to a specified directory. Addresses can be converted to a format that is repliable through Exchange based on a specified name conversion rule. |
| |
| ADDRESS BOOK
CONVERSION |
|
|
|
| Transend Migrator converts the user's GroupWise 5.5 or higher address book directly (via the Object API) to the Outlook Contacts. For earlier versions of GroupWise, the address book must be converted manually using the GroupWise client via the NAB format, which Transend Migrator can then import into Outlook Contacts. An email address conversion rule can be specified, if desired. |
| |
| Direct conversion to Outlook Contacts via the Object API supports the following GroupWise address book fields: Display Name, E-mail Address, E-mail Type, First Name, Last Name, Comments, Office Phone Number, Home Phone Number, Organization, Title, Department, Cellular Phone Number, Fax Number, Country, City, State, Address, ZIP Code, and Greeting. |
| |
| Conversion via the NAB format supports: E-Mail Address, Name, Last Name, First Name, E-Mail Type, Office Phone Number, Title, Organization, Fax Number, City, State, Address, ZIP Code, Home Phone Number, Phone Number, Cellular Phone Number, Department, Pager #, Internet Address, and Comments.
|
| |
| CALENDAR AND
TO-DO CONVERSION |
|
|
|
| The user's GroupWise calendar and tasks are converted to the Outlook calendar and tasks, respectively. Calendar data fields supported include: Location, Subject (title), Sender, Start Date, End Date, Comments, and Attendees. Task data includes subject and due date.
|
| |
| TRANSEND
MIGRATOR SYSTEM REQUIREMENTS AND INSTALLATION
|
|
|
|
| The following hardware and software are required to use Transend Migrator:
|
| |
- All versions of Windows
- 16 mb RAM
- Enough disk space to store converted files
- Exchange/Outlook: MAPI32.DLL and associated DLLs
- GroupWise: 5.x, 6.x client or GroupWise Gateway API
- GroupWise: 5.5 client or higher for Archives
|
| To install Transend Migrator, run the install file TM35SHIP.EXE (the file name may change to correspond with the version number). You may select the install directory, and optionally create a program group for the main executable TM.EXE. |
| |
| All documentation is provided via a Windows Help file. You can invoke the help system by running TM.EXE and pressing the HELP button, or by running WINHELP.EXE and opening the file UA.HLP.
|
| |
| The setup program will copy files required by all conversion types. For a smaller installation, you may remove DLL files that are not required by the type of conversion you are doing.
|
| |
| Transend can provide a custom install version that will set many of the defaults to your specification and include the license key.
|
| |
| RUNNING
TRANSEND MIGRATOR IN INTERACTIVE MODE (GUI) |
|
|
|
| When Transend Migrator starts, it displays the Conversion Type screen. This allows you to indicate which type of conversion you will be performing. You may select Message Folders, Address Books, Calendars or Tasks. |
| |
| The logon screen for GroupWise message conversion asks you to enter values for the GroupWise user name and password. For address book conversion you can also specify the name of the address book to be converted and an address conversion rule. For archive conversion the user checks the "Use Archive" box on the Transend Migrator GroupWise logon screen.
|
| |
| In order to access Exchange or Outlook for the migrated data, you must have already installed the Exchange or Outlook client on your machine. In most cases Outlook will be accessed via a "profile". If you are using a profile, enter the name of the profile here. As an alternative to using predefined profiles, you can tell Transend Migrator to create a .pst file that you specify. If you are converting address book data, this screen will include the field "Contact Folder", where you may enter an alternate name of the folder containing your contacts if you are not using the standard default.
|
| |
| The folder selection screen presents a list of all existing GroupWise folders (what you are converting from). GroupWise folders in a multi-level hierarchy (folders within folders) will be separated from higher levels by a slash. Single or multiple folders can be selected for conversion.
|
| |
| Prior to running the conversion, the following options can be set from the Miscellaneous Options screen:
|
| |
 |
|
Convert only those...: To convert only those messages that contain the given string. Leave this field blank to convert all messages. |
| |
|
|
|
Max Attachment Size: This field allows you to limit the size of attachments that are converted. If you want all attachments to pass, enter all 9's in this field. There is a command line switch that allows you to specify that deleted attachments will be copied to a directory. See Command Line Options. |
|
|
|
|
|
Max Distribution List: Use this field to cut off a distribution list (to's and cc's) at a given number. |
|
|
|
|
|
Oldest Message Date: This option allows you to convert only those messages that were created more recently than the given date. To convert all messages, enter a very old date (such as Jan 1, 1980, the default). |
|
|
|
|
|
Message Store: This field appears only if you are converting to a system that supports multiple message stores, such as Exchange or Outlook. In that case, you may select the message store from the drop down list. |
|
|
|
|
|
Name Conversion: For many conversions, the original email address of people on the distribution list will not make any sense in the new system. This field allows you to create an Internet style address based on a display name. |
|
| |
| COMMAND LINE
OPTIONS |
|
|
|
| The following command line switches may be used when running the main GUI executable, TM.EXE, or the batch mode processor, TMB.EXE.
|
| |
| General Switches: |
| |
|
|
|
Work Directory: The work directory is where temporary files used during the conversion are kept. By default this is set to the Windows temp directory, usually c:\windows\temp. You may override this value by using the switch /D . |
| |
|
|
|
System Directory: The system directory is where the Transend Migrator configuration file and log file are stored. By default this is set to the Windows directory. It may be overridden by using the switch /S . |
|
|
|
|
|
Enable Logging: Transend Migrator will log various events, including message conversion status, and various errors. By default no log file is produced. To enable logging, use the switch /L. The file is called UALOG.TXT, and is stored in the system directory (see above). |
|
|
|
|
|
Enable Logging: Transend Migrator will log various events, including message conversion status, and various errors. By default no log file is produced. To enable logging, use the switch /L. The file is called UALOG.TXT, and is stored in the system directory (see above). |
|
|
|
|
|
Enable Screen logging. /SL causes logging information to be sent to the display screen. |
|
|
|
|
|
No Config File Write: To prevent the configuration file UA.CFG from being written back to disk, use the switch /NCFG. This will prevent your recent user options from being saved, but will prevent errors if your configuration file is not in a writable directory. |
|
|
|
|
|
Character Conversion: Transend Migrator attempts to automatically determine what type of character set conversion is necessary for your migration by running text through the Windows facility for character conversion. However this process sometimes fails, so it may be necessary to select a different type of conversion. If you notice a problem with non-English character sets not displaying properly, try one of the following command line switches when starting Transend Migrator(tm.exe): |
|
|
|
|
|
| /NOCC |
|
(No character conversion)
|
|
| /CC2 |
|
(Most European languages)
|
|
| /CCC |
|
(Portugese) |
|
| /CCN |
|
(Nordic, i.e. Danish, Swedish) |
|
| /CCP |
|
(Polish) |
|
| /CCI |
|
(Italian)
|
| |
|
|
| /CCZ |
|
(Czech) |
| |
|
|
| /CCJ |
|
(Asian languages and Russian)
|
| |
|
|
| /CCG |
|
(Greek) |
|
|
|
|
|
|
Detach attachments: The user interface provides a method for restricting the size of attachments that are converted. This option allows you to extend this capability by specifying that such attachments are to be copied to a directory, as well as deleted from the message. Use the switch /DETACH, followed by a space, followed by the name of the directory to which attachments will be copied. Make sure to fill out the "Max Attachment Size" field in the user interface to specify which attachment will be copied. |
|
|
|
|
|
Sent Mail Folder: When converting a source systems "Sent Mail" folder, you normally want the "To" entry to display in the "From" field, as the sender will always be the same (i.e. yourself). Use the /SENT switch to perform this reversal. |
|
|
|
|
|
Distribution List: /DLIST inserts the distribution list into the message text. |
|
|
|
|
|
GMT Offset: For calendar and email conversions, enter the number of minutes you want to adjust the time by using the switch /TZD, followed by a space, and followed by the value, positive or negative. You may also need to use the switch /DSTOFFSET to alter the number of minutes that Transend Migrator assumes is the difference between daylight and standard times (default is -60). |
|
|
|
|
|
Interactive Mode: Use the switch /IM to force "Interactive mode” when running the batch processor. This causes some APIs (e.g. Outlook) to put up a dialog box if certain logon information is missing or invalid. |
|
|
|
|
|
HTML: Use the /HTML switch to make sure HTML encoded messages are tagged correctly. You may also need to use the switch /DETECTHTML, which causes
Transend Migrator to do additional processing when determining if a messages is HTML encoded. If the above does not work, try the switch /HTMLATTACH, which cause HTML messages to be appended as attachments. You can then click on the attachment, which will cause the message to display properly via your browser. |
|
|
|
|
|
Group Folder Name: When
Transend Migrator creates the folder on the output system, it will be named "XXXXX Folders", where XXXXX is the name of your source system. To change this top level folder name to something else, use the switch /GN . |
|
|
|
| Outlook Switches: |
| Various switches control behavior when converting to Outlook:
|
|
|
|
|
|
/D1: Insert the email address into the Display Name field. |
| |
|
|
|
/CREMPTY: Create output folders even if there are no messages. |
|
|
|
|
|
/D12: When creating distribution lists in the Contact folder, usually each entry of the dlist is also created as a normal contact. This switch disables that, i.e. dlist entries appear only in the dlist. |
|
|
|
|
|
/D17: Do not create distribution lists in the Contacts folder. |
|
|
|
|
|
/CF : Change default name of "Contacts" folder. |
|
|
|
|
|
/CAF : Change default name of "Calendar" folder. |
|
|
|
|
|
/SKIP : Ignore give folder name when building internal table of folders. Usually used with "Public Folders" to avoid long login time to read thru thousands of folder names. |
|
|
|
| Lotus Notes Switches: |
| The following switches affect behavior when importing/exporting Lotus Notes: |
|
|
|
|
|
/ML: Enable Multi Login, may be used to solve some login problems. |
| |
|
|
|
/DELETEMSG: Delete GW message from folder after reading it (dangerous). |
|
|
|
|
|
/GWPROMPT: Force GW to prompt for password in batch mode, if required. |
|
|
|
|
|
/GWARCH : Specify GW archive directory. |
|
|
|
|
|
/GWLOGIN : Pass parameter line to GW during login phase |
|
|
|
|
|
/GWCF : Specify name of GW calendar (default "Calendar"). |
|
|
|
| |
| RUNNING
TRANSEND MIGRATOR IN BATCH MODE |
|
|
|
| Transend Migrator has a batch mode processor that allows you to perform multiple conversions with no user input. This is done by running the program TMB.EXE. TMB by default looks to the file UAB.DAT for its script. You may also supply a different file name.
|
| |
| A script consists of various keywords that supply the same information that is collected by the user interface. When all the required information is present, you trigger a conversion by using the keyword "Start". TMB performs the requested conversion, and then returns to processing the script. If additional data is found, the process begins again. The UAB.DAT file that is supplied with Transend Migrator can be used as a starting point for your own script.
|
| |
| RUNNING
TRANSEND MIGRATOR FROM A CENTRAL LOCATION |
|
|
|
| While Transend Migrator is a client level tool, it can be run from a centralized location, without any user intervention. For centralized operation, access is required to both the users' GroupWise email files (typically stored on a server) and/or local archives, if archive conversion is desired.
|
| |
| In addition, if the converted GroupWise data is to reside on the Exchange server versus a .pst file, an Outlook profile defined for each user being migrated is required. Otherwise, GroupWise data can be converted to Outlook .pst files (one for each user) and distributed to them for adding to their Outlook profile. Transend Migrator can create the .pst files. Many organizations prefer converting to a .pst file so the new Exchange server doesn't get filled up with old data.
|
| |
| Transend Migrator can be run in an interactive or batch mode. Batch mode can be used to significantly automate the migration process and is described above. A single batch mode .dat file can be created for multiple users, which would enable the conversion of groups of users in a single process. If converting to .pst files, each Outlook .pst file could be named with the corresponding GroupWise user name.
|
| |
| CUSTOMIZATION |
|
|
|
| While the standard version of Transend Migrator meets a wide variety of conversion requirements, Transend is pleased to work with IT organizations to tune Transend Migrator if modifications are necessary for a particular environment or needs. For large scale migrations, for example, it may be desirable to modify defaults or assist in the development of a wrapper that draws on Transend Migrator's batch mode processor to fully automate the migration process. Or, it may be desirable to modify the GUI and provide defaults that conform to a particular migration process and environment. Transend has extensive experience working with IT departments around the world in such efforts.
|
| |
| FOR MORE INFORMATION |
|
|
|
| This document is intended to provide an overview as well as some specific information regarding using Transend Migrator for a GroupWise to Outlook/Exchange migration. Transend Migrator is a utility for converting between a wide variety of email systems, including Lotus Notes, Microsoft Outlook/Exchange, Novel GroupWise, Netscape, Eudora, IMAP and more. For additional information, please contact Transend Corporation:
|
| |
- Telephone: 650-324-5370
-
| Email: |
 |
- Fax: 650-324-5377
|
