Home / Platform Considerations

GroupWise Considerations

If you are migrating multiple GroupWise accounts you may use Trusted or Proxy mode for administrator authentication. If migrating a single GW account, or only a few accounts, you may use a logon and password (for each user) in order to connect to the GroupWise email server.

Authentication

Trusted Mode allows you to perform migrations for users without having to know each user’s password. You must have admin permission on the GroupWise server in order to use Trusted Mode. A user ID is still required, and you must be running GroupWise 6.5 or greater for this ability to be used.

Proxy Mode does not require admin permission. Instead, the alternate user account you will be migrating must give you proxy access to their data.

Trusted Mode for GroupWise 2014/2018

Create a trusted app key for GroupWise 2014 and 2018. Enable Transend Migration Console to use the gwappkey.dat file to access source or target GroupWise Accounts via GroupWise IMAP or GroupWise Web Services.

  1. Open the GroupWise Admin console
  2. Click System > Trusted Applications, then click New
  3. Enter Name: Transend Migration Console
  4. Enter Description: Transend Migration Console
  5. Click OK
    Alt text
  6. Copy the license key to notepad and name it gwappkey.dat
  7. After the key file is created, it must be edited so that it is recognized by Transend Migration Console. Open the gwappkey.dat file with Notepad or a text editor. Notice, the unique key will be the only entry in the file
    Alt text

Important:

  • Add the name of the Trusted Application to the first line. In the above example, the Trusted Application is called Transend Migration Console.
  • Enter a carriage return / line feed after the unique key.
  • Save the modified gwappkey.dat file.
  • Copy the gwappkey.dat file C:\ProgramData\Transend
  • Click Browse to locate the gwappkey.dat in the Console Verify

Trusted Mode for GroupWise 2012

You can create a Trusted Application key in ConsoleOne, and enable Transend Migration Console to use this key so that it can access user accounts without the need for a password. The following steps outline how to create a Trusted Application Key using ConsoleOne.

Note: Your workstation must have the GroupWise Client installed, and you must be logged in as an Admin having permission to run the trusted application.

  1. Start ConsoleOne.
  2. Select Tools from the menu.
  3. Select the GroupWise System Operations submenu.
  4. Choose the Trusted Applications program.
  5. Press the Create button.
  6. Enter the Trusted Application name. If you are running Transend Migration Console on multiple workstations, create a different key with a different name for each workstation.
  7. Enter the location for the key file.
  8. Enter the name of the key file. For Transend Migration Console to recognize the key, it must be named gwappkey.dat.
  9. Press OK to create the key.

After the key file is created, it must be edited so that it is recognized by Transend Migration Console.

  1. Open the gwappkey.dat file with Notepad or a text editor. Notice, the unique key will be the only entry in the file.
  2. Add the name of the Trusted Application to the first line. In the above example, the Trusted Application is called Transend Migration Console.
  3. Enter a carriage return / line feed after the unique key.
  4. Save the modified gwappkey.dat file.
  5. Copy the gwappkey.dat file into the same directory where Transend Migration Console is installed. By default, this directory is C:\Program Files\Transend Migration Console\ on 32bit Windows systems, or C:\Program Files (x86)\Transend Migration Console\tmship for 64bit Windows systems.
  6. At this point you can run Transend Migration Console as a Trusted application; however, you must tell Transend Migration Console that it is in Trusted mode by using the /trusted switch (when using the GroupWise Client) or the /gwtrusted switch when connecting to GroupWise using the IMAP protocol. See GroupWise Options for more details on the use of this switch.

Proxy Mode

Trusted Mode is the recommended method for converting user accounts using the Admin’s credentials. If Trusted Mode is not available you can then use Proxy Mode. GroupWise has a feature allowing one user to open email for another user. This is called Proxy Access and 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 Access mode is not an option. In that case, use Proxy Access or provide the user password.

In Transend Migration Console, to perform a proxy login, 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.

Disable Message Size Limits

Depending on your deployment, message size limits may be set to a limit of 10 MB, or another value that should be adjusted prior to migration.

If necessary, it is recommended you disable message size limits prior to migration.