Novell is now a part of Micro Focus

AppNote: Setting up GroupWise Internet Agent for Dynamic Domains

Novell Cool Solutions: AppNote
By David Stagg

Digg This - Slashdot This

Posted: 28 Oct 2004

David Stagg
Primary Support Engineer
Novell Premium Support Services

This paper describes how to setup and use Novell GroupWise Internet Agent (GWIA) for a Small or Home Office that is connected to the Internet using Dynamic IP addressing provided by your local Broadband (Cable, DSL, etc.) Internet Service Provider/Vendor (ISP/ISV). The material documented here is available in various online documents. It is provided here for ease of use in configuring SMTP SSL and Outbound Authentication using a 3rd party dynamic DNS service.


Topic: Novell GroupWise SMTP Configuration for Dynamic DNS locations
Products: Novell GroupWise 6.5, Novell NetWare, Novell Small Business Suite, Novell Certificate Server, Novell DNS/DHCP Services
Audience: Small Business and Home Office Administrators and Consultants
Prerequisite Skills: Familiarity with Novell DNS, NetWare and GroupWise administration
Tools: ConsoleOne with Novell Certificate Server and Novell GroupWise 6.5 snapins installed


Target Audience: Small Businesses and Home Offices that wish to leverage broadband access (Cable, DSL, etc) from their local ISP/ISV without requiring Static IP services and the related costs. Email use is limited to 150 or less per day. This configuration is not intended for systems connecting through dial-up links.

The Problem: ISP/ISV's assign IP addresses dynamically and charge high monthly rates for static IP Addresses. Outbound email from GroupWise is refused by some sites that subscribe to Black Lists that include the Dynamic IP ranges your ISP/ISV assigns to your connection.

Assumptions: GroupWise 6.5 is already installed in your environment as your internal email system of choice. This may be part of NetWare Small Business Suite or on some other supported Operating System. This paper does not deal with the installation or setup of your GroupWise environment.

Network Configuration

For this paper a working environment was used that consisted of a NetWare 6.5 server connected to an Internet Router that in turn was connected to the Cable Modem provided by the local ISP/ISV. The Internet Router acquires the Dynamic IP address from the ISP/ISV for this location. The Internet Router is configured for Network Address Translation (NAT) support for all internal devices. The internal interface of the Internet Router is configured with a static IP addresses one Subnet 1. The NetWare server is configured with two Network Interface Cards, (NIC) one Public and one Private. The "Public" NIC is configured with a static IP Address on Subnet 1 ( and is connected to the Internet Router. The second NIC is configured with a static IP on Subnet 2 ( and is connected to an internal switch. Local workstations are connected to Subnet 2 through the switch. Workstations acquire their IP addresses from a DHCP service configured on the NetWare server.

Diagram of MyBiz Internal Network

Note: The Internet Router will require additional configuration to properly forward Port 25 (SMTP) to your GWIA service. The steps required for this will depend on the actual Internet Router device you have and it's specific configuration process. Read the documentation for your device to properly configure this.

External Dynamic DNS and Mail Relay Setup

To handle the dynamic nature of the IP address provided by your ISP/ISV and still enable access to mail and other possible services, the services from were used. This included setting up an Account, a Dynamic DNS Domain and MailHop Outbound services.

Note: At the time of this writing other Dynamic services were not explored or validated. With the exception of the MailHop Outbound services, currently offers these services for free. The MailHop Outbound service is available for an annual fee. The author of this paper neither recommends, warranties, supports or makes any specific claims for or against paper simply documents the use of the services available from this organization at the time of writing. Visit to identify conditions for using the services that are available and may be of use to you in supporting your environment.

  1. Create an account with Dynamic Domain provider. To create a new account with at you need to provide a "username", "E-mail Address" and a "Password".

  2. Select and Register your Dynamic Domain and assign your current dynamic IP Address as assigned by your ISP/ISV. By selecting the "Enable Wildcard" option all hosts for your domain will be directed to your server.

    Many Dynamic Domains can be selected from The example here uses for the MyBiz network.

  3. Sign up for MailHop Outbound service. This is a fee service so additional details will have to be provided to activate the service.

Internal DNS Configuration

Internally DNS services are provided by a DNS service configured on the NetWare server. The internal DNS server is Authoritative for the Domain so that internal DNS requests are correctly resolved to internal services. This is also required to be setup properly so that any outbound emails that generate error messages are returned to the sender properly. If not done correctly these messages can end up looping at the GWIA.

The sample internal DNS setup to the right shows the records created using the Novell DNS/DHCP Management console. This domain matches the dynamic domain selected when setting up the Dynamic Domain above. As this is a single server all of the A records are pointing to the same IP Address. CNAME records could be used for the various services but the entry that the MX (Mail Exchange) record points to must be an A record and not a CNAME record.

Create a SSL Certificate for GWIA

Outbound Authentication is required to be able to use the DynDNS Mailhop services. Although SSL connections are not required, your user name and password are sent in clear text to the Mailhop service without SSL connections configured. The next steps walk through the process required to create a SSL Certificate that your GWIA can use for SSL connections. This is based on using the Novell Certificate Server which is included as part of a Novell NetWare installation.

  1. Create a Certificate CSR using GWCSRGEN.EXE found in the \admin\utility\gwcsrgen subdirectory in the GroupWise Software Distribution directory.
  2. In this example two files are created, "gwia.key" and "gwia.csr", using the information provided in the Required Information section. The "giwa.csr" file will be used to create a signed Certificate and the "gwia.key" will be used with the Certificate for SSL configuration of the GWIA.

    Fill in each field with the required information and then click Create to create the gwia.key and gwia.csr files.

    Additional information on the various fields is available in Help for the GWCSRGEN utility.

  3. Create the Signed Certificate using Novell Certificate Server by selecting the "Issue Certificate" option in the Tools menu of ConsoleOne.

    An object in the Tree (Tree Root or lower) has to be selected for the Tools > Issue Certificate... option to be available.

  4. Browse and select the CSR file that was created previously and click Next.

  5. Click Next

  6. Select SSL or TLS for the Certificate Type and click Next

  7. Select the "Validity period" that you prefer and click Next

  8. Verify the Certificate parameters and then click Finish.

  9. Change the "Save to" format to Base64 and enter the path and file name to save the Certificate. Once the option and pathname is correct click Save.

  10. Put the Certificate files in place for the GWIA to use.

    In this configuration the subdirectory SYS:SYSTEM\GWagent was used for the GroupWise Agent files. A new subdirectory SYS:SYSTEM\GWagent\MailCert was created to hold the new SSL Certificate files. It is important to note that the 0.subdirectories in the path to the Certificate files must be in the 8.3 format. Long subdirectory names will generate an error and SSL will not work.

    Copy the files GWIA.KEY and GWIA.B64 to SYS:\SYSTEM\GWagent\MailCert, or a directory of your choice where they will be available to the GWIA agent.

Configure GWIA for SMTP SSL connections

The following steps are also documented in online documentation for GroupWise. Search for Securing Internet Agent connections Via SSL in the GroupWise documentation.

  1. Define the Certificate File for the Internet Agent. The SMTP process requires a SSL Certificat file for the SSL converstations
  1. In ConsoleOne, right-click the Internet Agent Object, then click Properties.
  1. Click GroupWise > SSL Settings to display the SSL Setting page.
  1. Type in the paths to the gwia.b64 and gwia.key files using the full pathnames to the location on the server. If you use the browse button you will have to edit the path to use the VOL:\path notation for a NetWare server. The wrong path syntax will prevent SSL from working correctly.
  1. Click the "Set Password" button field to enter the password for the gwia.key file. This is the password that was used earlier when setting up the files using the GWCSRGEN utility.

  1. Once the password is entered click Set Password

  2. Then click Apply to save your SSL Settings.

  3. Enable SSL for SMTP is required so that the SMTP service will attempt to communicate using SSL first. If a conversation via SSL is not possible then a normal connection will be established.

  4. Switch to the GroupWise Network Address page

  5. Set the SMTP SSL option to Enabled and then click OK to save the settings

Configure GWIA for SMTP Outbound Authentication

  1. Setup GWIA with your DNS domain information that was selected earlier when setting up your Dynamic Domain.

  2. In ConsoleOne right-click the Internet Agent object and select Properties

  3. Then select the SMTP/MIME > Settings tab

  1. If it is not already configured, enter the Hostname information. In this example we used Use the correct Hostname that matches your domain and DNS configuration.

  2. Configure the "Relay Host for Outbound Messages" with "" to forward outbound email through the MailHop Outbound service that you setup earlier in this process. See the previous screen shot for details.

  3. Click OK to save your SMTP/MIME settings.

  4. Setup SMTP Host Authentication by editing the "gwauth.cfg" file located in the Internet Agent's gateway directory. The directory is located under the Domain's "wpgate" directory. In this example that was "wpgate\gwia". Three fields are required in this file: domain_name, authuser and authpassword. These are the values required for the Internet Agent to authenticate to the MailHop Outbound service. The authuser and authpassord values for MailHop Outbound are the username and password used when you created the Account at Check with your chosen dynamic DNS service for the required Authentication values.

  5. Open the wpgate\gwia\gwauth.cfg file in notepad and add a line to the end providing the required information. In this example the contents of gwauth.cfg look like:

    Note: The password value is clear text in this file so ensure that you have appropriate security on your domain directories.

  6. Once all the Internet Agent settings have been configured restart the Internet Agent by using the F6 option on the Internet Agent Console screen.

ISP/ISV's Blocking Port 25 on Inbound Email

Setting up and testing for this paper did not encounter the situation where ISP/ISV's are now starting to block port 25 for inbound email to your system. If your ISP/ISV is blocking Port 25 you will have to setup the Internet Agent on a different Port and have a Smart Host relay the mail to you on that port. has a MailHop Relay service that may work for your environment. This information is provided simply for your reference as the author has not setup or tested that service.


Setting up your Novell GroupWise Internet Agent in a Dynamic DNS environment allows you to control your own email environment and gain the benefits of your own private GroupWise system for mail handling. This paper has demonstrated how to effectively configure SMTP with SSL and Authentication for Outbound mail services for minimal costs.

Novell Cool Solutions (corporate web communities) are produced by WebWise Solutions.

© Copyright Micro Focus or one of its affiliates