Manually migrating the Internet Agent (GWIA) to Linux includes migrating its domain to Linux, then installing the GWIA software on Linux, updating GWIA configuration information in ConsoleOne, and copying queued Internet messages from the NetWare or Windows server to the Linux server.
Migrate the GWIA’s domain to Linux, as described in Section 12.0, Manually Migrating a Domain and Its MTA to Linux.
If you are using SSL, migrating the domain and its MTA includes creating a new certificate file (file_name.crt) and a new key file (file_name.key) for the Linux server and placing them in the /opt/novell/groupwise/agents/bin directory, as described in Step 11 in Section 12.2, Performing the Domain Migration.
On the Linux server, become root in a terminal window.
Make the Linux server visible from Windows.
This is necessary in order to perform administration tasks from Windows ConsoleOne during the GWIA configuration process. For Linux server configurations to accomplish this, see Section 10.1.1, Making a Linux Server Visible from Windows.
Install and configure the Linux GWIA, as described in the following section of the GroupWise Installation Guide for your version of GroupWise:
GroupWise 2012: Installing the GroupWise Internet Agent
GroupWise 8: Installing the GroupWise Internet Agent
GroupWise 7: Installing the GroupWise Internet Agent
In ConsoleOne, update the GWIA property pages for the new location of the GWIA:
On the Identification property page of the tab, set to , then click .
On the Network Address property page of the tab, specify the IP address or DNS hostname of the Linux server, then click .
On the Log Settings property page of the tab, if you have specified a directory path in the field, delete the NetWare or Windows path, then click .
On Linux, GWIA log files are stored in the /var/log/novell/groupwise/domain.gwia.
On the SSL Settings property page of the , if you have specified full paths in the and fields, delete the NetWare or Windows path, then click .
On Linux, the GWIA looks in the /opt/novell/groupwise/agents/bin directory for certificate and key files by default.
On the tab, update the and fields with corresponding Linux locations.
On the NetWare or Windows server, stop the GWIA.
Internet messages cannot be received into your GroupWise system while the GWIA is stopped.
From Windows, copy the queued Internet messages in the GWIA SMTP queues directory on the NetWare or Windows server to the Linux server.
NOTE:Because of Step 3 above, the Linux server is already visible from Windows. If you prefer to perform the copy operation from Linux, you must first make the NetWare or Windows server visible from Linux, as described in Section 10.2.1, Making a NetWare or Windows Server Visible from Linux.
The default GWIA SMTP queues directory is domain/wpgate/gwia. In this directory, four queue subdirectories are used for SMTP processing: send, receive, result, and defer. When you migrated the domain to Linux, DBCopy copied these queue directories and their contents to the Linux server along with the rest of the domain directory structure, but additional Internet messages might have arrived since that time. Therefore, you need to copy these queue directories again now that the GWIA has been stopped.
If you used the field on the Server Directories property page of the GWIA object in ConsoleOne or the /dhome switch in the gwia.cfg file to place the queue directories outside the domain directory structure, then DBCopy did not copy the queue directories. Copy the queue directories from the NetWare or Windows server to their default location in the domain directory structure or to another location of your choice on the Linux server. If you do not copy them to their default location, update the setting with the full path to the SMTP queues directory.
(Conditional) If Sendmail, Postfix, or any other SMTP daemon is enabled on your Linux server, disable it before starting the GWIA.
For example, use the following commands to stop and disable Postfix:
/etc/init.d/postfix stop chkconfig postfix off
As an alternative, you can configure the GWIA to bind exclusively to the server IP address, so that the GWIA IP address does not conflict with the default Postfix IP address of 127.0.0.1 (the loopback address).
For instructions, see the following section in the GroupWise Administration Guide for your version of GroupWise:
GroupWise 2012: Binding the GWIA to a Specific IP Address
in Internet Agent
GroupWise 8: Binding the Internet Agent to a Specific IP Address
in Internet Agent
GroupWise 7: Binding the Internet Agent to a Specific IP Address
in Internet Agent
(Conditional) If you want to use the GWIA for POP3 and IMAP4 mail, make sure no POP3 or IMAP4 daemons are running on your Linux server.
Make sure that the MTA for the domain is running.
Start the Linux GWIA with or without a user interface, as described in the following section of the GroupWise Installation Guide for your version of GroupWise:
GroupWise 2012: Linux: Starting the GWIA
in Installing the GroupWise Internet Agent
GroupWise 8: Linux: Starting the Internet Agent
in Installing the GroupWise Internet Agent
GroupWise 7: Linux: Starting the Internet Agent
in Installing the GroupWise Internet Agent
If the GWIA server console does not appear, or the GWIA Web console is not available in your Web browser, review the preceding steps to verify that all steps have been followed. For additional assistance, see the following section of GroupWise Troubleshooting 2: Solutions to Common Problems for your version of GroupWise:
GroupWise 2012: Internet Agent Problems
in Strategies for Agent Problems
GroupWise 8: Internet Agent Problems
in Strategies for Agent Problems
GroupWise 7: Internet Agent Problems
in Strategies for Agent Problems
When the Linux GWIA is running smoothly for the new domain location, and other GroupWise agents belonging to the domain have been migrated to Linux as needed, delete the old domain directory structure from the NetWare or Windows server.
(Conditional) If the SMTP queue directory was located outside the domain directory structure, delete this directory and its contents from the NetWare or Windows server.
(Optional) Uninstall the old GWIA software to reclaim disk space on the NetWare or Windows server.