To set the GWIA basic SMTP/MIME settings:

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

2. If the SMTP/MIME Settings page is not the default page, click SMTP/MIME > Settings.

   

3. Fill in the fields:

   Enable SMTP Service: SMTP service is on by default. This setting allows SMTP Internet messaging. This setting corresponds with the GWIA’s ‑‑smtp switch.

   Number of SMTP Send Threads: The SMTP send threads setting lets you specify the number of threads that process SMTP send requests. Each thread is equivalent to one connection. The default is 8 threads. This setting corresponds with the GWIA’s ‑‑sd switch.

   Number of SMTP Receive Threads: The SMTP receive threads setting lets you specify the number of threads that process SMTP receive requests. Each thread is equivalent to one connection. The default is 16 threads. This setting corresponds with the GWIA’s ‑‑rd switch.

   Kill Threads on Exit or Restart: Select this option to cause the GWIA to stop immediately, without allowing its send/receive threads to perform their normal shutdown procedures. The normal termination of all send/receive threads can take several minutes, especially if a large message is being processed. By terminating immediately, a needed restart can occur immediately as well. This setting corresponds with the GWIA’s ‑‑killthreads switch.

   Enable iCal Service: Select this option if you want the GWIA to convert outbound GroupWise Calendar items into MIME text/calendar iCal objects and to convert incoming MIME text/calendar messages into GroupWise Calendar items. Enabling the iCal service provides the functionality described in Accepting or Declining Internet Items in Calendar in the GroupWise 2012 Windows Client User Guide. This setting corresponds with the GWIA's ‑‑imip switch.

   Hostname/DNS "A Record" Name: The Hostname/DNS “A Record” name setting lets you identify the hostname of the server where the GWIA resides, or in other words the A Record in your DNS table that associates a hostname with the server’s IP address (for example, gwia.novell.com). This setting corresponds with the GWIA’s --hn switch.

   If you leave this field blank, the GWIA uses the hostname obtained by querying the hosts file from the server.

   Relay Host for Outbound Messages: The relay host setting can be used if you want to use one or more relay hosts to route all outbound Internet email. Specify the IP address or DNS hostname of the relay hosts. Use a space between relay hosts in a list. Relay hosts can be part of your network or can reside at the Internet service provider’s site. This setting corresponds with the GWIA’s --mh switch.

   If you want to use a relay host, but you want some outbound messages sent directly to the destination host rather than to the relay host, you can use a route configuration file (route.cfg). Whenever a message is addressed to a user at a host that is included in the route.cfg file, the GWIA sends the message directly to the host rather than to the relay host. For information about creating a route.cfg file, see Section 53.1.9, Using a Route Configuration File.

   Scan Cycle for Send Directory: The Scan cycle setting specifies how often the GWIA polls for outgoing messages. The default is 10 seconds. This setting corresponds with the GWIA’s --p switch.

   Use 7 Bit Encoding for All Outbound Messages: By default, the GWIA uses 8-bit MIME encoding for any outbound messages that are HTML-formatted or that contain 8-bit characters. If, after connecting with the receiving SMTP host, the GWIA discovers that the receiving SMTP host cannot handle 8-bit MIME encoded messages, the GWIA converts the messages to 7-bit encoding.

   With this option selected, the GWIA automatically uses 7-bit encoding and does not attempt to use 8-bit MIME encoding. You should use this option if you are using a relay host that does not support 8-bit MIME encoding. This setting corresponds with the GWIA’s --force7bitout switch.

   Maximum Number of Hours to Retry a Deferred Message: Specify the number of hours after which the GWIA stops trying to send deferred messages. The default is 96 hours (four days). A deferred message is any message that can’t be sent because of a temporary problem (host down, MX record not found, and so on). This setting corresponds with the GWIA’s --maxdeferhours switch.

   Intervals to Retry a Deferred Message: Specify in a comma-delimited list the number of minutes after which the GWIA retries sending deferred messages. The default is 20, 20, 20, 60. The GWIA interprets this list as follows: It retries 20 minutes after the initial send, 20 minutes after the first retry, 20 minutes after the second retry, and 60 minutes (1 hour) after the third retry. Thereafter, it retries every hour until the number of hours specified in the Maximum Number of Hours to Retry a Deferred Message field is reached. You can provide additional retry intervals as needed. It is the last retry interval that repeats until the maximum number of hours is reached. This setting corresponds with the GWIA’s ‑‑msgdeferinterval switch.

   Return Notification to Sender When a Message Is Delayed: Select this option to provide a notification message to users whose email messages cannot be immediately sent out across the Internet. This provides more noticeable notification to users than manually checking the Properties page of the sent item to see whether it has been sent. This setting corresponds with the GWIA’s ‑‑delayedmsgnotification switch.

   Do Not Publish GroupWise Information on an Initial SMTP Connection: This option suppresses the GroupWise version and copyright date information that the GWIA typically responds with when contacted by another SMTP host or a telnet session. It is enabled by default. This setting corresponds with the GWIA’s ‑‑nosmtpversion switch.

4. Click OK to save the changes.

To configure ESMTP settings:

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

2. Click SMTP/MIME > ESMTP Settings.

   

3. Fill in the fields:

   Enable Delivery Status Notification: Turn on this option to allow the GWIA to request status notifications for outgoing messages and to supply status notifications for incoming messages. This requires the external email system to also support Delivery Status Notification. Currently, notification consists of two delivery statuses: successful or unsuccessful.

   If you enable the Delivery Status Notification option, you need to select the number of days that you want the GWIA to retain information about the external sender so that status updates can be delivered to him or her. For example, the default hold age causes the sender information to be retained for 4 days. If the GWIA does not receive delivery status notification from the GroupWise recipient’s Post Office Agent (POA) within that time period, it deletes the sender information and the sender does not receive any delivery status notification.

   If you enable this option for the GWIA, it overrides what GroupWise Windows client users set under Tools > Options > Send > Mail > Send Notification to My Mailbox. By default, this option is deselected in the GroupWise Windows client, but if you select Enable Delivery Status Notification in ConsoleOne, users receive delivery status notifications in their mailboxes even when the option is deselected in the Windows client.

4. Click OK to save the changes.

To set the GWIA address handling options:

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

2. Click SMTP/MIME > Address Handling.

   

3. Fill in the fields:

   Ignore GroupWise Internet Addressing: GroupWise supports both Internet-style addressing (user@host) and GroupWise proprietary addressing (user_ID.post_office.domain). By default, the GWIA uses Internet-style addressing.

   If you do not want the GWIA to use standard Internet-style addressing (user@host), turn on the Ignore GroupWise Internet Addressing option. With this option turned on, messages use the mail domain name in the Foreign ID field (GWIA object > GroupWise > Identification) for the domain portion of a user’s Internet address. If you included multiple mail domain names in the Foreign ID field or the frgnames.cfg file, as described in Listing Foreign Domain Names, the first mail domain name listed is the one used in addresses.

   The GWIA supports user and post office aliases in either mode. This setting corresponds with the GWIA’s ‑‑dia switch.

   Expand Distribution Lists on Incoming Messages: Turn on this option to have incoming Internet messages addressed to a distribution list sent to all members of the distribution list. This setting corresponds with the GWIA’s ‑‑group switch. See also the ‑‑nickgroup switch to turn on distribution list expansion for distribution lists that have nicknames.

   Do Not Replace Underscores with Spaces: Select this option if you do not want the GWIA to convert user names in email addresses from the format Firstname_Lastname into the format Firstname Lastname by replacing the underscore with a space. By default, this conversion takes place automatically, even though Firstname_Lastname is not an address format that is included in the Allowed Address Formats list in the Internet Addressing dialog box, as described in Section 52.2.2, Enabling Internet Addressing. This setting corresponds with the GWIA's ‑‑dontreplaceunderscore switch.

   Non-GroupWise Domain for RFC-822 Replies: This setting can be used only if 1) you created a non-GroupWise domain to represent all or part of the Internet, as described in Section 6.8, Adding External Users to the GroupWise Address Book, and 2) you defined the non-GroupWise domain’s outgoing conversion format as RFC-822 when you linked the GWIA to the domain.

   Specify the name of the non-GroupWise domain associated with the RFC-822 conversion format. When a GroupWise user replies to a message that was originally received by the GWIA in RFC-822 format, the reply is sent to the specified non-GroupWise domain and converted to RFC-822 format so that it is in the same format as the original message.

   This setting corresponds with the GWIA’s ‑‑fd822 switch.

   Non-GroupWise Domain for MIME Replies: This setting can be used only if 1) you created a non-GroupWise domain that represents all or part of the Internet, as described in Section 6.8, Adding External Users to the GroupWise Address Book, and 2) you defined the non-GroupWise domain’s outgoing conversion format as MIME when you linked the GWIA to the domain.

   Specify the name of the non-GroupWise domain associated with the MIME conversion format. When a GroupWise user replies to a message that was originally received by the GWIA in MIME format, the reply is sent to the specified non-GroupWise domain and converted to MIME format so that it is in the same format as the original message.

   This setting corresponds with the GWIA’s ‑‑fdmime switch.

   Sender’s Address Format: This setting applies only if you have not enabled GroupWise Internet addressing (in other words, you selected the Ignore GroupWise Internet Addressing option). If GroupWise Internet addressing is enabled, the GWIA ignores this setting and uses the preferred address format established for outbound messages (Tools > GroupWise System Operations > Internet Addressing).

   The Sender’s Address Format setting lets you specify which GroupWise address components (domain.post_office.user_ID) are included as the user portion of the address on outbound messages. You can choose from the following options:

   • Domain, Post Office, User, and Hostname: Uses the domain.post_office.user_ID@host syntax.

   • Post Office, User, and Hostname: Uses the post_office.user_ID@host syntax.

   • User and Hostname: Uses the user_ID@host syntax.

   • Auto (default): Uses the GroupWise addressing components required to make the address unique within the user’s GroupWise system. If a user ID is unique in a GroupWise system, the outbound address uses only the user ID. If the post office or domain.post office components are required to make the address unique, these components are also included in the outbound address.

   The Sender’s Address Format setting corresponds with the GWIA’s ‑‑aql switch.

   Place Domain and Post Office Qualifiers: If the sender’s address format must include the domain and/or post office portions to be unique, you can use this option to determine where the domain and post office portions are located within the address.

   • On Left of Address (default): Leaves the domain and post office portions on the left side of the @ sign (for example, domain.post_office.user_ID@host.

   • On Right of Address: Moves the domain and post office portions to the right side of the @ sign, making the domain and post office part of the host portion of the address (for example, user_ID@post_office.domain.host. If you choose this option, you must ensure that your DNS server can resolve each post_office.domain.host portion of the address. This setting corresponds with the GWIA’s ‑‑aqor switch.

     Retain Distribution Lists on Outgoing Messages: Select this option if you do not want the GWIA to expand distribution lists on messages going to external Internet users. Expansion of distribution lists can result in large SMTP headers on outgoing messages. This setting corresponds with the GWIA’s ‑‑keepsendgroups switch.

     Use GroupWise User Address as Mail From: for Rule Generated Messages: Select this option if you want the GWIA to use the real user in the Mail From field instead of having auto-forwards come from Postmaster and auto-replies come from Mailer-Daemon. This setting corresponds with the GWIA’s ‑‑realmailfrom switch.

4. Click OK to save the changes.

To set the GWIA format options:

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

2. Click SMTP/MIME > Message Formatting.

   

3. Fill in the fields:

   Number of Inbound Conversion Threads: The inbound conversion threads setting lets you specify the number of threads that convert inbound messages from MIME or RFC-822 format to the GroupWise message format. The default setting is 4. This setting corresponds with the GWIA’s ‑‑rt switch.

   Number of Outbound Conversion Threads: The outbound conversion threads setting lets you specify the number of threads that convert outbound messages from the GroupWise message format to MIME or RFC-822 format. The default setting is 4. This setting corresponds with the GWIA’s ‑‑st switch.

   Default Message Encoding: The default message encoding setting lets you select the encoding method for your outbound Internet messages. You can select either Basic RFC-822 formatting or MIME formatting. MIME is the default message format. This setting corresponds with the GWIA’s ‑‑mime switch.

   If you select the Basic RFC-822 option, you can decide whether or not to have the GWIA UUEncode all ASCII text attachments to RFC-822 formatted messages. By default, this option is turned off, which means ASCII text attachments are included as part of the message body. This setting corresponds with the GWIA’s ‑‑uueaa switch.

   NOTE:RFC-822 is a very old format. Use it only if you have a specific need for it.

   Message Text Line Wrapping: The Quoted Printable text line wrapping setting lets you select the Quoted Printable MIME standard for line wrapping, which provides “soft returns”. By default this setting is turned on. If you turn the setting off, MIME messages go out as plain text and wrap text with “hard returns” according to the number of characters specified in the line wrap length setting. This setting corresponds with the GWIA’s ‑‑nqpmt switch.

   The Line Wrap Length for Message Text on Outbound Mail setting lets you specify the line length for outgoing messages. This is useful if the recipient’s email system requires a certain line length. The default line length is 72 characters. This setting corresponds with the GWIA’s ‑‑wrap switch.

   Enable Flat Forwarding: Select this option to automatically strip out the empty message that is created when a message is forwarded without adding text, and retain the original sender of the message, rather than showing the user who forwarded it. This facilitates users forwarding messages from GroupWise to other email accounts. Messages arrive in the other accounts showing the original senders, not the users who forwarded the messages from GroupWise. This setting corresponds with the GWIA’s ‑‑flatfwd switch.

   Default Global Signature to Insert in Outbound Messages: Displays the default global signature for your GroupWise system as described in Section 14.3.2, Selecting a Default Global Signature for All Outgoing Messages. If you want this GWIA to append a different global signature, select Override, then select the desired signature.

   Apply Global Signature to Relay Messages: Select this option to append the global signature to messages that are relayed through your GroupWise system (for example, messages from POP and IMAP clients) in addition to messages that originate within your GroupWise system. This setting corresponds with the GWIA’s ‑‑relayaddsignature switch.

   Disable Mapping X-Priority Fields: Select this option to disable the function of mapping an x-priority MIME field to a GroupWise priority for the message. By default, the GWIA maps x-priority 1 and 2 messages as high priority, x-priority 3 messages as normal priority, and x-priority 4 and 5 as low priority in GroupWise. This setting corresponds with the GWIA’s ‑‑nomappriority switch.

4. Click OK to save the changes.

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

2. Click SMTP/MIME > Timeouts.

   

3. Fill in the fields:

   Commands: The Commands setting lets you specify how long the GWIA waits for an SMTP command. The default is 5 minutes. This setting corresponds with the GWIA’s ‑‑tc switch.

   Data: The Data setting lets you specify how long the GWIA waits for data from the receiving host. The default is 3 minutes. This setting corresponds with the GWIA’s ‑‑td switch.

   Connection Establishment: The Connection Establishment setting lets you specify how long the GWIA waits for the receiving host to establish a connection. The default is 2 minutes. This setting corresponds with the GWIA’s ‑‑te switch.

   Initial Greeting: The Initial Greeting setting lets you specify how long the GWIA waits for the initial greeting from the receiving host. The default is 5 minutes. This setting corresponds with the GWIA’s ‑‑tg switch.

   TCP Read: The TCP Read setting lets you specify how long the GWIA waits for a TCP read. The default is 5 minutes. This setting corresponds with the GWIA’s ‑‑tr switch.

   Connection Termination: The Connection Termination setting lets you specify how long the GWIA waits for the receiving host to terminate the connection. The default is 10 minutes. This setting corresponds with the GWIA’s ‑‑tt switch.

4. Click OK to save the changes.

To set the GWIA undeliverable message options:

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

2. Click SMTP/MIME > Undeliverables.

   

3. Fill in the fields:

   Amount of Original Message to Return to Sender When Message is Undeliverable: This setting lets you specify how much of the original message is sent back to the sender when a message is undeliverable. By default, only 2 KB of the original message is sent back. This setting corresponds with the GWIA’s ‑‑mudas switch.

   Forward Undeliverable Inbound Messages to Host: This setting lets you specify a host to which undeliverable messages are forwarded.

   When an IP address is specified rather than a DNS hostname, the IP address must be surrounded by square brackets [ ]. For example, [172.16.5.18].

   This setting corresponds with the GWIA’s ‑‑fut switch.

   Undeliverable or Problem Messages: This setting lets you specify what you want the GWIA to do with problem messages. A problem message is an inbound or outbound message that the GWIA cannot convert properly. By default, problem messages are discarded. If you want to save problem messages, specify whether to move the messages to the problem directory (gwprob), send them to the postmaster, or do both. This setting corresponds with the GWIA’s ‑‑badmsg switch.

   IMPORTANT:Despite the field name (Undeliverable or Problem Messages), this setting does not apply to undeliverable messages.

4. Click OK to save the changes.

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

2. Click Access Control > SMTP Relay Settings.

   

3. Under SMTP Relay Defaults, select whether you want to allow or prevent message relaying.

   If you prevent message relaying, you can define exceptions that allow message relaying for specific Internet hosts. This can also be done if you allow message relaying. We suggest that you select the option that enables you to define the fewest exceptions.

4. To prevent relaying of messages larger than a specific size (regardless of the SMTP Relay Defaults setting), enable the Prevent Messages Larger Than option and specify the size limitation.

5. To define an exception, click Create to display the New Internet Address dialog box.

   

6. Fill in the following fields:

   From: Specify the Internet address that must be in the message’s From field for the exception to be applied.

   To: Specify the Internet address that must be in the message’s To field for the exception to be applied. This is also the address that the message is relayed to (in the case of an Allow exception).

   In both the From and To fields, you can use either an IP address or a DNS hostname, as shown in the following examples:

   novell.com
   10.1.1.10
   

   You can enter a specific address, as shown above, or you can use wildcards and IP address ranges to specify multiple addresses, as follows:

   *.novell.com
   10.1.1.*
   10.1.1.10-15
   

   NOTE:If the user for whom you want to define an exception has an alias, you must also define an exception for the user’s alias. Ongoing use of aliases is not recommended. For more information, see Section 5.14, Gateway Alias Migration.

7. Click OK to add the exception to the list.

8. When you are finished defining exceptions, click OK to save your changes.

To set up a route.cfg file:

1. Create the route.cfg file as a text file in the domain\wpgate\gwia directory.

2. Add an entry for each SMTP host you want to send to directly. The entry format is:

   hostname  address
   

   Replace hostname with a DNS hostname or an Internet domain name. Replace address with an alternative hostname or an IP address. For example:

   novell.com gwia.novell.com
   unixbox [172.16.5.18]
   

   If you use an IP address, it must be included in square brackets, as shown above.

   To reference subdomains, place a period (.) in front of the domain name as a wildcard character. For example:

   .novell.com gwia.novell.com
   

   Make sure to include a hard return after the last entry.

3. Save the route.cfg file.

4. Restart the GWIA.

1. Open the appropriate statusxx.xml file, located in the domain\wpgate\gwia directory.

   The domain\wpgate\gwia directory includes a statusxx.xml file for each language included in the downloaded GroupWise 2012 software image (for example, statusus.xml, statusde.xml, and statusfr.xml).

2. Make the modifications you want.

   The following sample code shows the elements and default text of the Undeliverable Message status:

   <STATUS_MESSAGE type="undeliverableMessage" xml:lang="en-US">
   <SUBJECT>Message status - undeliverable</SUBJECT>
   <MESSAGE_BODY>
   <TEXT>\r\nThe attached file had the following undeliverable recipient(s):\r\n</TEXT>
   <RECIPIENT_LIST format="\t%s\r\n"
   <SESSION_TRANSCRIPT>
   <TEXT>\r\nTranscript of session follows:\r\n<TEXT>
   </SESSION_TRANSCRIPT>
   <ATTACH_ORIGINAL_MSG></ATTACH_ORIGINAL_MSG>
   </MESSAGE_BODY>
   </STATUS_MESSAGE>
   

   You can modify text in the <SUBJECT> tag or in the <TEXT> tags.

   You can add additional <TEXT> tags in the <MESSAGE_BODY>.

   You can remove tags to keep an element from being displayed. For example, you could remove the <ATTACH_ORIGINAL_MSG></ATTACH_ORIGINAL_MSG> tags to keep the original message from displaying.

   You can use the following format characters and variables:

   • \t: tab

   • \r: carriage return

   • \n: line feed

   • %s: recipient name variable

3. Save the file, renaming it from statusxx.xml to status.xml.

4. Restart the GWIA.