4.4 Setting Up the Internet Agent

Complete the following tasks to set up the Internet Agent (GWIA):

4.4.1 Installing the GWIA

As you install the GWIA, you are prompted to supply configuration information. You should have already reviewed Section 4.3, Planning the GroupWise Internet Agent and filled out the worksheet. The following sections step you through the GroupWise Installation program for installing the GWIA.

IMPORTANT:If you plan install the GWIA in a clustered server environment, see the GroupWise 2012 Interoperability Guide before you install the GWIA.

Linux: Installing the GWIA

If you are new to Linux, you might want to review Linux Commands, Directories, and Files for GroupWise Administration in the GroupWise 2012 Administration Guide before you install the GWIA on Linux.

Preparing the Linux Server for the GWIA
  1. Make sure that the Linux server where you are installing the GWIA meets the system requirements listed in Section 4.2, Internet Agent System Requirements.

  2. Make sure that the Linux server has a static IP address.

  3. (Conditional) If Sendmail, Postfix, or any other SMTP daemon is enabled on your Linux server:

    Disable it. For example, use the following commands to stop and disable Postfix:

    /etc/init.d/postfix stop
    chkconfig postfix off
    

    or

    Configure the GWIA to bind exclusively to the server IP address, as described in Binding the GWIA to a Specific IP Address in Internet Agent in the GroupWise 2012 Administration Guide, so that the GWIA does not conflict with the default Postfix IP address of 127.0.0.1 (the loopback address).

  4. (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.

  5. Make sure that the firewall on the Linux server has the ports open that are used by the GWIA.

    For assistance, see GroupWise Port Numbers in the GroupWise 2012 Administration Guide.

  6. Make sure that LDAP is running on your eDirectory server and that it is configured to accept login from the GroupWise Installation program.

    The GroupWise Installation program requires eDirectory access in order to create the GWIA object in eDirectory. The Installation program uses LDAP to gain the required access.

  7. Continue with Installing the Linux GWIA Software.

Installing the Linux GWIA Software
  1. In a terminal window on the server where you want to install the GWIA, log in as root, then provide the root password.

  2. Change to the root directory of the downloaded GroupWise 2012 software image.

    or

    If you have already copied the GWIA software to a software distribution directory, change to /opt/novell/groupwise/software.

  3. Run ./install.

    The X Window System is required for running the GUI GroupWise Installation program. If you are not using the X Window System, you can install GroupWise components individually, as described in Installing GroupWise Components Using the Text-Based Installation Program.

  4. Select the language in which you want to run the GroupWise Installation program, then click OK.

    The main GroupWise System Installation page appears.

    GroupWise Installation program
  5. Click Install Products > GroupWise Internet Agent > Install Internet Agent to install the GWIA software.

  6. When the installation is complete, click OK.

  7. Click Configure Internet Agent.

    GWIA Configuration program
  8. Follow the prompts to configure the GWIA using the following information from the GroupWise Internet Agent Installation Worksheet:

    Installation Complete page

    On the Configuration Complete page, Launch Internet Agent on System Startup is selected by default.

    IMPORTANT:If you want to configure the GWIA for high availability, as described in Enabling the GroupWise High Availability Service for the Linux GroupWise Agents, it must be configured to start automatically on system startup.

  9. (Conditional) If you do not want the GWIA to start automatically when the server restarts, deselect Launch Internet Agent on System Startup.

  10. Click Exit to exit the GWIA Installation program.

    The GWIA software is installed to /opt/novell/groupwise/agents.

  11. Skip to Setting Up Internet Addressing.

Windows: Installing the GWIA Software

Preparing the Windows Server for the GWIA
  1. Make sure that the Windows server where you are installing the GWIA meets the system requirements listed in Section 4.2, Internet Agent System Requirements.

  2. Make sure that the Windows server has a static IP address.

  3. Make sure that the firewall on the Windows server has the ports open that are used by the GWIA.

    For assistance, see GroupWise Port Numbers in the GroupWise 2012 Administration Guide.

  4. Make sure that no other GroupWise agents are currently running on the server where you want to install the GWIA.

  5. Make sure that you have access to the directory where you want to install the GWIA and to the domain directory.

  6. Log in to eDirectory with Admin-equivalent rights to the eDirectory tree where you want the Installation program to create the GWIA object.

  7. Continue with Installing the Windows GWIA Software

Installing the Windows GWIA Software
  1. Change to the root directory of the downloaded GroupWise 2012 software image.

    or

    If you have already copied the GWIA software to a software distribution directory, change to that location

  2. Run setup.exe.

  3. (Conditional) If prompted, select the interface language for the Installation program, then click OK.

    On Windows, the GroupWise 2012 software image can be downloaded in a multilanguage version or an English-only version. When you install from the multilanguage version, all languages are always installed, regardless of the specific language that you select for running the Installation program.

    The main GroupWise System Installation page appears.

    GroupWise Installation program main page
  4. Click Install GroupWise System, then click Yes to accept the License Agreement and display the Installation Type page.

    Installation Type page

    When you install the GWIA, you are performing a Standard installation. Other installation options on this page are described in Setting Up Predefined Installations.

  5. Click Next to accept the default of Standard.

    GroupWise Components page
  6. Select Install Individual Components, deselect GroupWise Administration and GroupWise Agents, then select GroupWise Internet Agent.

  7. Follow the prompts to configure the GWIA using the following information from the GroupWise Internet Agent Installation Worksheet:

    Summary and Modification page
  8. On the Summary and Modification page:

    1. Review the installation information you have provided.

    2. (Conditional) If you need to change information, select the information to change, then click Edit Setting, specify the desired information, then click OK.

  9. Click Install to start the GWIA installation.

    Status messages keep you informed about the installation progress.

    The GWIA software is installed into the following directory:

    c:\Program Files\Novell\GroupWise\GWIA
    
  10. When the installation is complete, click Finish, then continue with Setting Up Internet Addressing.

4.4.2 Setting Up Internet Addressing

When you install the GWIA, it by default supports native Internet-style addressing consisting of a user name and Internet domain name (for example, userID@Internet_domain_name). The GroupWise Installation program provided the opportunity for you to specify your Internet domain name on the Mail Domain Name page. It also offered you the alternative of entering the information from ConsoleOne. This can be convenient if you want to install the GWIA before you have received your Internet domain name from your Internet Service Provider (ISP). If you selected Enter from ConsoleOne on the Mail Domain Name page during installation, follow the instructions below to provide the Internet domain name in ConsoleOne.

  1. In ConsoleOne, select the GroupWise System object, then click Tools > GroupWise System Operations > Internet Addressing.

    Internet Addressing dialog box
  2. Click Create.

    Internet Domain Name dialog box
  3. Specify the Internet domain name that you have received from your ISP (for example, yourcompanyname.com).

  4. Add a description if needed, then click OK to add the Internet domain name to the list.

  5. Click OK again to save the Internet domain name as part of your GroupWise system.

    For more information about Internet addressing, see Configuring Internet Addressing in Internet Agent in the GroupWise 2012 Administration Guide.

    Your GroupWise system is now configured to receive email addressed to that Internet domain name.

  6. Continue with Assigning a Postmaster.

4.4.3 Assigning a Postmaster

The Internet requires each site to assign at least one user to be a Postmaster. The Postmaster is assigned to be the recipient of messages addressed to postmaster@host.

  1. In ConsoleOne, right-click the GWIA object, then click Properties.

  2. Click GroupWise > Gateway Administrators.

    Gateway Administrators page
  3. On the Gateway Administrators page, click Add, select a GroupWise user to be the Postmaster, then click OK.

  4. Select the user from the list, then click Postmaster.

  5. Click OK to save the information.

  6. Continue with Starting the GWIA.

The GWIA can also be configured to send problem messages to the Postmaster. For instructions, see Determining What to Do with Undeliverable Messages in Internet Agent in the GroupWise 2012 Administration Guide.

4.4.4 Starting the GWIA

After you install the GWIA, set up Internet addressing, and configured a Postmaster, you can start the GWIA.

Linux: Starting the GWIA

To start the Linux GWIA with a user interface:

  1. Make sure that the MTA for the domain is running.

  2. In a terminal window, become root by entering su - and the root password.

  3. Change to the /opt/novell/groupwise/agents/bin directory.

  4. Enter the following command to start the GWIA:

    ./gwia --show @gwia.cfg &
    

    The --show switch starts the GWIA with a server console interface similar to that provided for the Window GWIA. This user interface requires that the X Window System and Open Motif be running on the Linux server.

    The @ startup switch points to the GWIA startup file (gwia.cfg) and is required to start the GWIA.

    The ampersand (&) causes the GWIA to run in the background, so that the terminal window you started it in is again available for use.

    To remind yourself of this command when you are at your Linux server, view the gwia man page.

    Internet Agent console

    The status messages displayed on the GWIA server console are also written to the GWIA log file (mmddlog.nnn) in the /var/log/novell/groupwise/domain.gwia directory. The log file name includes the month and day when it was created, along with an incrementing extension to accommodate multiple log files on the same day.

    After the GWIA starts successfully, refer to the following sections in Section 8.0, Installing GroupWise Agents for additional information about managing the GWIA on Linux:

  5. Skip to Section 4.4.5, Testing the GWIA

Windows: Starting the GWIA

  1. (Conditional) If the domain directory is not on the GWIA server, map a drive to the domain directory as a user that has rights to access the domain directory.

  2. If the GWIA is installed as a Windows application, click Start > All Programs > GroupWise Internet Agent > GroupWise Internet Agent.

    Internet Agent console

    or

    If the GWIA is installed as a Windows service, click the Start menu > Control Panel > Administrative Tools > Services. Right-click the GWIA service, then click Start.

    If the GWIA does not start successfully, see Starting the Windows GroupWise Agents.

  3. (Conditional) If you enabled the GWIA Web console, use the following URL to log into the Web console:

    http://internet_agent_network_address:http_port
    

    For example:

    http://172.16.5.18:9850
    

    For more information, see Using the GWIA Web Console in Internet Agent in the GroupWise 2012 Administration Guide.

  4. Continue with Testing the GWIA.

4.4.5 Testing the GWIA

After you start the GWIA, you should send a message to ensure that the system is working properly.

  1. Open a new mail message in your GroupWise client.

  2. In the To field, enter the Internet address of a colleague or friend that is not in your GroupWise system.

  3. Send the message, then contact the recipient to verify that he or she received it.

  4. Have the recipient reply to your message to verify that you receive the reply in your GroupWise mailbox.

  5. Continue with What’s Next.