In the first part of this series, I described how Novell IS&T was benefiting from running GroupWise on Open Enterprise Server on Linux and described how to use the GroupWise Server Migration Utility to migrate a GroupWise post office from Windows or NetWare to Linux.
The GroupWise Server Migration Utility was not yet in beta at the time of writing, and now additional functionality has been committed and is in the shipping product. In this article, I describe how to use the utility to migrate GroupWise domains, Internet Agents and WebAccess agents to Linux.
The migration utility allows an administrator from a Windows workstation (a Linux version is planned for the future) to connect to the source server (Windows or NetWare) and to the destination Linux server and easily migrate the GroupWise data, install agents and perform any necessary case conversions on the GroupWise data files.
If you haven't read the first article, which was published online at novell.com/connectionmagazine/2006/07/tech_talk_1.html, you should read it before you read this article. It explains in detail the benefits we as an IT department are experiencing by running GroupWise on Linux, some of the challenges we faced in moving to Linux and how we addressed them, and a look at running the migration utility to migrate post offices to Linux. All of that information applies to migrating domains, Internet agents and WebAccess agents; however, I will not cover it in detail here. This article gives additional detail about how to add and configure agents for migration.
> Migrating GroupWise Data
After meeting the prerequisites to run the migration utility and supplying information about the source and destination servers, the migration utility requires you to define which GroupWise components you want to migrate. (See Figure 1.)
The Auto-Detect feature was designed for detecting default installations of GroupWise agents on NetWare servers. If your servers have different file locations than the default location of SYS:\SYSTEM, then this feature won't help you much and you will have to add components manually.
When you click on Add Domain, or Add Post Office, enter these three paths in the dialog that appears (See Figure 2.):
- the source database path
- the existing startup file path
- the destination path
Note: The Add Agent button does not appear until you specify a domain to migrate.
Select the source database path by browsing to the location of the GroupWise database files, either wpdomain.db for a domain or wphost.db for a post office.
By specifying the existing startup file path, any configuration options in the startup file will be duplicated where applicable in the new startup file on the destination Linux server. If a startup file is not specified, a new one will be created. If the migration utility doesn't interpret the startup file properly, simply omit the path to the startup file and proceed.
A default destination path is automatically populated once you select the source database path. You may edit this path to be what you desire. By default the path is defined as /var/opt/novell/groupwise/mail/[directory]. The utility automatically places the directory name of the source database directory as the destination directory.
Note: The migration utility will allow you to migrate one domain and its agents or one post office and its agent at a time. (See Figure 3.)
> Adding Agents
The Add Agent feature allows you to add any or all Internet Agent(s) or WebAccess Agent(s) associated with a particular domain to be migrated along with the domain and its message transfer agent. (See Figure 4.)
Note: The migration utility cannot migrate a WebAccess application. You must reinstall the WebAccess application on the destination server using the GroupWise Linux CD Setup program. I'll show you how later in this article.
The Add Agent feature installs the necessary agent software on the destination server and creates a new startup file containing the configuration information from the startup file on the source server. Because the startup files for these agents specify which gateway definition is serviced by the agents, you must specify the location of the source startup file to migrate these types of agents.
> Agent Startup Files
By default, the name of the Internet Agent's startup file is gwia.cfg and it is normally located in the agent startup directory where the gwia executable is installed. Previously, it was placed in the gateway directory.
The WebAccess Agent startup file is normally named < gateway name >.waa and is also located normally in the agent startup directory where the gwinter executable file is.
Once you have successfully added the agents, they will display in the Component to Migrate dialog.
> Agent SSL and Key Files
After specifying agent information and proceeding with the migration, the utility will prompt you for information about SSL certificates in use by the agents. GroupWise agents can use SSL keys to encrypt data transmissions. It is common to provide an SSL key for the Internet Agent to secure SMTP e-mail connections on the Internet.
The migration utility allows you to use existing SSL files or to point to new files. You might want to use an existing SSL file if it is using a DNS hostname that will be used on the new server. Otherwise, if the DNS hostname on the new server is different, you should create a new certificate. See the GroupWise documentation for creating SSL certificates at novell.com/documentation/gw7/index.html?page=/documentation/gw7/gw7_admin/data/ak9e3ju.html.
To migrate the SSL certificate and key file, simply browse to the files and select them. (See Figure 5.)
> Internet Agent Port Conflict
When migrating the GroupWise Internet Agent to Linux, it is necessary to make sure another SMTP agent is not running on the Linux server. By default on SUSE Linux and Open Enterprise Server Linux, the postfix smtp agent runs to allow mail delivery of server notifications. Postfix is configured to listen only on the localhost IP address (127.0.0.1).
You have two options. (See Figure 6.) You can choose to bind the Internet Agent to listen only on the server's IP address or you can disable the postfix agent and allow the Internet Agent to listen on all addresses including the localhost address. If you need postfix to listen on multiple addresses, you can bind multiple IP addresses to the server and configure postfix to listen on IP addresses that are different than the IP address the Internet Agent uses. This type of configuration is beyond the scope of this article; however, information on configuring postfix is available at postfix.org. To disable posftix, execute the command:
chkconfig postfix off.
> Migrating Data
At this point, the migration utility is now ready to migrate data. If you want to proceed, you can down the selected agents for the domain and proceed with the data migration. Otherwise, you can leave the agents running and proceed with a trial migration of the data.
> Things to Consider
The migration utility will simply copy all of the files located under the domain directory structure that you defined earlier. If you have large quantities of unessential files located under this directory, you might want to delete or remove those files before proceeding. Some good candidates are logfiles and also message logfiles. For instance, on our servers at Novell, we typically keep at list 1GB of logfiles per agent. The Linux agents store the logfiles in a different location than on other platforms; however, the migration utility does not support moving them to the proper location. Therefore, they are not accessible to the agents. If you move them to another directory on the server that is not located under the domain directory structure, the migration utility will not copy them, thus shortening the amount of time required to migrate data.
Once you are ready to proceed, you have the chance to review all of the migration information as presented in the Migration Summary dialog. Clicking on Migrate will cause the migration utility to copy the necessary software packages to the Linux server and install them. Then it will connect to the source server and copy the GroupWise data. It will then install and configure the GroupWise agent and properly configure the GroupWise agents to run on Linux.
> Post Migration Tasks
After the data migration portion is complete, don't exit the migration utility as it has not completed its work. The agents will not be configured properly on the Linux server unless you allow the migration utility to finish. You need to use ConsoleOne to connect to the domain database on the new server and change the path to the domain and also change the IP addresses for the agents migrated. Any other paths defined, such as logfiles or certificate files need to be removed or modified as well. The Help files for the migration utility give detailed information on the items you should consider. If you are performing a trial migration, use the agent startup file to make temporary changes to agent settings and don't use ConsoleOne. After modifying the IP addresses for the agents, let the migration utility start the GroupWise agents to complete the configuration of the agents. If you don't, the scripts installed on the Linux server to manage the GroupWise agents won't work properly. In addition, you need to launch the Message Transfer Agent to replicate the network IP address changes to the rest of the GroupWise system. (See Figure 7.)
If you migrated a WebAccess agent, and want to migrate a WebAccess application, install the WebAccess application using the GroupWise installation CD and then configure it manually. See Installing and Managing the WebAccess Application on a Linux Server for information on how to do this. To manage the GroupWise agents on Linux, you can use the /etc/init.d/grpwise script. See Managing the GroupWise Agents on Linux for information on how to use this script.
The GroupWise Server Migration Utility greatly simplifies the process of migrating GroupWise post offices, domains and their respective agents from NetWare or Windows to Linux. It is a powerful tool that helps GroupWise administrators leverage the reliability and power of Linux to make GroupWise even more reliable and scalable than ever.
The utility was released in October 2006. To download check novell.com/downloads.