2.9 GroupWise Archive Migration Tool

This migration tool is designed to import native GroupWise archives directly into Retain. Also known as the PAM tool.

The GroupWise Archive Migration Tool is found on the tools page. To access the tools page, select the 'tools' link from the top right of the Retain Server administration page.

There are two modes:

The migration tool uses the GroupWise client to access the archives you want to migrate.

The migration tool does not access the archive files directly. Due to the way GroupWise stores its archives, you need the GroupWise client to read the archives and to hand the data to the migration tool. The migration tool then sends the archives to a Retain Server, much like a worker would.

In normal operation, a Retain Worker reads data from the live GroupWise system and sends it to a Retain Server. With the migration tool, the tool itself is a worker that reads the archived data from the GroupWise client and sends it to a Retain Server.

The migration tool reads the path to the archives as defined in the GroupWise mailbox that you’re accessing. That path must be accessible by the workstation you’re on. It will then ask GroupWise to open the archives and it will read the items in the archive and send them to the Retain Server you have specified.

If you run in single-user mode, the migration tool will access the mailbox currently logged into by the GroupWise client. If none is logged in, GroupWise will be opened and you will be asked to log in.

If you run in multi-user mode, the migration tool will open GroupWise, you can be logged in as any valid user, and it uses the trusted application key to log in to each user specified in a GroupWise distribution list, one at a time.

The GroupWise client on the workstation you’re using must be able to open the archives you wish to migrate. The process depends on GroupWise being able to access these archives. If you’re migrating the archives of another user, as you would be doing in multi-user mode, you must be able to access that user’s archives from the workstation you’re on.

It is not enough that the archives are on a network-accessible volume. GroupWise must be aware of the path to these archives and that path must be available from the workstation you’re going to use for migration. Refer to the error handling section for important configuration.

In multi-user mode, you can use one workstation to migrate the archives of multiple users. In so doing, you can migrate the data without affecting the users in question. In single-user mode, you will run the migration tool on a workstation that has access to the archives you want to migrate (typically the workstation of the user whose archives you’re migrating) and you’ll migrate just one mailbox.

When the Migration Tool is Started - Begin without user intervention the archive process immediately begins without any prompts. Run minimized sets the migration utility to run the migration in the background while the workstation completes other work. The tool may also be set to run automatically on system boot, in case something interrupts the archive job.

When Migration Tool is Running - Contains options to prohibit the user exiting the program before the archive migration is complete and GroupWise login settings. The tool must be able to login and gain access to the archives.

When the Migration Tool has Finished – Contains the behavior of the migration utility on completion; automatic exit, notification, or neither.

CPU priority usage is also set here.

Idle

Lowest

Lower

Normal

Higher

Highest

In order to process more than one user archive the option must be enabled at the top of this page and the users must be verified against the GroupWise system.

It is recommended to only process multiple archives from the same post office.

The Distribution Lists will only be populated if it is enabled and if the ‘Refresh’ button is selected. It displays the available distribution lists. To have the connection work correctly, the GroupWise Client Parameters on the ‘Connections’ tab must be filled-out with the GroupWise Server IP and port. Displayed lists can be selected. The archives belonging to the users in the selected distribution lists will be migrated. If users from multiple Post Offices are to be migrated, employ some kind of FID clash protection by verifying archives or only processing users which can be verified by a specified Domain and Post Office, (specified in DNS:port or IP address:port).

The User List screen allows the migration of multiple users specified by a user list. The user list is a plain text file with one user ID per line. To enable the process, select the ‘Enable Multiple User Processing Using a Text File checkbox, then browse to and select the desired text file.

The error limit and actions taken when an error is encountered are specified on this tab.

Errors may be written to the log file, (specified in the next tab), sent in a pop-up message to the user, or sent as an email to the specified address.

The limit of how many errors may be encountered before the migration utility quits the current user is specified. A setting of ‘0’ sets the limit to infinite.

Important: By default, the current user will be skipped after 20 errors by default.

If an email is desired for each error encountered, email settings must be configured. Select ‘Email Options ‘and input the connection information, source address, destination address, and user login information for the SMTP Mail Server.

The location, logging levels, and buffer of the logging screen are all configured on this tab.

Where Should Log Files be Stored - A specified path, the path to the current location of the application, or a specified path must be selected.

Amount of Detail in the Log Files – The logging level determines how much information is provided in the log files. Unless troubleshooting, log levels of ‘normal’ and ‘errors only’ are sufficient. The buffer size for the logging screen determines how much history the running log screen of the migration tool contains.

This is an informational page showing the connection settings from the RetainWorker.cfg created in the Retain Server. If this information is incorrect, the Retain Server Connection settings must be modified under the worker configuration in the Retain Server, and a new bootstrap file downloaded for use.

The GroupWise Client Parameters contains the connection information used by the Distribution Lists configuration to allow the Migrator to connect to the GroupWise system.

Provide the POA IP or Hostname, GW Client Port (default: 1677), and the POA SOAP URL. (default: http://<POA>:7191/soap)

Save Configuration

Once the configuration has been setup as desired, click ‘Ok’ and select the location to save the changes into a ‘MigrationTool.cfg’ file.

The migration tool uses the configuration file to run the job as you have specified in the configuration tool. You may run the configuration tool as often as you need to set up the migration job to your liking.

When run, the tool will prompt for the configuration file, or automatically load the configuration file if the configuration is found it the same directory, and immediately begin the migration. When the tool runs, you will see a screen like this:

You will see any errors in this screen and it will display a notification when the job is complete.

For each user in a multi-user job, it will read the location of the archives from GroupWise and then it will attempt to open the archives. It is critically important that the workstation used for the migration can access the archive files.

There is a maximum of 5 migrations permitted at any given time. For instance, if you’re running the migration tool from the workstations of your users, only 5 at a time can be migrated, the others will wait their turn. This is to prevent all the migration requests from overwhelming the server.

The migration tool may be deployed using management tools such as Novell ZENworks. This is one method to collect archives which have been stored on users’ workstations. Users may run the tool manually or it can be run automatically.