To set the Internet Agent basic SMTP/MIME settings:

1. In ConsoleOne®, right-click the Internet Agent 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 Internet Agent’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 Internet Agent’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 Internet Agent’s /rd switch.

   Kill Threads on Exit or Restart: Select this option to cause the Internet Agent 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 Internet Agent’s /killthreads switch.

   Enable iCal Service: Select this option if you want the Internet Agent 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 Scheduling Group and Posted Items in the GroupWise 7 Windows Client User Guide. This setting corresponds with the Internet Agent'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 Internet Agent 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 Internet Agent’s /hn switch.

   If you leave this field blank, the Internet Agent 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 e-mail. 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 Internet Agent’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 Internet Agent sends the message directly to the host rather than to the relay host. For information about creating a route.cfg file, see Section 46.1.9, Using a Route Configuration File.

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

   Use 7 Bit Encoding for All Outbound Messages: By default, the Internet Agent 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 Internet Agent discovers that the receiving SMTP host cannot handle 8-bit MIME encoded messages, the Internet Agent converts the messages to 7-bit encoding.

   With this option selected, the Internet Agent 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 Internet Agent’s /force7bitout switch.

   Maximum Number of Hours to Retry a Deferred Message: Specify the number of hours after which the Internet Agent stops trying to send deferred messages. The default is 96 hours, or 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 forth). This setting corresponds with the Internet Agent’s /maxdeferhours switch.

   Intervals to Retry a Deferred Message: Specify in a comma-delimited list the number of minutes after which the Internet Agent retries sending deferred messages. The default is 20, 20, 20, 240. The Internet Agent 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 240 minutes (4 hours) after the third retry. Thereafter, it retries every 240 minutes 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 Internet Agent’s /msgdeferinterval switch.

   Do Not Publish GroupWise Information on an Initial SMTP Connection: Select this option to suppress the GroupWise version and copyright date information that the Internet Agent typically responds with when contacted by another SMTP host or a telnet session. This setting corresponds with the Internet Agent’s /nosmtpversion switch.

4. Click OK to save the changes.

To configure ESMTP settings:

1. In ConsoleOne, right-click the Internet Agent 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 Internet Agent to request status notifications for outgoing messages and to supply status notifications for incoming messages. This requires the external e-mail 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 Internet Agent 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 Internet Agent 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.

4. Click OK to save the changes.

To set the Internet Agent address handling options:

1. In ConsoleOne, right-click the Internet Agent 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 Internet Agent uses Internet-style addressing.

   If you do not want the Internet Agent 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 (Internet Agent 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 Internet Agent supports user and post office aliases in either mode. This setting corresponds with the Internet Agent’s /dia switch.

   Expand Groups on Incoming Messages: Turn on this option to have incoming Internet messages addressed to public groups sent to all members of the groups. This setting corresponds with the Internet Agent’s /group 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.7, 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 Internet Agent 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 Internet Agent 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 Internet Agent’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.7, 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 Internet Agent 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 Internet Agent 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 Internet Agent’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 Internet Agent 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 Internet Agent’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 Internet Agent’s /aqor switch.

     Retain Distribution Lists on Outgoing Messages: Select this option if you do not want the Internet Agent 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 Internet Agent’s /keepsendgroups switch.

     Use GroupWise User Address as Mail From: for Rule Generated Messages: Select this option if you want the Internet Agent 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 Internet Agent’s /realmailfrom switch.

4. Click OK to save the changes.

To set the Internet Agent format options:

1. In ConsoleOne, right-click the Internet Agent 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 Internet Agent’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 Internet Agent’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 Internet Agent’s /mime switch.

   If you select the Basic RFC-822 option, you can decide whether or not to have the Internet Agent 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 Internet Agent’s /uueaa switch.

   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 Internet Agent’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 e-mail system requires a certain line length. The default line length is 72 characters. This setting corresponds with the Internet Agent’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 e-mail 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 Internet Agent’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 Internet Agent 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 Internet Agent’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 Internet Agent 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 Internet Agent’s /nomappriority switch.

4. Click OK to save the changes.

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

2. Click SMTP/MIME > Timeouts.

   

3. Fill in the fields:

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

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

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

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

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

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

4. Click OK to save the changes.

To set the Internet Agent undeliverable message options:

1. In ConsoleOne, right-click the Internet Agent 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 deemed undeliverable. By default, only 2 KB of the original message is sent back. This setting corresponds with the Internet Agent’s /mudas switch.

   Forward Undeliverable Inbound Messages to Host: This setting lets you specify a host to which undeliverable messages are forwarded. This might be useful if you use UNIX sendmail aliases.

   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 Internet Agent’s /fut switch.

   Undeliverable or Problem Messages: This setting lets you specify what you want the Internet Agent to do with problem messages. A problem message is an inbound or outbound message that the Internet Agent 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 Internet Agent’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 Internet Agent 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
   

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

8. When 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
   

   where address is either an alternative hostname or an IP address. For example:

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

   Make sure to include a hard return after the last entry. In addition, if you use an IP address, it must be included in square brackets, as shown in the second example.

3. Save the route.cfg file.

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 on your GroupWise 7 Administrator CD (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 Internet Agent.