The following sections categorize and describe the switches that you can use to configure the Internet Agent's SMTP/MIME settings:
Enables the Internet Agent to process SMTP messages. See Configuring Basic SMTP/MIME Settings.
The following switches determine how the Internet Agent handles e-mail addresses:
Allows you to determine the address qualification level. It specifies which GroupWise address components (domain.post_office.user) must be included as the user portion of a GroupWise user's outbound Internet address (userhost). Valid options are auto, userid, po, and domain.
This switch is valid only if your system is not configured to use Internet-style addressing, as described in Internet-Style Addressing, or you've configured the Internet Agent to ignore Internet-style addressing, as described in Configuring How the Internet Agent Handles E-Mail Addresses.
The user part of a GroupWise user's outbound Internet address (user@host) can and sometimes must include the full Groupwise address (domain.post_office.user_ID@host) in order to be unique. The /aqor switch instructs the Internet Agent to move any GroupWise address components, except the user_ID component, to the right side of the address following the at sign (@). In this way, GroupWise addressing components become part of the host portion of the outbound Internet address. The /aql switch specifies which components are included.
For example, if the /aqor switch is used (in conjunction with the /aql-domain switch), Bob Thompson's fully qualified Internet address (headquarters.advertising.bob@novell.com) would be resolved to bob@advertising.headquarters.novell.com for all outbound messages.
If the /aqor switch is used with the /aql-po switch, Bob's Internet address would be resolved to bob@advertising.novell.com for all outbound messages.
If you use the /aqor switch to move GroupWise domain or post office names to be part of the host portion on the right side of the address, you must provide a way for the DNS server to identify the GroupWise names. You must either explicitly name all GroupWise post offices and domains in your system as individual MX Records, or you can create an MX Record with wildcard characters to represent all GroupWise post offices and domains. For information about creating MX Records, see details found in RFC #974.
For details about this setting, see Configuring How the Internet Agent Handles E-Mail Addresses.
Enables or disables additional routing information that is put in the SMTP return address to facilitate replies. This switch might be needed in large systems with external GroupWise domains in which the external GroupWise users have not been configured in your local domain. Options include Never and Always. Most sites do not need to use this switch.
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. See Configuring How the Internet Agent Handles E-Mail Addresses.
You can use this switch to disable Internet-style addressing. With Internet-style addressing disabled, messages use the mail domain name in the Foreign ID field in ConsoleOne (Internet Agent object > GroupWise > Identification) for the domain portion of a user's Internet address. The Internet Agent continues to support user and post office aliases in either mode.
By default, users' display names are First Name Last Name. If you want users' display names to be Last Name First Name, you can use the /displaylastfirst switch. This forces the display name format to be Last Name First Name, regardless of the preferred address format.
By default, the Internet Agent accepts addresses of the format:
firstname_lastname@internet_domain_name
even though this is not an address format included in the Allowed Address Formats list in ConsoleOne for configuring Internet addressing, as described in Allowed Address Formats. Use this switch to prevent this address format from being accepted by the Internet Agent.
Specifies a return address for GroupWise replies. A message that has been received by a GroupWise user through the Internet Agent and is replied to has this return address form. These switches cause the Internet Agent to produce a return address of the form foreign domain.type:"user host." Foreign domain can be any foreign domain you have configured and linked to the Internet Agent.
You can use the same foreign domain name for both the /fd822 switch and the /fdmime switch. You can specify multiple foreign domain and kind pairs by placing them in quotes. If multiple foreign domain and kind pairs are used, the first domain/kind pair is the return address for replies to messages received through the Internet Agent. The second domain/kind pair is checked to see what message format is used for old replies in the system. Up to four pairs can be specified with an 80-character limit.
This switch lets you change your foreign domain names in your GroupWise system and still have replies work. For example, if your foreign domain had been called faraway and you added a foreign domain called Internet, you could use /fd822-"internet.nonmime smtp.nonmime." This would cause replies to have a return address of internet.nonmime.:"user@host." The Internet Agent would also recognize faraway. This switch also lets you migrate from one foreign domain to another.
Most administrators do not need to use this switch.
Specifies a return address for GroupWise replies. A message that has been received by a GroupWise user through the Internet Agent and is replied to has this return address form. These switches cause the Internet Agent to produce a return address of the form foreign_domain.type:"user host." Foreign_domain can be any foreign domain you have configured and linked to the Internet Agent. Type can be either mime or nonmime.
You can use the same foreign domain name for both the /fd822 switch and the /fdmime switch.
You can specify multiple foreign domain and kind pairs by placing them in quotes. If multiple foreign domain and kind pairs are used, the first domain/kind pair is the return address for replies to messages received through the Internet Agent. The second domain/kind pair is checked to see what message format is used for old replies in the system. Up to four pairs can be specified with an 80-character limit.
This switch lets you change your foreign domain names in your GroupWise system and still have replies work. For example, if your foreign domain had been called SMTP and you added a foreign domain called Internet, you could use /fdmime-"internet.mime smtp.mime." This would cause replies to have a return address of internet.mime:"user@host." The Internet Agent would also recognize SMTP. This switch also lets you migrate from one foreign domain to another.
Most administrators do not need to use this switch.
Turns on group expansion. The default startup file has this switch commented out. If it is enabled, an incoming Internet message addressed to a public group is sent to members of that group. See Configuring How the Internet Agent Handles E-Mail Addresses.
Prevents the Internet Agent from expanding distribution lists on messages going to external Internet users so that the SMTP header does not become too large.
Instructs the Internet Agent to immediately terminate any active send/receive threads when it restarts.
Instructs the Internet Agent to map spaces to underscores in user addresses for outbound messages. For example, john smith becomes john_smith.
The following switches determine how the Internet Agent formats and encodes inbound and outbound e-mail messages:
Instructs the Internet Agent to maintain the original format of any file type attachment.
Instructs the Internet Agent to map inbound non-MIME messages to another character set that you specify. The mapped character set must be an Asian (double-byte) character set.
Specifies what character set to use if no character set is specified in an incoming message.
Syntax: /defaultcharset-charset
Example: /defaultcharset-iso-8859-1
For readability when the character set name includes hyphens (-), you can use an equal sign (=) as the delimiter between the switch and its setting.
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.
You can use the /force7bitout switch to force the Internet Agent to use 7-bit encoding and 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. See Configuring Basic SMTP/MIME Settings.
Instructs the Internet Agent to map inbound MIME ISO-8859-1 messages to another character set that you specify.
Instructs the Internet Agent to map all outbound MIME messages to the KOI8 (Russian) character set.
Instructs the Internet Agent to send outbound messages in MIME format rather than in RFC-822 format. If you've defined an RFC-822 non-GroupWise domain, as described in Creating a Non-GroupWise Domain, users can still send RFC-822 formatted messages by using the RFC-822 domain in the address string when sending messages. Removing the switch corresponds to enabling the Default Message Encoding: Basic RFC-822 switch in ConsoleOne. See Determining Format Options for Messages.
Specifies a mail view attachment for all inbound Internet messages. A view is the screen that a user sees when a message is opened. This switch helps users identify Internet messages. If you do not specify a view, or if the view has not been configured, the default view is used. See Protecting Against Unidentified Hosts and Mailbombs (Spam).
IMPORTANT: Quotes must surround a mail view name that contains a space (for example, /mv-"Expanded Mail").
When the Internet Agent receives an Internet message, it writes the view name you have chosen into a special field of the message. When a user opens that message, the GroupWise client searches the ofviews.ini file for the specified view name. If the client finds the view name and the corresponding view file, it displays the message with that view.
To configure your GroupWise system to use an existing mail view, you must know what the view is named so that you can include it with the /mv switch.
You can identify view files by their .vew extension (for example, usml_1.vew, which is the default). Views are located in the post_office\ofviews\win directory. Only views located in this directory are available to users on the post office.
View names are defined in the [Mail] section of the ofviews.ini (and/or ofviewxx.ini) file in the postoffice\ofviews\win directory. The ofviews.ini file is an ASCII text file that you can open with any text editor.
The gwia.cfg file that ships with the gateway contains an active /mv-Internet line. If you already have added a system view called Internet, messages that come from the Internet are immediately received with the Internet view you added. Otherwise, use the /mv switch to specify the name of the view you want used.
Instructs the Internet Agent to not use ISO-2022 character sets. ISO-2022 character sets provide 7-bit encoding for Asian character sets.
Disables quoted printable message text for outbound messages. If this switch is turned on, messages are sent with the Base64 MIME encoding. If you use this switch you need to review the setting for the /wrap switch to ensure that message text wraps correctly. See Determining Format Options for Messages.
Specifies the maximum number of threads that the Internet Agent uses when converting inbound messages from MIME or RFC-822 format to the GroupWise message format. The default setting is 4. See Determining Format Options for Messages.
Multiple threading allows for more than one receive process to be running concurrently. A receive request is assigned to a single thread and is processed by that thread. If you anticipate heavy inbound message traffic, you can increase the number of threads to enhance the speed and performance of the Internet Agent. The number of threads is limited only by the memory resources of your server.
Specifies the maximum number of threads that the Internet Agent uses when converting outbound messages from GroupWise message format to MIME or RFC-822 format. The default setting is 4. See Determining Format Options for Messages.
Multiple threading allows for more than one send process to be running concurrently. A send request is assigned to a single thread and is processed by that thread. If you anticipate heavy outbound message traffic, you can increase the number of threads to enhance the speed and performance of the Internet Agent. The number of threads is limited only by the memory resources of your server.
Forces the Internet Agent to UUencode any ASCII text files attached to outbound RFC-822 formatted messages. This switch applies only if the /mime switch is not used. Without this switch, the Internet Agent includes the text as part of the message body. See Determining Format Options for Messages.
Sets the line length for outbound messages. This is important if the recipient's e-mail system requires a certain line length. See Determining Format Options for Messages.
The following switches configure how the Internet Agent handles forwarded and deferred messages:
Automatically strips out the empty message that is created when a message is forwarded without adding text, and retains 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.
Specifies 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 couldn't be sent because of a temporary problem (host down, MX record not found, and so forth).
For the first hour of the specified time, the Internet Agent tries resending the message every 20 minutes. After the first hour, it tries resending the message every four hours. For example, if you specify 10 hours, the Internet Agent tries resending the message at 20 minutes, 40 minutes, 1 hour, 5 hours, and 9 hours. After the 10 hours has expired, it will return an undeliverable status to the sender. See Configuring Basic SMTP/MIME Settings.
The following switches configure the Internet Agent's Extended SMTP (ESMTP) settings:
Enables Delivery Status Notification (DSN). The Internet Agent will request status notifications for outgoing messages and will 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 and unsuccessful. See Using Extended SMTP (ESMTP) Options.
The /dsnage switch specifies the number of days that the Internet Agent will retain information about the external sender so that status updates can be delivered to him or her. For example, the default DSN 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. See Using Extended SMTP (ESMTP) Options.
The following switches configure the Internet Agent's SMTP send/receive cycle and threads:
Specifies how often, in seconds, the Internet Agent polls for outbound messages. The default,10 seconds, causes the Internet Agent to poll the outbound message directory every 10 seconds. see Configuring Basic SMTP/MIME Settings.
Specifies the maximum number of threads used for processing SMTP receive requests (inbound messages). The default is 16 threads. See Configuring Basic SMTP/MIME Settings.
Specifies the maximum number of threads used for processing SMTP send requests (outbound messages). The default is 8 threads. See Configuring Basic SMTP/MIME Settings.
Places the Internet Agent in receive-only mode. If this switch is enabled, the Internet Agent does not send any messages. Use this switch only for troubleshooting.
Places the Internet Agent in send-only mode. If you enable this switch, the Internet Agent does not receive any messages. Use this switch only for troubleshooting.
SMTP dial-up services can be used when you don't require a permanent connection to the Internet and want to periodically check for mail messages queued for processing. The following switches can be used when configuring dial-up services. For more information about dial-up services, see Configuring SMTP Dial-Up Services.
Specifies the IP address or DNS hostname of the mail server (where your mail account resides) at your Internet Service Provider. You should obtain this address from your Internet Service Provider. See Enabling Dial-Up Services.
Specifies your e-mail domain as provided by your Internet Service Provider. See Enabling Dial-Up Services.
The following switches specify how long SMTP services waits to receive data that it can process. After the time expires, the Internet Agent might give a TCP read/write error. Leave these switches at the default setting unless you are experiencing a problem with communication.
Specifies how long the program waits for data from the receiving host. The default is 5 minutes.
Specifies how long the program waits for the receiving host to establish a connection. The default is 5 minutes.
Specifies how long the program waits for the initial greeting from the receiving host. The default is 3 minutes.
The following switch configures whether or not the Internet Agent uses a relay host.
Specifies the IP address or DNS hostname of a relay host that you want the Internet Agent to use for outbound messages. The relay host can be part of your network or can reside at the Internet service provider's site. This switch is typically used in firewall integration if you want one server, the specified relay host, to route all mail. See Configuring Basic SMTP/MIME Settings.
The Internet Agent supports SMTP host authentication for both inbound and outbound message traffic.The following switches are used with inbound and outbound authentication:
Ensures that the Internet Agent accepts messages only from remote SMTP hosts that use the AUTH LOGIN authentication method to provide a valid GroupWise user ID and password. The remote SMTP hosts can use any valid GroupWise user ID and password. However, for security reasons, we recommend that you create a dedicated GroupWise user account for remote SMTP host authentication.
Ensures that the Internet Agent sends messages only to remote SMTP hosts that are included in a gwauth.cfg text file. The remote SMTP hosts must support the AUTH LOGIN authentication method.
The gwauth.cfg file must reside in the domain\wpgate\gwia directory and use the following format:
domain_name authuser authpassword
For example:
smtp.novell.com remotehost novell
You can define multiple hosts in the file. Make sure you include a hard return after the last entry.
If you use this switch, you need to include your Internet Agent as an entry in the gwauth.cfg file to enable status messages to be returned to GroupWise users. You can use any GroupWise user ID and password for your Internet Agent's authentication credentials. However, for security reasons, we recommend that you create a dedicated GroupWise user account for your Internet Agent.
The following switches determine how the Internet Agent handles undeliverable messages:
Specifies where to send problem messages. Problem messages can be placed in the Internet Agent problem directory (gwprob), they can be sent to the postmaster, or they can be sent to both or neither. The values for this switch are move, send, both, and neither.
The move option specifies to place problem messages in the gwprob directory for the Internet Agent. The send option specifies to send the message as an attachment to the Internet Agent postmaster defined in ConsoleOne (Internet Agent object > GroupWise > Gateway Administrators). The both option specifies to move the message to gwprob and send it to the postmaster. The neither option specifies to discard problem messages. The default when no switch is specified is move. See Determining What to Do with Undeliverable Messages.
Forwards undeliverable messages to the host specified. This can be useful if you use UNIX sendmail aliases. See Determining What to Do with Undeliverable Messages.
Controls how much of the original message is sent back when a message is undeliverable. By default, only 2 KB of the original message are sent back. The value is specified in KB (8=8KB). See Determining What to Do with Undeliverable Messages.
Multiple unsolicited messages (sometimes called a mailbomb or spam) from the Internet can potentially harm your GroupWise messaging environment. At the least, it can be annoying to your users. You can use the following switches to help protect your GroupWise system from malicious, accidental, and annoying attacks:
Sets the number of messages that can be received from a single IP address in a given number of seconds before the Internet Agent denies access to its GroupWise system. It provides a form of system security to protect your system from mailbombs.
For example, with /mbcount set to 25 and /mbtime set to 60 seconds, if these limits are exceeded the sender's IP address are blocked from sending any more messages. The IP address of the sender is also displayed in the Internet Agent console. You can permanently restrict access to your system by that IP address through settings on the Access Control page in ConsoleOne (Internet Agent object > Access Control). By default, the mailbomb feature is turned off. To enable this feature, you must specify a value for mailbomb count and mailbomb time. See Protecting Against Unidentified Hosts and Mailbombs (Spam).
Specifies the mailbomb time limit in seconds. This switch works with the /mbcount switch to block access to your GroupWise system from unsolicited inundations of e-mail. The default value is 10 seconds. See Protecting Against Unidentified Hosts and Mailbombs (Spam).
Prevents delivery of messages if the sender's host is not authentic. When this switch is used, the Internet Agent refuses messages from a host if a DNS reverse lookup shows that a PTR record does not exist for the IP address of the sender's host. See Protecting Against Unidentified Hosts and Mailbombs (Spam).
If this switch is not used, the Internet Agent accepts messages from any host, but displays a warning if the initiating host is not authentic.
Flags messages to be handled by the client Junk Mail Handling feature if they contain an x-spamflag=yes in the MIME header.
Lets you define the addresses of blacklist sites (free or fee-based) you want the Internet Agent to check for blacklisted hosts. If a host is included in a site's blacklist, the Internet Agent does not accept messages from it.
Syntax: /rbl-blackholes.mail-abuse.org,relays.ordb.org,bl.spamcop.net
This switch corresponds to the Blacklist Addresses list (Internet Agent object > Access Control tab > Blacklists page). For details about this setting, see Real-Time Blacklists.