Preparing Novell GroupWise for Migration

A Transend Corporation White Paper

Preparing Novell GroupWise for Migration

Transend Migrator 10.x

Transend Migrator Forensic Edition 10.x

Copyright February 11, 2011 by Transend Corporation

Table of Contents

Section 1: Introduction .....................................................................................................................1

Section 2: Basic Requirements ..........................................................................................................1

Section 3: Preparing Novell GroupWise Server for Migration .............................................................2

Enabling the IMAP Protocol ............................................................................................2

Section 4: Preparing the Workstation for Migration ..........................................................................4

Section 5: Setting up GroupWise Admin Permissions .........................................................................5

Proxy Access .................................................................................................................5

Trusted Mode ...............................................................................................................8

Section 5: Technical Support ........................................................................................................... 10


Page 1 of 10

Section 1: Introduction

This Preparation Guide provides an overview of preparing a Novell GroupWise server and workstation

for Migration. This document is not intended to include every possible configuration. Instead, it’s an

introduction to the recommended configurations so you can adjust as needed.

Section 2: Basic Requirements The following list contains the basic requirements for migrating from or to Novell GroupWise.

• The GroupWise Server must be version 5.5 or above (You need version 6.5 or greater to take

advantage of Trusted Mode).

• The workstation performing the migration must have the Novell Client installed. For Trusted

Mode, you must be logged in with the Administrative account granted access to all of the user

accounts.

• The IMAP4 Protocol must be enabled so that live message data can be migrated through this

protocol. You may use the GroupWise Client API; however, it is strongly recommended that you

use the IMAP4 protocol when migrating live email to or from GroupWise.

• In some cases, when migrating between Microsoft Exchange and Novell GroupWise we

recommend using two migration workstations. One workstation solely for the GroupWise API

and GroupWise connections and another workstation solely for Microsoft Outlook and Exchange

connections. This is because the GroupWise and Outlook clients use similar mapi32.dll files, and

they often conflict.

• GroupWise archives must belong to active accounts or they will not migrate. If you will be

migrating from multiple GroupWise archives then it is recommended that those archives are

centralized in a file share.

Note

If migrating between GroupWise and Outlook, you may use the OST/PST (non-MAPI) conversion choice

when migrating from Microsoft Outlook OST or PST files. This conversion choice does not require

Microsoft Outlook to be installed.


Page 2 of 10

Section 3: Preparing Novell GroupWise Server for Migration

Below is an introduction to enabling the IMAP protocol on your GroupWise Server. In many cases, the

IMAP4 protocol is already enabled. Please contact your Netware Administrator for any other

requirements you may need. Transend technical support cannot assist you in changing your Netware

and GroupWise settings.

Enabling the IMAP Protocol

1. Log into the workstation where ConsoleOne is installed

2. Start ConsoleOne

3. Select your GroupWise system

4. Select the Post Office Agents from the Toolbar

5. Select the Properties of the Post Office Agent

6. Select the Agent Settings from the GroupWise tab

7. Select the Checkbox to Enable IMAP if it is not already enabled


Page 3 of 10

8. If the settings do not take effect right way then you may need to restart the Post Office Agent

(POA), or restart your GroupWise server.


Page 4 of 10

Section 4: Preparing the Workstation for Migration

Review the following items when preparing your workstation for migration. In some cases people have

been able to successfully migrate without loading the Novell Client, and without using multiple

workstations for a migration. Each project is different, and some GroupWise and Windows

environments have their own unique challenges. Use the following information as a guide. If you run

into technical difficulty with Windows, Netware, GroupWise, or Exchange/Outlook then we will first

refer you to these steps:

1. Use Microsoft Windows XP, Vista, or Windows 7 to migrate email data. You may also use

Windows 2003 or 2008 Server software; however, we do not recommend that you migrate

email data on the same system as the email server software.

2. Install the Novell Client Software onto the workstation performing the migration. Ensure you log

into Netware using the correct Tree, Context, and Server required for the GroupWise email

system you are migrating.

3. The Novell email client is required to migrate Address Books, Calendars, Task/To Do items, and

GroupWise archives. It is recommended you use the IMAP4 protocol to migrate messages.

If you are migrating to or from Microsoft Outlook and Exchange, and if the workstation will have Novell

GroupWise and Microsoft Outlook email client loaded onto it, then Outlook must be the default email

client for Windows. Also, make sure the Novell GroupWise profile is the default profile for Microsoft

Outlook.


Page 5 of 10

Section 5: Setting up GroupWise Admin Permissions

You must have permission to migrate GroupWise user accounts, and there are three different ways to

access user accounts for migration. They are:

1. Provide the user ID and password for each user

2. Give the account performing the migration Proxy access to each user account. Proxy access is

normally granted by the user. Often, the Admin will give Proxy access to a GroupWise admin

account during account migration.

3. Use Trusted Mode if you are running GroupWise version 6.5 or higher. Trusted Mode allows you

to perform migrations for users without having to know each user password. You must have

admin permission on the GroupWise server in order to use Trusted Mode. A user ID is still

required.

Proxy Access

It is recommended that you use Trusted Mode (explained below) instead of Proxy Access because it is

much easier. If you cannot use Trusted Mode or Proxy Access then you must provide the username and

password for each user.

Proxy Access allows one user to access email for another user. It is used when logging into GroupWise

using the GroupWise email client API. More information can be found on Proxy Access in the GroupWise

documentation. Proxy Access allows User A to grant access rights to User B, so that User B may read or

create email for User A.

If Proxy Access has been given to the Admin performing the email migration then the Admin account will

be able to convert email for users without knowing their password. It is recommended that you use

Trusted Mode (see above), but if you are using a version of GroupWise older than 6.5 then Trusted

Mode is not an option. In that case, use Proxy Access or provide the user password.

Use the GroupWise email client to give Proxy access to another user. The following procedures detail

how to give another user Proxy access to your account:

1. Start Novell GroupWise and Select Tools from the Toolbar

2. Select Options

3. Click on the Security Icon

4. Select the Proxy Access Tab


Page 6 of 10

5. Enter the name of the person who you wish to grant Proxy access in the text box, or choose the

Address Book Icon and locate the user.

6. At a minimum, give the user Read access Rights to Mail, Appointments, Reminder Notes, and

Tasks.

7. Press Apply and then OK

To Perform a Proxy login using Transend Migrator modify the syntax of the GroupWise User field.

Instead of using a single User ID, enter “UserB for UserA”, where UserB is the person who has been

granted Proxy rights, and “UserA” is the person who owns the mailbox. The password required will be

that of UserB. In batch mode, this syntax is used for the “FromDatabase” field.


Page 7 of 10

The following screen shot is an example of using a Proxy account when migrating a single user mailbox

with Transend Migrator:

In migrating multiple user mailboxes via batch mode, you would use the ToDatabase or FromDatabase

keywords to specify the source or destination account, and this is also where you would enter in the

Proxy information.

Example:

FromDatabase = tlincecum for bposey

ToDatabase = tlincecum for bposey


Page 8 of 10

Trusted Mode

Perform the following steps to configure Transend Migrator as a Trusted application. This procedure

requires Netware Admin access to the GroupWise email server.

1. Download the Transend Trusted package from www.transend.com/ftp/gwtrustd.zip. This

package contains two files, gwtrustd.exe and gwtapp.dll.

2. Place gwtrustd.exe in the same installation directory as Transend Migrator, and place gwtapp.dll

into a directory on your system path, for example C:\Windows\System32.

3. Log into the Novell Network using the Novell Client as the GroupWise administrator.

4. Map a drive to the location of where the GroupWise domain and post office can be found (See

Windows Help for how to Map a Drive for your version of Windows). The Trusted application

requires a mapped drive and it needs to know where the domain files are located.

5. Open a Command Prompt by going into the Windows Start | Accessories program group or by

using the Start | Run command. Change directories so that the current directory is the Transend

Migrator installation directory.

Type in the following command to change directories:

CD\”Program Files\Transend Migrator”

6. Type in GWTRUSTD.EXE and press the Enter key

7. Press Y to continue or N to quit

8. Enter the name of the Trusted Application or press the Enter key to accept the default name of

Transend Migrator. If you will be setting up more than one migration workstation then you will

have to go through these procedures on each workstation, and you must provide a unique name

for the Trusted Application.


Page 9 of 10

9. This utility will ask you for the path to the GroupWise domain directory (This is the directory in

which you can find the files gwdom.dc and gwpo.dc).

10. Enter a TCP address if you want Transend Migrator to be run from only the specified location.

Normally, this option is not used.

11. When it completes successfully Transend Migrator will be a Trusted application. It creates inside

the Transend Migrator installation directory the file gwappkey.dat, which contains the key

information that Transend Migrator uses to enable Trusted mode.

At this point you can run Transend Migrator as a Trusted application; however, you must tell

Transend Migrator that it is in Trusted mode by using one of the following Custom Options:

Criteria Switch

When using the GroupWise Client API

/trusted

When using the IMAP4 Protocol

/gwtrusted

These switches can be enabled in Transend Migrator by going to Migration Options | Custom Options|

GroupWise and checking the Enabled checkbox.

Trusted Mode – IMAP Protocol


Page 10 of 10

Trusted Mode - GroupWise API

Section 5: Technical Support

Technical support is available to help you understand how to use Transend Migrator with your migration

project. Please review the Help File and online resources before contacting technical support.

Technical support is available Monday through Friday, 9:00AM - 5:00PM (Pacific Time).

You are encouraged to submit questions through email. This will allow us time to properly research your

situation and make appropriate recommendations.

Email: [email protected].

Phone: (650) 324-5370

Transend Corporation

225 Emerson Street

Palo Alto, CA 94301

(650) 324-5370

www.transend.com

Preparing Novell GroupWise for Migration

Documents

Transcript of Preparing Novell GroupWise for Migration