Page 1 Internet Agent Chapter 45, “Configuring Internet Addressing,” on page 717 Chapter 46, “Configuring Internet Services,” on page 731 Chapter 47, “Managing Internet Access,” on page 763 Chapter 48, “Configuring the Internet Agent,” on page 785 Chapter 49, “Monitoring the Internet Agent,” on page 793 Chapter 50, “Optimizing the Internet Agent,”...
Page 2 716 GroupWise 8 Administration Guide...
Page 3 Internet-style addressing, users have the same address within the GroupWise system as ® they do outside the GroupWise system. For example, if John Smith’s address at Novell jsmith@novell.com, this address can be used by users within the GroupWise system and users external to the system.
Page 4 Internet domain at the domain, post office, or user level, meaning that different users within your GroupWise system can be assigned different preferred Internet domains. For example, users in one domain can be assigned gw.novell.com as their preferred Internet domain while users in another domain are assigned support.novell.com.
Page 5: Table Of Contents
userID.post_office@internet_domain_name userID@internet_domain_name firstname.lastname@internet_domain_name lastname.firstname@internet_domain_name firstinital lastname@internet_domain_name As with the preferred Internet domain, you must assign a preferred address format to be used as the default for your GroupWise system. The system’s preferred address format is applied to all users in your GroupWise system.
Page 6: Firstname.lastname@Internet_Domain_Name
Backwards-compatible with previous versions of GroupWise. (Users won’t need to update their business cards.) Addresses do not change as users are moved. Disadvantages When you first enable this address format, you might have duplicate user IDs in your ® GroupWise system. However, in the future, ConsoleOne prevents you from creating duplicate user IDs within the same Internet domain name.
Page 7: Firstinital Lastname@Internet_Domain_Name
If you select all five formats, the Internet Agent accepts messages addressed to users in any of the formats. For example, John Peterson would receive messages sent using any of the following addresses: jpeterson.research@novell.com jpeterson@novell.com john.peterson@novell.com peterson.john@novell.com jpeterson@novell.com You must designate the allowed address formats to be used as the default formats for your GroupWise system.
Page 8 45.1.6 Override Options In spite of the best planning, some e-mail addresses do not fit the rules and are not processed correctly. You can handle such addresses by overriding the regular address processing, as described Section 45.2.3, “Overriding Internet Addressing Defaults,” on page 725.
Page 9 3 Specify the Internet domain name (for example, Corporate.com), then click OK to set up the first Internet domain for your GroupWise system. 4 If you want your GroupWise system to receive e-mail addressed to additional Internet domain names: 4a Repeat Step 2 Step 4b When you are finished adding Internet domain names to the list, select the preferred...
Page 10 (for example, John Peterson’s user ID is 46789 so his address is 46789@novell.com). In this case, you could publish users’ addresses as the first initial last name (for example, jpeterson@novell.com) and enable this option so that the Internet Agent resolves the addresses to the appropriate users.
Page 11 45.2.3 Overriding Internet Addressing Defaults All domains, post offices, and users/resources in your GroupWise system inherit the defaults (Internet Agent for outbound messages, preferred Internet domain name, preferred address format, and allowed address formats) you established when enabling Internet addressing for your system. However, if desired, you can override these defaults for individual domains, post offices, or users/ resources.
Page 12 Post Office Overrides At the post office level, you can override the preferred Internet domain name, preferred address format, and allowed address formats the post office has inherited from its domain. You cannot override the Internet Agent that is assigned to handle outbound messages. 1 In ConsoleOne, right-click a Post Office object, then click Properties.
Page 13 John Petersons, each on a different post office in your system, you would end up two users having the same address (John.Peterson@novell.com). You could use this field to differentiate them by including their middle initials in their address (John.S.Peterson@novell.com and John.A.Peterson@novell.com).
Page 14 for overriding the current e-mail address format, as described in Section 14.7.2, “Changing a User’s Internet Addressing Settings,” on page 247. The Gateway Alias Migration utility can also update users’ preferred Internet domain names based on their existing gateway aliases. Section 45.3.1, “Planning to Migrate Gateway Aliases,”...
Page 15 4 In the SMTP Gateway Alias Type drop-down list, select the type of alias you want to migrate. The list of available gateway alias types is generated from the Gateway Alias Type fields on the Identification property pages of the Internet Agent objects in your GroupWise system. The resulting alias list provides the SMTP gateway aliases for all users associated with the object selected in Step...
Page 16 If you do, the domain name is transferred into the Internet Domain Name field on the Internet Addressing property page of the User object. NOTE: For an internal user, if the Internet domain name is not defined in your GroupWise system under Tools > GroupWise System Operations > Internet Addressing, then the Internet domain name is not transferred into the Internet Domain Name field on the Internet Addressing property page of the User object.
Page 17 Configuring Internet Services For detailed instructions about installing and starting the Internet Agent for the first time, see “Installing the GroupWise Internet Agent” in the GroupWise 8 Installation Guide. The Internet Agent offers several useful services that you can configure to meet the needs of your ®...
Page 18 How to handle messages that cannot be sent immediately and must be deferred Whether to notify senders when messages are delayed Whether to display GroupWise version information when establishing an SNMP connection To set the Internet Agent basic SMTP/MIME settings: ®...
Page 19 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 switch.
Page 20 Return Notification to Sender When a Message Is Delayed: Select this option to provide a notification message to users whose e-mail 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.
Page 21 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.
Page 22 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.
Page 23 The Foreign ID field (Internet Agent object > GroupWise > Identification) identifies the Internet domain names for which the Internet Agent accepts messages. The field should always include your mail domain name (for example, novell.com). You can include additional domain names by separating them with a space, as in the following example: novell.com gw.novell.com gwia.novell.com...
Page 24 When you list multiple Internet domain names, the Internet Agent accepts messages for a GroupWise user if any of the Internet domain names are used (for example, jsmith@novell.com, jsmith@gw.novell.com, or jsmith@gwia.novell.com). The field limit is 255 characters. If you need to exceed that limit, you can create a frgnames.cfg...
Page 25 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.
Page 26 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 switch. Data: The Data setting lets you specify how long the Internet Agent waits for data from the receiving host.
Page 27 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.
Page 28 For information about configuring the Internet Agent’s dial-up feature with routing software, see TID 10007366 in the Novell Support Knowledgebase (http://www.novell.com/support). Enabling Dial-Up Services After you have the appropriate routing software in place, you can enable and configure the Internet Agent’s dial-up services.
Page 29 /etrnhost switch. ETRN Queue: Specify your e-mail domain as provided by your Internet Service Provider (for example, novell.com). This setting corresponds with the Internet Agent’s /etrnqueue switch. Username: The Username setting applies only if you are using a Windows Remote Access Server (RAS) and the Internet Agent is not running on the same server as the RAS.
Page 30 3 Continue with the desired task: “Applying a Profile” on page 744 “Creating a Profile” on page 744 “Editing a Profile” on page 745 “Deleting a Profile” on page 745 Applying a Profile 1 Select the profile in the Profiles list. 2 Click the desired hour.
Page 31 For example, if you set Messages to 20, Kilobytes to 100, and Minutes to 60, the Internet Agent instructs the routing service to initiate a dial-up connection when 20 messages have accumulated in the queue, when the total size of the messages in the queue reaches 100 K, or when 60 minutes have passed since the last connection.
Page 32 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...
Page 33 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.
Page 34 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>...
Page 35 Because MIME handles such a variety of file types, you might need to customize aspects of MIME for your users. “Customizing MIME Preamble Text” on page 749 “Customizing MIME Content-Type Mappings” on page 749 Customizing MIME Preamble Text An ASCII file called is installed in the Internet Agent gateway directory preamble.txt ).
Page 36 file is located in the directory. The following section mimetype.cfg domain\wpgate\gwia provide information you need to know to modify the file: “Mapping Format” on page 750 “File Organization” on page 751 Mapping Format Each mapping entry in the file uses the following format: content-type .ext|dtk-code|mac-ttttcccc [/parms] ["comment"] Element Description...
Page 37 Element Description "comment" Optional content description File Organization file contains the following four sections: mimetype.cfg [Parameter-Override] [Mac-Mappings] [Detect-Mappings] [Extension-Mappings] [Parameter-Override] section take priority over other sections. You can use this section to [Parameter-override] force the encoding scheme for certain file types. This section also contains defaults for sending various kinds of multipart messages.
Page 38 The Internet Agent uses the detect code to map to a MIME content type and then encode the file according to the assigned encoding scheme. If there is no mapping specified or if the file type cannot be determined, one of the other mapping methods, such as Extension-Mappings, are used. The detect codes associated with attachments are GroupWise internal codes and cannot be changed.
Page 39 3 To enable POP3, fill in the following fields: Enable POP3 Service: POP3 service is off by default. Select this option to allow POP3 downloads from a GroupWise mailbox. It corresponds with the Internet Agent’s /pop3 switch. Number of Threads for POP3 Connections: The POP3 threads setting lets you specify the number of connections for POP3 download requests.
Page 40 Maximum Number of Items to Read: Specify in thousands the maximum number of items that you want the Internet Agent to download at one time. By default, the Internet Agent downloads 10,000 items at a time. For example, specify 15 to download 15,000 items at a time. This setting corresponds with the Internet Agent’s /imapreadlimit switch.
Page 41 3 In the Post Offices list, select the post office whose link information you want to change, then click Edit Link to display the Edit Post Office Link dialog box. 4 Define the following properties: Access Mode: The access mode determines whether the Internet Agent uses client/server access, direct access, or both client/server and direct access to connect to the post office.
Page 42 Most e-mail clients are configured differently. However, all Internet clients need to know the following information: POP3/IMAP4 Server: The DNS hostname or IP address of the Internet Agent. Login Name: The user’s GroupWise user ID. For POP3 clients, there are several user ID login options you can use to control how the Internet Agent handles the user’s messages.
Page 43 Option Explanation Example The p option purges the messages from the GroupWise User_ID:p mailbox after they have been downloaded to the POP3 client. t=1-1000 The t option defines the download period, starting with the User_ID:t=14 current day. For example, if you specify 14, then only messages that are 14 days old or newer are downloaded.
Page 44 LDAP Context: Use this option to limit the directory context in which the LDAP server searches. For example, if you want to limit LDAP searches to the Novell organization container located under the United States country container, enter O=Novell,C=US. This setting corresponds with the Internet Agent’s...
Page 45 3 Fill in the fields: LDAP Defaults: Select one of the following defaults for public access: Allow Access or Prevent Access. If you select Allow Access, the GroupWise fields (in the Visible Fields lists) default to Visible for an LDAP search. If you select Prevent Access, the GroupWise fields default to Not Visible.
Page 46 User block control: By using the /l=length and /b=number switches on the message’s To line, the sender can control the block length and number of blocks to send to the pager. By default, the Internet Agent sends 255 bytes per block (/l=255 /b=1). To set up and use paging services, complete the tasks in the following sections: Section 46.4.1, “Setting Up Paging,”...
Page 47 5 In the Link Type field, select Gateway. 6 In the Gateway Link field, select the Internet Agent. 7 In the Gateway Access String field, type -page 8 Click OK to save the information. 9 Click File > Exit > Yes to save your changes and exit the Link Configuration tool. 10 Restart the Internet Agent.
Page 48 762 GroupWise 8 Administration Guide...
Page 49: Classes Of Service
Managing Internet Access After you have configured the Internet services that you want the Internet Agent to provide in your ® GroupWise system, you need to take control of the information that flows in and out between your GroupWise system and the Internet. Section 47.1, “Controlling User Access to the Internet,”...
Page 50 The default class of service, which all users belong to, allows incoming and outgoing SMTP/MIME messages, and allows POP3 and IMAP4 access. You can control user access, at an individual, distribution list, post office, or domain level, by creating different classes of service and adding the appropriate members to the classes.
Page 51 3 Click Create to display the Create New Class of Service dialog box. 4 Type a name for the class, then click OK to display the Edit Class of Service dialog box. 5 On the SMTP Incoming tab, choose from the following options: Managing Internet Access 765...
Page 52 Inherit Access: Select this option if you want members of this class of service to inherit their SMTP Incoming access from a class of service assigned at a higher level. For example, a post office inherits the domain’s access. If the domain is not a member of a class of service, the post office inherits the default class of service.
Page 53 Inherit Access: Select this option if you want members of this class of service to inherit their SMTP Outgoing access from a class of service assigned at a higher level. For example, a post office inherits the domain’s access. If the domain is not a member of a class of service, the post office inherits the default class of service.
Page 54 Prevent Access: Select this option to prevent members of the class from sending and receiving messages with an IMAP4 client. 8 Click POP3, then choose from the following options: Inherit Access: Select this option if you want members of this class of service to inherit their POP3 access from a class of service assigned at a higher level.
Page 55 Maximum Number of Messages to Download: This option applies only if you selected Allow Access. Select the maximum number of messages a user can download at one time from a GroupWise Mailbox to a POP3 client. The default is 100 messages. POP3 client users can override this option by using the userID:l=x login option when initiating their POP session.
Page 56 47.1.3 Testing Access Control Settings If you created multiple classes of service, you might not know exactly which settings are being applied to a specific object (domain, post office, distribution list, or user) and which class of service the setting is coming from. To discover an object’s settings, you can test the object’s access. 1 In ConsoleOne, right-click the Internet Agent object, then click Properties.
Page 57 6 To view the source for a specific setting, select the setting in the Setting box The Setting Source fields display the class of service being applied to the object. It also displays the Member ID through which the class is being applied. 7 When finished, click OK.
Page 58 Validating the Database 1 In ConsoleOne, right-click the Internet Agent object, then click Properties. 2 Click Access Control > Database Management to display the Database Management page. 3 Click Validate Now. 4 After the database has been validated, click OK. 5 If errors were found, see Recovering the Database below.
Page 59 3 Click Recover Now. 4 Click OK. 5 Check your class of service list to make sure that it is complete. 47.2 Blocking Unwanted E-Mail from the Internet The GroupWise Internet Agent includes the following features to help you protect your GroupWise system and users from unwanted e-mail: Section 47.2.1, “Real-Time Blacklists,”...
Page 60 Defining a Blacklist Address 1 In ConsoleOne, right-click the Internet Agent object, then click Properties. 2 Click Access Control > Blacklists to display the Blacklists page. The Blacklist Addresses list displays the addresses of all blacklists that the Internet Agent checks when it receives a message from another SMTP host.
Page 61: Access Control Lists
5 If you have multiple blacklists in the Blacklist Addresses list, use the up-arrow and down-arrow to position the blacklists in the order you want them checked. The Internet Agent checks the blacklists in the order they are listed, from top to bottom. 6 Click OK to save your changes.
Page 62 You can block on any segment of the hostname. For example: Hostname Blocks provo*.novell.com provo.novell.com provo1.novell.com provo2.novell.com *.novell.com gw.novell.com (but not novell.com itself) There is no limit to the number of IP addresses and hostnames that you can block in the file blocked.txt 3 Save the file as blocked.txt 47.2.4 Mailbomb (Spam) Protection...
Page 63 Reject if PTR Record Does Not Exist: This setting lets you prevent messages if the sender’s host is not authentic. When this setting is turned on, the Internet Agent refuses messages from a smart host if a DNS reverse lookup shows that a PTR record does not exist for the IP address of the sender’s host. When this setting is turned off, the Internet Agent accepts messages from any host, but display a warning if the initiating host is not authentic.
Page 64 3 Select Flag Any Messages, then specify the strings in the text box. Anti-spam services use different indicators to mark potential spam. One might use a string of asterisks; the more asterisks, the greater the likelihood that the message is spam. Another might use a numerical value;...
Page 65 For example: smtp.novell.com remotehost novell 2 If you have multiple SMTP hosts that require authentication before they accept messages from your system, create an entry for each host. Make sure to include a hard return after the last entry.
Page 66 3 Turn on the Reject Mail if Sender’s Identity Cannot Be Verified option. This setting corresponds with the Internet Agent’s /rejbs switch. 4 Click OK to save your changes. 47.3 Tracking Internet Traffic with Accounting Data The Internet Agent can supply accounting information for all messages, including information such as the message’s source, priority, size, and destination.
Page 67: Enabling Accounting
3 Click Add, browse for and select the user you want to add, then click OK to add the user to the list of administrators. 4 Select the user in the list of administrators, then click Accountant. 5 Click OK to save the changes. 47.3.2 Enabling Accounting 1 In ConsoleOne, right-click the Internet Agent object, then click Properties.
Page 68 5 Click OK. 47.3.3 Understanding the Accounting File The following is an Accounting file entry for a single event. Each field in the entry is described below. O,11/25/2009,21:58:39,3DE29CD2.14E:7:6953, Mail,2,Provo,Research,jsmith,48909,Meeting Agenda,Provo,GWIA,sde23a9f.001,MIME,hjones@novell.com,1,2,11388,0 Accounting File Entry Fields Table 47-2 Field Example Description Displays I for inbound messages and O for...
Page 69 (001) is incremented by one for each message sent. MIME The message type (MIME, etc.) Foreign message type hjones@novell.com The foreign user’s e-mail address. For inbound Foreign user’s address messages, the foreign user is the message sender. For outbound messages, the foreign user is the message recipient.
Page 70 784 GroupWise 8 Administration Guide...
Page 71 Configuring the Internet Agent ® As your GroupWise system grows and evolves, you might need to modify Internet Agent configuration to meet the changing needs of your system. The following topics help you configure the Internet Agent: Section 48.1, “Changing the Link Protocol between the Internet Agent and the Message Transfer Agent,”...
Page 72 3 In the TCP/IP Address field, click Edit, specify the IP address of the server where the Internet Agent is running, then click OK to return to the Network Address page. 4 In the Message Transfer Port field, specify a unique port number; for example, 7102. 5 Click OK to save the new link configuration for the Internet Agent.
Page 73 4 In the Alternate Internet Agent for Outbound SMTP/MIME Messages field, select an Internet Agent as an alternate for this domain. 5 Click OK to save your changes. The MTA always tries to transfer outbound Internet messages to the primary Internet Agent first, so after an outage the primary Internet Agent automatically resumes its normal processing for the domain.
Page 74 3 Deselect Bind Exclusively to TCP/IP Address, then click OK to save your change. Corresponding Startup Switches You can use the startup switch in the Internet Agent startup file to establish an exclusive bind to the specified IP address. If you have used this switch in the Internet Agent startup file, remove it to turn off the exclusive bind.
Page 75 3 Fill in the Certificate File, SSL Key File, and Set Password fields: Certificate File: Specify the server certificate file that the Internet Agent will use. The certificate file must be in Base64/PEM or PFX format. If you type the filename rather than using the Browse button to select it, use the full path if the file is not in the same directory as the Internet Agent program.
Page 76 For more information about POP3 and IMAP4 clients, see Section 46.2, “Configuring POP3/IMAP4 Services,” on page 752. For more information about LDAP clients, see Section 46.3, “Configuring LDAP Services,” on page 757. To configure connections to use SSL: 1 In ConsoleOne, if the Internet Agent object’s property pages are not already displayed, right- click the Internet Agent object, then click Properties.
Page 77 Enabled: The POP client determines whether an SSL connection or non-SSL connection is used with an SSL-enabled Internet Agent. An SSL-enabled Internet Agent allows SSL connections on port 995 and non-SSL connections on port 110. Required: The Internet Agent forces SSL connections on port 995 and port 110. Non-SSL connections are denied.
Page 78 792 GroupWise 8 Administration Guide...
Page 79 Section 49.1, “Using the Internet Agent Server Console,” on page 793 Section 49.2, “Using the Internet Agent Web Console,” on page 805 Section 49.3, “Using Novell Remote Manager,” on page 807 Section 49.4, “Using an SNMP Management Console,” on page 807 Section 49.5, “Assigning Operators to Receive Warning and Error Messages,”...
Page 80 Windows: If the Internet Agent is running as a Windows service under the Local System User, it is displayed on the desktop only if the Allow Service to Interact with Desktop option was selected during installation or has been configured on the Internet Agent service’s General property page.
Page 81 Internet Agent Server Console Figure 49-3 Processing: Displays a rotating bar if the Internet Agent is running. If there is no bar, or if the bar is stationary for more than one minute, the Internet Agent is not running. GroupWise: Displays whether the Internet Agent’s network connection is OPEN or CLOSED. This network connection is the Internet Agent’s only link to GroupWise.
Page 82 Message Statistics The Message Statistics section of the console, shown below, is the default statistics section displayed by the Internet Agent console. Internet Agent Server Console Figure 49-4 Message Statistics shows the number of inbound and outbound messages processed by the Internet Agent.
Page 83 Linux and Click Statistics > SMTP Service. Windows: SMTP Service Statistics Section of the Internet Agent Server Console Figure 49-5 Messages Sent: Displays the total number of SMTP messages sent by the Internet Agent during its current up time. Send Threads: The first number displays the number of threads currently being used to send SMTP messages.
Page 84 Hosts Down: Displays the number of SMTP hosts that the Internet Agent could not establish a connection with in order to send or receive messages. The Internet Agent was able to resolve the hostname to an IP address, but the connection could not be established. Connections Denied: Displays the number of connections denied by the Internet Agent.
Page 85 POP Service Statistics Section of the Internet Agent Server Console Figure 49-6 Total Sessions: Displays the total number of POP3 sessions processed by the Internet Agent during its current up time. Active Sessions: Displays the number of currently active POP3 sessions. Idle Sessions: Displays the number of threads still available to the Internet Agent for POP3 sessions.
Page 86 TCP/IP Write Errors: Displays the number of TCP write errors encountered by the Internet Agent. A TCP write error occurs if the Internet Agent successfully opens a POP3 session but is unable to process a TCP write command during the session. Denied Access Count: Displays the number of POP3 sessions that were denied because the user does not have POP3 access.
Page 87 Normal Threads: Displays the number of IMAP threads that are busy and the number that are available. Secure Threads: Displays the number of IMAP SSL threads that are busy and the number that are available. Unknown Users: Displays the number of user logins that failed because the user does not exist in the GroupWise system.
Page 88 LDAP Service Statistics Section of the Internet Agent Server Console Figure 49-8 Public Sessions: Displays the total number of LDAP sessions handled by the Internet Agent. Authenticated Sessions: This field is not used. Sessions Active: Displays the total number of LDAP sessions currently being processed by the Internet Agent.
Page 89: Menu Functions
Internet Agent Server Console Figure 49-9 49.1.5 Menu Functions The following sections explain the menu options available in the Internet Agent console: “NetWare Internet Agent Console” on page 803 “Linux and Windows Internet Agent Console” on page 804 NetWare Internet Agent Console The menu functions on the NetWare Internet Agent console provide you with the following options.
Page 90 F6-Colors: Select this option to scroll through the several color options. This option is useful if the Internet Agent station has a monochrome monitor. You can also use this option to help you quickly identify an Internet Agent if more than one is running. F8-Zero Stats: Select this option to reset the values in the Statistics section of the screen.
Page 91 49.2 Using the Internet Agent Web Console You can use a Web browser interface, referred to as the Web console, to monitor the Internet Agent. You cannot use the Internet Agent Web console to change any of the Internet Agent’s settings. Changes must be made through ConsoleOne, the server console, or the startup file.
Page 92 7 In the HTTP User Name field, enter an arbitrary username (for example, gwia). 8 Click Set Password to assign a password (for example, monitor). 9 Click OK to save your changes. ConsoleOne then notifies the Internet Agent to restart to put the new settings into effect. 49.2.2 Monitoring the Internet Agent at the Web Console 1 In a Web browser, enter the following: (non-secure server)
Page 93 Status). You can click Help on any page for information about the page. 49.3 Using Novell Remote Manager If the Internet Agent is running on NetWare 6.5 or on Novell Open Enterprise Server (OES), you can use the IP Address Management feature in Novell Remote Manager (Manage Server > IP Address Management) to view the IP address and port configuration for the Internet Agent.
Page 94 Before you can monitor the Internet Agent through an SNMP management console, you must compile the Internet Agent’s MIB (Management Information Base) file. The Internet Agent’s MIB file, named , is located in the directory on the GroupWise 8 DVD or gwia.mib agents\snmp downloaded GroupWise 8 image, or in the GroupWise software distribution directory.
Page 95 3 Click Add, select a user, then click OK to add the user to the Gateway Administrators list. 4 Make sure Operator is selected as the Administrator Role. 5 If desired, add additional operators. 6 Click OK. 49.6 Using Internet Agent Log Files You can use the Internet Agent logging options to help you monitor its operation.
Page 96 Startup NetWare Linux Windows ConsoleOne Switches Console Console Console Maximum Disk Space Log File Location The log settings in ConsoleOne are used as the default settings. Startup switches override the ConsoleOne log settings, and console settings override startup switches. Section 49.6.1, “Modifying Log Settings in ConsoleOne,” on page 810 Section 49.6.2, “Modifying Log Settings through Startup Switches,”...
Page 97 IP address of any inbound SMTP connections; the Internet Agent-specific MSG number; and SMTP connection messages such as “Connect to novell.com” and “Accepted connection from 172.16.5.18 novell.com”. Diagnostic: Displays detailed function calls made by the Internet Agent. This level is not useful for most troubleshooting.
Page 98 IP address of any inbound SMTP connections; the Internet Agent-specific MSG number; and SMTP connection messages such as “Connect to novell.com” and “Accepted connection from 172.16.5.18 novell.com”. Diag: Displays detailed function calls made by the Internet Agent. This level is not useful for most troubleshooting.
Page 99: Viewing Log Files
SMTP connections; the Internet Agent-specific MSG number; and SMTP connection messages such as “Connect to novell.com” and “Accepted connection from 172.16.5.18 novell.com”. Select Diagnostic to display a detailed trace of gateway messages, errors, and operations that can be useful for troubleshooting.
Page 100 Log files are named according to the date they were created. If the Internet Agent was restarted during the day, the file extension indicates which session is logged (for example 0518log.003 indicates the third session logged for May 18). Archived log files are saved in ASCII. You can use any text editor to open a file or to print it. You can also view the log files from the Internet Agent console or the Internet Agent Web console.
Page 101 49.9.3 Using a Mail Message The Internet Agent can be stopped by sending a shutdown message to the Internet Agent. In order to shut down the program with a message, the user sending the message must be defined as an operator for the Internet Agent.
Page 102 816 GroupWise 8 Administration Guide...
Page 103 Optimizing the Internet Agent The following sections provide information about some of the methods you can use to optimize the ® speed and reliability of the GroupWise Internet Agent: Section 50.1, “Relocating the Internet Agent’s Processing Directories,” on page 817 Section 50.2, “Increasing Internet Agent Speed,”...
Page 104 3 Fill in the fields: Conversion Directory: Select the directory where the Internet Agent stores temporary files for message conversion. The default conversion directory depends on the Internet Agent platform. NetWare: domain\wpgate\gwia000.prc\gwwork Linux: domain/wpgate/gwia/000.prc/gwwork Windows: c:\grpwise\gwia If you type a path to a Windows drive (rather than using the Browse button to select the directory), you must use UNC path syntax.
Page 105 50.2 Increasing Internet Agent Speed You can implement the following procedures to help enhance the Internet Agent’s processing speed: Section 50.2.1, “Sending and Receiving Threads,” on page 819 Section 50.2.2, “Changing the Maximum Packet Received Buffers,” on page 819 Section 50.2.3, “Increasing Polling Time,” on page 819 Section 50.2.4, “Decreasing the Timeout Cycles,”...
Page 106 3 Modify the following settings: Idle Sleep Duration: Select the time, in seconds, you want the Internet Agent to idle after it has processed its queues. A low setting, such as 5 seconds, speeds up processing but requires more resources. A higher setting slows down the Internet Agent but requires fewer resources by reducing the number of network polling scans.
Page 107 2 Click Reattach > Settings to display the NetWare reattachment Settings page. 3 Define the following properties: ® Tree: Specify the Novell eDirectory tree that the Internet Agent logs in to. If the Internet Agent does not use an eDirectory user account, leave this field blank.
Page 108 822 GroupWise 8 Administration Guide...
Page 109 Connecting GroupWise Systems and Domains Using the Internet Agent ® The Internet Agent can be used as a link between GroupWise systems and between domains in the same GroupWise system. Section 51.1, “Connecting GroupWise Systems,” on page 823 Section 51.2, “Linking Domains,” on page 828 51.1 Connecting GroupWise Systems If you have two independent GroupWise systems, you can use the Internet Agent to connect the two systems.
Page 110 After you have connected the two systems, users can send messages between the two systems by entering the recipients’ full addresses (userID.post_office.domain or user@host). If desired, you can simplify addressing by exchanging information between systems, which causes user information to be displayed in the Address Book. The easiest way to exchange information is to enable the External System Synchronization feature in both systems.
Page 111 4 Repeat Step 1 through Step 3 to define an external domain in the second GroupWise system. If you do not have administrative rights to that system, you must coordinate with that GroupWise system’s administrator. 5 Continue with Linking to the External Domain.
Page 112 2 In the Outbound Links list, double-click the external domain to display the Edit Domain Link dialog box. 3 Modify the following fields: Link Type: Select Gateway. Gateway Link: Select the name of your Internet Agent. Gateway Access String: Specify the hostname (Internet Agent object > SMTP/MIME > Settings) or foreign ID (Internet Agent object >...
Page 113 By default, the rest of the domains in your system should have an indirect link to the external domain. To verify this for a domain: 5 In the list of domains on the Link Configuration utility’s toolbar, select the domain whose link you want to check, then verify that the external domain is displayed in the Indirect column of the Outbound Links list.
Page 114 For more information about link protocols, see Chapter 10, “Managing the Links between Domains and Post Offices,” on page 145. 51.1.5 Sending Messages Between Systems After you have established links between the Internet Agent domains in the two GroupWise systems, users in one system can send message to recipients in the other system by including the recipients’...
Page 115 To configure gateway links between two domains: 1 In ConsoleOne, right-click the Provo domain, then click GroupWise Utilities > Link Configuration to display the Link Configuration utility. 2 In the Outbound Links list, double-click the Cambridge domain to display the Edit Domain Link dialog box.
Page 116 By default, any domains that are already linked to your Provo domain should have an indirect link to the Cambridge domain through the Provo domain. To verify this for a domain: 5 In the list of domains on the Link Configuration utility’s toolbar, select the domain whose link you want to check, then verify that the Cambridge domain is displayed in the Indirect column of the Outbound Links list.
Page 117 Using Internet Agent Startup Switches Before GroupWise 7 SP1, Internet Agent configuration information was stored both in eDirectory, as properties of the Internet Agent object, and in the Internet Agent configuration file ( gwia.cfg Starting in GroupWise 7 SP1, all primary configuration settings have been consolidated into the properties of the Internet Agent object.
Page 118 ; if you do, the changes do not affect the Internet Agent. Linux: file used by the Linux Internet Agent is located in the gwia.cfg /opt/novell/ directory. groupwise/agents/share Windows: file used by the Windows Internet Agent is located in the gwia.cfg...
Page 119 You can use either a hyphen (-) or an equals sign (=) to separate a switch from its value. For example, you can use /sd-12 or /sd=12. If you use a hyphen rather than a forward slash as the switch delimiter, you must use an equal sign (for example, -sd=12). If you use the Linux double-hyphen standard, you must user a space (for example, --sd 12).
Page 120 NetWare Internet Windows Internet Linux Internet Agent ConsoleOne Settings Agent Agent /dhome --dhome /dhome Server Directories > Settings > SMTP Queues Directory /defaultcharset --defaultcharset /defaultcharset --delayedmsgnotifica SMTP/MIME > Settings delayedmsgnotifi tion delayedmsgnotifi cation cation --nodelayedmsgnotif ication nodelayedmsgno nodelayedmsgno tification tification /dia --dia /dia...
Page 121 NetWare Internet Windows Internet Linux Internet Agent ConsoleOne Settings Agent Agent /forceinboundauth --forceinboundauth /forceinboundauth /forceoutboundauth --forceoutboundauth /forceoutboundauth /fut --fut /fut SMTP/MIME > Undeliverables > Forward Undeliverable Inbound Messages /group --group /group SMTP/MIME > Address Handling > Expand Groups on Incoming /nogroup --nogroup /nogroup...
Page 122 NetWare Internet Windows Internet Linux Internet Agent ConsoleOne Settings Agent Agent --it POP3/IMAP4 > Settings > Number of Threads for IMAP4 Connections /keepsendgroups --keepsendgroups /keepsendgroups SMTP/MIME > Address Handling > Retain Distribution Lists on Outgoing /nokeepsendgroups --nokeepsendgroups /nokeepsendgroups Messages /keyfile --keyfile /keyfile GroupWise >...
Page 123 NetWare Internet Windows Internet Linux Internet Agent ConsoleOne Settings Agent Agent /maxdeferhours --maxdeferhours /maxdeferhours SMTP/MIME > Settings > Maximum Number of Hours to Retry a Deferred Message /mbcount --mbcount /mbcount SMTP/MIME > Security Settings > Enable Mailbomb Protection and Mailbomb Threshold /mbtime --mbtime /mbtime...
Page 124 NetWare Internet Windows Internet Linux Internet Agent ConsoleOne Settings Agent Agent /notfamiliar --notfamiliar /notfamiliar /familiar --familiar /familiar /nqpmt --nqpmt /nqpmt SMTP/MIME > Message Formatting > Enable Quoted Printed Message Text Line Wrapping SMTP/MIME > Settings > Scan Cycle for Send Directory /password /pop3 --pop3...
Page 125 NetWare Internet Windows Internet Linux Internet Agent ConsoleOne Settings Agent Agent /smtphome --smtphome /smtphome Server Directories > Settings > Advanced > SMTP Service Queues Directory /smtpport --smtpport /smtpport GroupWise > Network Address > SMTP Port /smtpssl --smtpssl /smtpssl GroupWise > Network Address > SMTP SSL /sslit --sslit...
Page 126 Telnet session. You should enter the hostname assigned to you by your Internet service provider. Syntax: /hn=host_name Example: /hn=gwia.novell.com This switch is required only under certain circumstances. Normally, the Internet Agent gets the information from another source and does not need this switch. If you receive a message that the /hn switch is required, you must use the switch.
Page 127 52.3.4 /user (NetWare Only) Sets the login ID that the NetWare Internet Agent must use to log into a remote file server to access the domain database and Internet Agent directories. Syntax: /user-login_ID 52.3.5 /password (NetWare Only) Sets the password that the NetWare Internet Agent must use to log into a remote file server to access the domain database and Internet Agent directories.
Page 128 Syntax: --show 52.5 Environment Switches The following switches configure Internet Agent environment settings such as working directories, NetWare clustering support, and SNMP support. /cluster /ipa /nosnmp /smtphome /work 52.5.1 /cluster Informs the Internet Agent that it is running in a cluster. A clustered Internet Agent automatically binds to the IP address configured for the Internet Agent object even if the Bind Exclusively to TCP/ IP Address option is not selected on the Internet Agent Network Address page in ConsoleOne.
Page 129 Sets the directory where the Internet Agent stores its temporary files. On NetWare and Linux, the work directory is located in the domain by default. On Windows, it is not. NetWare: domain\wpgate\gwia\000.prc\gwwork Linux: domain/wpgate/gwia/\000.prc/gwwork Windows: c:\grpwise\gwia Syntax: /work-pathname NetWare Example: /work-sys:\tmp\work Linux Example: -work /opt/novell/groupwise/tmp Windows Example: /work-j:\tmp\work Using Internet Agent Startup Switches 843...
Page 130 52.5.8 /nasoq By default, the Internet Agent sends the accounting file ( ) to users specified as accountants in acct ConsoleOne (Internet Agent object > GroupWise > Gateway Administrators). The file is sent daily at midnight and any time the Internet Agent shuts down. This switch instructs the Internet Agent to send the acct file once daily at midnight, not each time the Internet Agent quits or is shut down.
Page 131 Syntax: /nosmtpversion 52.6.2 iCal Enabled The following switch enables iCal. /imip /imip Converts outbound GroupWise Calendar items into MIME text/calendar iCal objects and converts incoming MIME text/calendar messages into GroupWise Calendar items. Syntax: /imip 52.6.3 Address Handling The following switches determine how the Internet Agent handles e-mail addresses: /aql /aqor /ari...
Page 132 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.
Page 133 Example: /ari-never /blockrulegenmsg In ConsoleOne, you can control whether or not rule-generated messages are allowed to leave your GroupWise system by selecting or deselecting the Rule-Generated Messages options available in each class of service defined for the Internet Agent. This switch allows you to be specific in the types of rule-generated messages that are blocked.
Page 134 /fd822 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.
Page 135 /group Turns on distribution list expansion. By default, the Internet Agent does not expand distribution lists, which means that recipients listed in distribution lists do not receive incoming Internet messages that are addressed to distribution lists. Use this switch to expand distribution lists into individual e-mail addresses of the distribution list members, so that the recipients in distribution lists do receive incoming Internet messages addressed to distribution lists.
Page 136 /notfamiliar Instructs the Internet Agent to not include the user’s familiar name, or display name, in the From field of the message’s MIME header. In other words, the From field is address rather than "familiar_name" address. Syntax: /notfamiliar /realmailfrom Instructs 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.
Page 137 confidence level is 25, meaning that if the detection process returns a confidence level of 25 or above, the Internet Agent uses the detected character set, but if the confidence level is less than 25, the Internet Agent uses the default character set. Valid values range from 0 to 100. Syntax: /charsetconfidencelevel-number Example: /charsetconfidencelevel-35 /dbchar822...
Page 138 Syntax: /force7bitout /iso88591is Instructs the Internet Agent to map inbound MIME ISO-8859-1 messages to another character set that you specify. Syntax: /iso88591is-charset Example: /iso88591is-big5 /koi8 Instructs the Internet Agent to map all outbound MIME messages to the KOI8 (Russian) character set.
Page 139 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 Section 46.1.4, “Determining Format Options for Messages,” on page 738.
Page 140 /flatfwd 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.
Page 141 Syntax: /noesmtp /dsn Enables Delivery Status Notification (DSN). The Internet Agent requests status notifications for outgoing messages and supplies 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 Section 46.1.2, “Using Extended SMTP (ESMTP) Options,”...
Page 142 Specifies the maximum number of threads used for processing SMTP send requests (outbound messages). Each thread is equivalent to one connection. The default is 8 threads. See Section 46.1.1, “Configuring Basic SMTP/MIME Settings,” on page 731. Syntax: /sd-number_of_threads Example: /sd-12 /killthreads Instructs the Internet Agent to quickly terminate any active send/receive threads when it restarts.
Page 143 Services” on page 742. Syntax: /etrnqueue-email_domain Example: /etrnqueue-novell.com /dialuser (Windows Only) Specifies the RAS Security user if you are using a Windows Remote Access Server (RAS) and the Internet Agent is not running on the same server as the RAS.
Page 144 Specifies how long the program waits for the receiving host to establish a connection. The default is 5 minutes. Syntax: /te-minutes Example: /te-2 Specifies how long the program waits for the initial greeting from the receiving host. The default is 3 minutes.
Page 145 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.
Page 146 Do with Undeliverable Messages,” on page 740. Syntax: /fut-host Example: /fut-novell.com /mudas Controls how much of the original message is sent back when a message is undeliverable. By default, only 2 KB of the original message is sent back. The value is specified in KB (8=8KB). See Section 46.1.6, “Determining What to Do with Undeliverable Messages,”...
Page 147 /mbcount 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...
Page 148 This switch corresponds to the Blacklist Addresses list (Internet Agent object > Access Control > Blacklists). For details about this setting, see Section 47.2.1, “Real-Time Blacklists,” on page 773. 52.7 POP3 Switches The following optional startup switches that can be used to configure the Internet Agent’s POP3 service: /nopopversion /pop3...
Page 149 52.7.5 /popsport By default, the Internet Agent listens for secure (SSL) POP3 connections on port 995. This switch allows you to change the POP3 SSL listen port. Syntax: /popsport-port_number Example: /popsport-996 52.7.6 /popssl Disables, enables, or requires secure (SSL) connections between POP3 clients and the Internet Agent.
Page 150 52.8 IMAP4 Switches The following optional startup switches that can be used to configure the Internet Agent’s IMAP4 service: /imap4 /imapport /imapreadlimit /imapsport /imapssl /noimapversion /sslit 52.8.1 /imap4 Enables IMAP4 client access to GroupWise mailboxes through the Internet Agent. See Section 46.2.1, “Enabling POP3/IMAP4 Services,”...
Page 151 52.8.5 /imapssl Disables, enables, or requires secure (SSL) connections between IMAP4 clients and the Internet Agent. See Section 48.4, “Securing Internet Agent Connections with SSL,” on page 788. Syntax: /IMAP4ssl-enabled|disabled|required Example: /popssl-required Option Description enabled The IMAP4 client determines whether an SSL connection or non-SSL connection is used. By default, the Internet Agent listens for SSL connections on port 993 and non-SSL connections on port 143.
Page 152 52.9 HTTP (Web Console) Switches The following switches enable the HTTP Web console and control its configuration settings. The Web console enables you to monitor the Internet Agent through a Web browser. For more information, see Section 49.2, “Using the Internet Agent Web Console,” on page 805.
Page 153 Internet Agent program. Syntax: /keyfile-filename Example: /keyfile-\\server1\sys\server1.key 52.10.3 /keypasswd Specifies the private key password. If the key does not require a password, do not use this switch. Syntax: /keypasswd-password Example: /keypasswd-novell Using Internet Agent Startup Switches 867...
Page 154 52.10.4 /smtpssl Enables the Internet Agent to use a secure connection to other SMTP hosts. The SMTP host must also be enabled to use SSL or TLS (Transport Layer Security); if it is not, a non-secure connection is used. Valid settings are enabled and disabled. Syntax: /smtpssl-setting Example: /smtpssl-enabled 52.10.5 /httpssl...
Page 155 Option Description enabled The IMAP4 client determines whether an SSL connection or non-SSL connection is used. By default, the Internet Agent listens for SSL connections on port 993 and non-SSL connections on port 143. You can use the /imapsport /imapport switches to change these ports.
Page 156 /ldappwd /ldapipaddr Specifies the IP address of the LDAP server through which GroupWise authentication takes place. Syntax: /ldapipaddr-address Example: /ldapipaddr-172.16.5.18 /ldapport Specifies the port number being used by the LDAP server. The standard non-SSL LDAP port number is 389. The standard SSL LDAP port number is 636. Syntax: /ldapport-number Example: /ldapport-389 /ldapssl...
Page 157 /ldapcntxt Limits the directory context in which the LDAP server searches. For example, you could limit LDAP searches to a single Novell organization container located under the United States country container. If you restrict the LDAP context, you must make sure that users, when defining the directory in their e-mail client, enter the same context (using the identical text you did) in the Search Base or Search Root field.
Page 158 /log switch to redirect the log files to a different location. Syntax: /log-log_file_directory NetWare Example: /log-sys:\log\gwia Linux Example: --log /opt/novell/groupwise/agents/log Windows Example: /log-c:\log\gwia 52.12.2 /logdays By default, log files are deleted after 30 days. This switch overrides the default setting. The range is from 1 to 360 days.
Page 159 The values are: Diagnostic Verbose Normal (Default) Syntax: /loglevel-level Example: /loglevel-verbose 52.12.4 /logmax Controls the maximum amount of disk space for all log files. The amount of disk space each log file consumes is added together to determine the total amount of disk space used. When the limit is reached, the Internet Agent deletes the existing log files, starting with the oldest one.
Page 160 874 GroupWise 8 Administration Guide...

This manual is also suitable for:

Groupwise 8

Novell GROUPWISE 8 - INTERNET AGENT Manual

Quick Links

Need help?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Novell GROUPWISE 8 - INTERNET AGENT

Summary of Contents for Novell GROUPWISE 8 - INTERNET AGENT

This manual is also suitable for:

Table of Contents