4.4 Gathering GroupWise Component Information

4.4.1 Post Offices and Domains

Auto-Detection

For NetWare servers, the Server Migration Utility has an Auto-Detect feature that attempts to locate post offices and domains on the NetWare server. The Auto-Detect feature scans NCF files in the sys:\system directory and looks for load commands for the GroupWise agents (for example, gwpoa.nlm and gwmta.nlm). Each agent load command includes the post office directory or the domain directory as the setting for the /home switch. The Auto-Detect feature also identifies startup files for the POA (post_office.poa) and the MTA (domain.mta). If your NetWare server does not have GroupWise NCF files and agent startup files in sys:\system, then the Auto-Detect feature does not find any post offices, domains, or agents.

For Windows servers, the Auto-Detect feature is not available. You must manually specify the locations of post offices, domains, and agents. Post offices and domains could be located anywhere on the Windows server. By default, the Windows agents are installed to:

Default Locations

By default, post offices and domains are migrated to the /var/opt/novell/groupwise/mail directory. This is the typical location for mail directories on Linux. You might prefer a shorter path name (for example, /gwsystem). Be sure to include the post office directory or domain directory in the path (for example, /gwsystem/sales).

IMPORTANT:To minimize case sensitivity issues on Linux, make sure that domain and post office directory names consist of all lowercase letters in NetWare or Windows file systems and in ConsoleOne.

The Linux POA and MTA software is always installed to subdirectories of /opt/novell/groupwise/agents. On Linux, you can choose whether or not you want the agents to run as the root user, as described in the following section of the GroupWise Installation Guide for your version of GroupWise:

Running as a non-root user is strongly preferred for security reasons.

Post Office Information

If you are migrating a post office:

GROUPWISE MIGRATION WORKSHEET

Under Item 8: Post Office Information, specify the directory where the post office database (wphost.db) is located, the full path to the POA startup file, the full path to where you want to migrate the post office (the post office directory), and whether you want the POA to run as root.

If you have more than one POA for the post office, migrate the main one first. Additional POAs must be installed and configured manually.

To find out what changes the Server Migration Utility makes to the POA startup file when it migrates it to Linux, see the following section of the GroupWise Administration Guide for your version of GroupWise:

Domain Information

If you are migrating a domain, you also need to consider the MTA working directory (mslocal). By default, it is located under the domain directory, but it can be placed elsewhere by using the /work switch in the MTA startup file. The Server Migration Utility can copy the mslocal directory for you if it is under the domain directory, on the same NetWare volume, or on the same Windows server as the domain directory. In all cases, it is placed under the domain directory on the Linux server.

If the mslocal directory is located on a different NetWare volume or on a different server, the Server Migration Utility cannot copy it for you. You must copy it manually to the Linux server, as described in Section 8.9, Manually Migrating the MTA Working Directory. You can do this after you have migrated the domain.

If you are migrating a domain:

GROUPWISE MIGRATION WORKSHEET

Under Item 9: Domain Information, specify the directory where the domain database (wpdomain.db) is located, the full path to the MTA startup file, the full path to where you want to migrate the domain (the domain directory), the full path to the MTA working directory, and whether you want the MTA to run as root.

To find out what changes the Server Migration Utility makes to the MTA startup file when it migrates it to Linux, see the following section in the GroupWise Administration Guide for your version of GroupWise:

4.4.2 Additional Agents for a Domain

The Internet Agent (GWIA) and the WebAccess Agent startup files must be identified manually if you want the settings in the startup files to be migrated.

NOTE:The WebAccess Agent is not part of GroupWise 2012, but is part of earlier GroupWise versions.

Internet Agent

The GWIA startup file is gwia.cfg. The default location of the startup file varies by platform:

NetWare:

sys:\system\gwia.cfg

Windows:

\domain\wpgate\gwia\gwia.cfg

GROUPWISE MIGRATION WORKSHEET

Under Item 10: Internet Agent Information, specify the full path to the GWIA startup file and whether you want the GWIA to run as root.

To find out what changes the Server Migration Utility makes to the GWIA startup file when it migrates it to Linux, see the following section in the GroupWise Administration Guide for your version of GroupWise:

WebAccess Agent

The WebAccess Agent startup file is webacnna.waa The default location of the startup file varies by platform:

NetWare:

Windows:

NOTE:The WebAccess Agent is not part of GroupWise 2012, but is part of earlier GroupWise versions.

GROUPWISE MIGRATION WORKSHEET

Under Item 11: WebAccess Agent Information, specify the full path to the WebAccess Agent startup file. The WebAccess Agent must run as root.

To find out what changes the Server Migration Utility makes to the WebAccess Agent startup file when it migrates it to Linux, see the following section in the GroupWise Administration Guide for your version of GroupWise:

The Server Migration Utility migrates the WebAccess Agent but not the WebAccess Application that is installed to your Web server. If you want to use a Linux Web server with WebAccess, you can follow the instructions in Section 14.2, Manually Migrating the WebAccess and WebPublisher Applications to Linux after you have migrated the WebAccess Agent.

4.4.3 Remote Document Storage Areas for a Post Office

The post office that you want to migrate might own libraries with remote document storage areas. A remote document storage area is a storage area that resides outside of the post office directory structure, rather than within it. A remote document storage area might be on the same server with the post office, or it might be on a different server. The Server Migration Utility currently cannot migrate remote document storage areas for you.

The utility can list all the remote document storage areas associated with a post office and can provide their current locations. You need to decide where you want the document storage areas to reside after the post office has been migrated. You must move them to the same Linux server as the post office, because document storage areas are not supported on remote Linux servers.

If it is necessary to keep your documents in a location other than Linux, you should create a new post office just for document storage areas and transfer your current document storage areas to that new post office. This provides a faster, more reliable way of accessing your documents through GroupWise.

GROUPWISE MIGRATION WORKSHEET

Under Item 8: Post Office Information, specify the location where you want to move each remote document storage area for libraries in the post office.

You must move the document storage areas before the second post office data migration starts. Instructions for manually copying the document data to the planned destinations are provided at the appropriate point in the migration process. Do not move the document storage areas until you are instructed to do so.