background image

666

GroupWise 7 Administration Guide

no

vd

ocx (

e

n)

  1

1

 Decemb

er

 2

007

42.3.1  Configuring MTA Log Settings and Switches

The following aspects of logging are configurable: 

Š

Log File Path (

/log

Š

Disk Logging (

/logdiskoff

)

Š

Logging Level (

/loglevel

Š

Maximum Log File Age (

/logdays

Š

Maximum Log File Size (

/logmax

)

You can configure the log settings in the following ways: 

Š

Using ConsoleOne to establish defaults (see 

Section 41.1.8, “Adjusting the MTA Logging 

Level and Other Log Settings,” on page 627

)

Š

Using startup switches to override ConsoleOne settings (see 

Section 44, “Using MTA Startup 

Switches,” on page 683

)

Š

Using the MTA server console to override log MTA settings for the current session (see 

Section , “Adjusting MTA Log Settings,” on page 656

Š

Using the MTA Web console to override other MTA settings for the current MTA session (see 

Section 42.2.4, “Controlling the MTA from the MTA Web Console,” on page 664

)

42.3.2  Viewing MTA Log Files

You can view the contents of the MTA log file from the MTA server console and Web console. See 
the following tasks:

Š

“Browsing the Current MTA Log File” on page 655

Š

“Viewing a Selected MTA Log File” on page 656

Š

“Cycling the MTA Log File” on page 656

Š

“Viewing and Searching MTA Log Files” on page 661

42.3.3  Interpreting MTA Log File Information

On startup, the MTA records the MTA settings currently in effect. Thereafter, it logs events that take 
place, including errors. To look up error messages that appear in MTA log files, see “

Message 

Transfer Agent Error Messages

” in 

GroupWise 7 Troubleshooting 1: Error Messages

.

Because the MTA consists of multiple threads, you might find it useful to retrieve the log file into an 
editor and sort it on the thread ID that follows the date and time information. Sorting will group all 
messages together for the same MTA thread. At the MTA Web console, you can search through 
multiple log files. See 

“Viewing and Searching MTA Log Files” on page 661

. You can also use the 

search capability of the MTA Web console to gather information about a specific MTA thread. See 

“Viewing and Searching MTA Log Files” on page 661

.

42.4  Using GroupWise Monitor

GroupWise Monitor is a monitoring and management tool that allows you to monitor GroupWise 
agents and gateways from any location where you are connected to the Internet and have access to a 
Web browser. The MTA Web console can be accessed from GroupWise Monitor, enabling you to 

Summary of Contents for GROUPWISE 7 - MESSAGE TRANSFERT AGENT

Page 1: ...er Agent Chapter 40 Understanding Message Transfer between Domains and Post Offices on page 605 Chapter 41 Configuring the MTA on page 613 Chapter 42 Monitoring the MTA on page 645 Chapter 43 Optimizi...

Page 2: ...604 GroupWise 7 Administration Guide novdocx en 11 December 2007...

Page 3: ...ion Stored in the Domain on page 606 Section 40 4 Role of the Message Transfer Agent on page 608 Section 40 5 Link Configuration between Domains and Post Offices on page 608 Section 40 6 Message Flow...

Page 4: ...ers do not need access to the domain directory The only person who needs file access to the domain directory is the GroupWise administrator 40 3 1 Domain Database The domain database wpdomain db conta...

Page 5: ...put queue in the local domain is the output queue for the MTAs in many other domains The MTA does not have an output queue for user messages in the local domain Because its primary task is routing mes...

Page 6: ...roupWise user information with Novell eDirectoryTM user information This handles updates made in ConsoleOne without the GroupWise Administrator snap in running See Section 41 4 1 Using eDirectory User...

Page 7: ...omains Delayed These diagrams are found in Message Delivery to a Different Domain in GroupWise 7 Troubleshooting 3 Message Flow and Directory Structure If you are using mapped UNC links refer to Group...

Page 8: ...nd the POA on Linux Direct access to post offices is not available 2 The NetWare MTA cannot service a domain or post office on a Windows server because Windows does not support the required cross plat...

Page 9: ...Links between Domains on page 618 40 7 5 MTA Domain Platform Independence through the Transfer Pull Configuration If TCP IP is not available another alternative for overcoming platform dependencies i...

Page 10: ...612 GroupWise 7 Administration Guide novdocx en 11 December 2007...

Page 11: ...ng the MTA to a Specific IP Address on page 625 Section 41 1 6 Moving the MTA to a Different Server on page 626 Section 41 1 7 Adjusting the MTA for a New Location of a Domain or Post Office on page 6...

Page 12: ...lay the Create GroupWise Agent dialog box 3 Type a unique name for the new MTA The name can include as many as 8 characters Do not use any of the following invalid characters in the name The Type fiel...

Page 13: ...quely identify each one See Chapter 42 Monitoring the MTA on page 645 8 In the Platform field select the platform NetWare Linux or Windows where the MTA will run 9 Continue with Section 41 1 2 Configu...

Page 14: ...Platform See Section 41 1 1 Creating an MTA Object in eDirectory on page 614 Agent Settings Page Scan Cycle Scan High See Section 43 2 2 Adjusting MTA Polling of Input Queues in the Domain Post Office...

Page 15: ...x Log Disk Space See Section 42 3 Using MTA Log Files on page 665 See also log logdays logdiskoff loglevel and logmax Message Log Settings Page Message Logging Level Message Log File Path See Section...

Page 16: ...g TCP IP Links between Domains on page 618 Using Mapped or UNC Links between Domains on page 621 Using Gateway Links between Domains on page 622 NOTE The Linux MTA does not support mapped or UNC links...

Page 17: ...es it easier to move the MTA from one server to another should the need arise at a later time You can assign a new IP address to the hostname in DNS without changing the MTA configuration information...

Page 18: ...ave configured the MTA for TCP IP at both ends of each link To change the link between the domains from mapped or UNC to TCP IP 1 In ConsoleOne click Tools GroupWise Utilities Link Configuration 2 Cli...

Page 19: ...Domains Successful in Message Delivery to a Different Domain in GroupWise 7 Troubleshooting 3 Message Flow and Directory Structure Using Mapped or UNC Links between Domains To change to a mapped or U...

Page 20: ...s GroupWise messages both e mail messages and administrative messages within SMTP messages in order to transport them across the Internet For setup instructions see Section 51 2 Linking Domains on pag...

Page 21: ...CP IP communication see Section 36 2 1 Using Client Server Access to the Post Office on page 486 to set up the initial TCP IP information 3 In ConsoleOne expand the Post Office object to display the P...

Page 22: ...SSL Connections to the MTA on page 629 9 Click OK to save the TCP IP information and return to the main ConsoleOne window ConsoleOne then notifies the POA to restart with message transfer processing...

Page 23: ...e Protocol field select Mapped or UNC 6 Provide the location of the post office in the format appropriate to the selected protocol 7 Click OK 8 Repeat Step 4 through Step 7 for each post office in the...

Page 24: ...are located and you are moving it to a different server you must add the dn switch or the user and password switches to the MTA startup file to give the NetWare MTA access to the server where the doma...

Page 25: ...down list select the domain where a post office has moved 3 Click View Post Office Links to display post office links 4 Double click the post office that has been moved 5 Provide its new location in...

Page 26: ...You can configure the MTA to restrict the size of messages that users are permitted to send outside the domain 1 In ConsoleOne click Tools GroupWise Utilities Link Configuration 2 Double click the dom...

Page 27: ...et eliminating the queuing and polling process used by earlier Remote clients The result is significantly improved performance for Remote client users To configure the MTA to redirect Remote client re...

Page 28: ...st Offices on page 623 Each POA must also have SSL enabled for the connection to be secure See Section 36 3 3 Securing the Post Office with SSL Connections to the POA on page 498 4 To use SSL connecti...

Page 29: ...en domains using the Link Configuration Tool See Chapter 10 Managing the Links between Domains and Post Offices on page 137 The following topics help you configure the MTA to customize routing through...

Page 30: ...b 2 In the Default Routing Domain field browse to and select the domain you want to serve as the default routing domain for your entire GroupWise system 3 If you want all GroupWise messages to pass th...

Page 31: ...tifies the MTA to restart so the routing information can be put into effect MTA Web Console You can check routing information on the Configuration page under the General Settings heading 41 3 2 Schedu...

Page 32: ...ain you want to create a link schedule for Only direct links can be scheduled 5 Click Scheduling The link schedule grid displays the current schedule for the selected direct link The grid consists of...

Page 33: ...profile click Create or To edit an existing link profile select it in the profile list then click Edit or To edit the default link profile click Default 7 If you are creating a new link profile provid...

Page 34: ...dit another link profile or Click OK to save the schedule for the current link 18 When the schedule is saved click OK to close the Edit Domain Link dialog box 19 To exit the Link Configuration Tool cl...

Page 35: ...ties Link Configuration 3 In the drop down list select the sending domain 4 Click View Domain Links to view outbound and inbound links for the sending domain 5 In the Outbound Links from sending_domai...

Page 36: ...Section 41 4 2 Enabling MTA Message Logging on page 643 41 4 1 Using eDirectory User Synchronization As long as GroupWise administration is performed with the GroupWise Administrator snap in to Conso...

Page 37: ...to perform eDirectory user synchronization The MTA server should have a local eDirectory replica for the MTA to access 1 In ConsoleOne click Tools GroupWise System Operations eDirectory User Synchron...

Page 38: ...mn for that Linux MTA displays Yes click Enable or If the eDirectory Access column for that Linux MTA displays No 6a Click Set Up eDirectory Access 6b In the Available LDAP Servers list select the LDA...

Page 39: ...ynchronize Other Domains on page 641 Assigning an eDirectory Enabled MTA to Synchronize Other Domains After at least one MTA is performing eDirectory user synchronization other MTAs not performing eDi...

Page 40: ...ion After eDirectory user synchronization is enabled you can perform eDirectory user synchronization at any time from the NetWare MTA server console See Performing eDirectory User Synchronization on p...

Page 41: ...and disk resources However gathering information about message traffic on your GroupWise system lets you perform many valuable tasks including Tracking messages Gathering statistics to help optimize...

Page 42: ...oupWise but are not supported by the GroupWise 7 MTA 6 Click OK to save the MTA message log settings ConsoleOne then notifies the MTA to restart so the new settings can be put into effect Correspondin...

Page 43: ...on 42 7 Notifying the Domain Administrator on page 671 Section 42 8 Using the MTA Error Message Documentation on page 672 Section 42 9 Employing MTA Troubleshooting Techniques on page 672 Section 42 1...

Page 44: ...g Processing Displays a rotating bar when the MTA is running If the bar is not rotating the MTA has stopped For assistance see Message Transfer Agent Problems in GroupWise 7 Troubleshooting 2 Solution...

Page 45: ...able Displays the number of messages that could not be delivered to a domain post office or gateway For assistance see MTA Statistics Box Shows Undeliverable Messages in Message Transfer Agent Problem...

Page 46: ...ecovering the Domain Database Automatically or Immediately on page 654 Performing eDirectory User Synchronization on page 655 MTA Web Console You can display MTA admin thread status on the Configurati...

Page 47: ...A 2 Restart the MTA as described in the following sections in the GroupWise 7 Installation Guide Starting the NetWare GroupWise Agents Starting the Linux GroupWise Agents as Daemons Starting the Windo...

Page 48: ...e causes it to reread the configuration information provided in ConsoleOne However the MTA does not reread its startup file when you restart it from the MTA server console 1 At the server where the MT...

Page 49: ...e To suspend the MTA admin thread 1 At the server where the MTA is running display the MTA server console 2 Click Configuration Admin Status Suspend NetWare Note Use Options Admin Status Suspend The M...

Page 50: ...e Note Use Options F10 Configuration Status The following information is provided Location Name Displays the name of the location serviced by the MTA Location Type Indicates whether the location is a...

Page 51: ...IP Lists the IP port the MTA listens on MTA Web Console You can check the current MTA status on the Links page at the MTA Web console Click a direct link to view its message queues Displaying Live Re...

Page 52: ...nknown The MTA admin thread cannot determine the status of the domain database Exit the MTA then restart it checking for errors on startup DB Sort Language Displays the language code for the language...

Page 53: ...are MTA is running display the MTA server console 2 Press F4 MTA Web Console You can see when the next eDirectory user synchronization even will occur at the bottom of the Configuration page Browsing...

Page 54: ...MTA server console 2 Click Log Cycle Log NetWare Note Use Options F10 Cycle Log File Adjusting MTA Log Settings Default log settings are established when you start the MTA However they can be adjusted...

Page 55: ...page 657 Section 42 2 2 Accessing the MTA Web Console on page 659 Section 42 2 3 Monitoring the MTA from the MTA Web Console on page 659 Section 42 2 4 Controlling the MTA from the MTA Web Console on...

Page 56: ...and Certificates on page 1117 7 Click Apply to save your changes on the Network Address page If you want to limit access to the MTA Web console you can provide a username and password 8 Click GroupWi...

Page 57: ...server1 7100 https server2 7180 When viewing the MTA Web console you can specify either the message transfer port or the HTTP port Figure 42 3 MTA Web Console 42 2 3 Monitoring the MTA from the MTA We...

Page 58: ...You can quickly determine how many messages are awaiting processing how large they are and how long they have been waiting in the routing queue Click a closed location to display its holding queue to...

Page 59: ...MTA Web Console with the Event Log Filter Page Displayed To view a particular log file select the log file then click View Events To search all log files for a particular string type the string in th...

Page 60: ...o the next hop in the link path to their destinations See Section 43 3 Optimizing the Routing Queue on page 680 Admin ADM The admin thread updates the domain database wpdomain db whenever administrati...

Page 61: ...nabling MTA Message Logging on page 643 When you enable MTA message logging the MTA stores data about GroupWise message traffic as it processes messages The stored data is then available for use from...

Page 62: ...the MTA Admin Thread on page 664 Controlling Links to Other Locations on page 665 Changing MTA Configuration Settings On the MTA Web console menu click Configuration Online help on the Configuration p...

Page 63: ...t one or more locations then click Suspend or Resume as needed 42 3 Using MTA Log Files Error messages and other information about MTA functioning are written to log files as well as displaying on the...

Page 64: ...a Selected MTA Log File on page 656 Cycling the MTA Log File on page 656 Viewing and Searching MTA Log Files on page 661 42 3 3 Interpreting MTA Log File Information On startup the MTA records the MT...

Page 65: ...ll not display in Novell Remote Manager You access Novell Remote Manager by entering the following URL in a Web browser http server_address 8008 For example http 172 16 5 18 8008 For more information...

Page 66: ...have the GroupWise agents installed 2 Type the command to load the SNMP NLM Syntax load snmp v control x monitor y trap z where v represents Verbose meaning to display informational messages and x y a...

Page 67: ...erver Upon startup each instance of the MTA is dynamically assigned a row in its SNMP table View the contents of the MTA MIB for a description of the SNMP variables in the table To set up SNMP service...

Page 68: ...ying and Compiling the MTA MIB File on page 670 42 6 2 Copying and Compiling the MTA MIB File An SNMP enabled MTA returns information contained in a Management Information Base MIB The MIB is an ASCII...

Page 69: ...ick Apply 4 Click GroupWise Agent Settings 5 Provide your system SNMP community GET string then click OK ConsoleOne then notifies the POA to restart so the new settings can be put into effect The MTA...

Page 70: ...of MTA problems is to use GroupWise Monitor to access the MTA Web console See Section 59 5 1 Configuring E Mail Notification on page 979 42 8 Using the MTA Error Message Documentation MTA error messa...

Page 71: ...e MTA on the NetWare server NetWare 6 x OES provides monitoring tools that you can use from your Web browser Processor resource and memory utilization can be compared to other non GroupWise NLM progra...

Page 72: ...674 GroupWise 7 Administration Guide novdocx en 11 December 2007...

Page 73: ...ions on page 676 43 1 1 Adjusting the Number of MTA TCP IP Connections When using TCP IP links between domains you can control the number of inbound connections the MTA can establish for receiving mes...

Page 74: ...he MTA polls its input queues Section 43 2 1 Using TCP IP Links between Locations on page 676 Section 43 2 2 Adjusting MTA Polling of Input Queues in the Domain Post Offices and Gateways on page 676 S...

Page 75: ...the regular and low priority queues 2 7 less often 4 Decrease the number of seconds in the Scan High field if you want the MTA to scan the high priority queues 0 1 more often or Increase the number o...

Page 76: ...strative messages and high priority user messages Priority 3 7 subdirectories are used for regular and low priority messages and status messages Certain administrative activities such as moving a larg...

Page 77: ...switches in the MTA startup file you can fine turn MTA processing in of the routing queue When the MTA starts it starts one or more router threads to process its routing queue Primary Use Priority Di...

Page 78: ...fied by the maxrouters switch In a system where short bursts of heavy message traffic are followed by extended lulls idle router threads could be consuming resources that would be better used by other...

Page 79: ...receives a response from the receiving agent within the currently configured wait intervals See Section 43 1 2 Adjusting the MTA Wait Intervals for Slow TCP IP Connections on page 676 Otherwise the lo...

Page 80: ...682 GroupWise 7 Administration Guide novdocx en 11 December 2007...

Page 81: ...d how they correspond to configuration settings in ConsoleOne Switch starts with a b c d e f g h i j k l m n o p q r s t u v w x y z Table 44 1 MTA Startup Switches NetWare MTA Linux MTA Windows MTA C...

Page 82: ...essagelogmaxsize messagelogmaxsize N A messagelogpath messagelogpath messagelogpath Message Log File Path messagelogsettings messagelogsettings messagelogsettings Message Logging Level msgtranssl msgt...

Page 83: ...e also keyfile and keypassword 44 4 cyhi Sets the number of seconds in the scan cycle that the MTA uses to scan its priority 0 1 input queues The default is 5 seconds See Section 43 2 2 Adjusting MTA...

Page 84: ...ilitate logging into remote servers and authenticating to eDirectory It can be used instead of the user and password switches 44 8 fast0 Causes the MTA to monitor and process the priority 0 and 1 subd...

Page 85: ...order to start the MTA 44 12 httppassword Specifies the password for the MTA to prompt for before allowing MTA status information to be displayed in your Web browser Do not use an existing eDirectory...

Page 86: ...tpssl Enables secure SSL communication between the MTA and the MTA Web console displayed in your Web browser See Section 41 2 3 Securing the Domain with SSL Connections to the MTA on page 629 See also...

Page 87: ...between the MTA and other programs See Section 41 2 3 Securing the Domain with SSL Connections to the MTA on page 629 See also certfile and keypassword 44 19 keypassword Specifies the password used t...

Page 88: ...ts the valid language codes Contact your local Novell sales office for information about language availability For more information see Chapter 7 Multilingual GroupWise Systems on page 105 NetWare MTA...

Page 89: ...he MTA on the same day a new log file would be started named 0518mta 002 See also loglevel logdiskoff logdays and logmax 44 23 logdays Sets the number of days you want MTA log files to remain on disk...

Page 90: ...degrade MTA performance but log files saved to disk consume more disk space when verbose logging is in use See Section 42 3 Using MTA Log Files on page 665 See also log logdiskoff logdays and logmax 4...

Page 91: ...m 1 to 16 See Section 43 3 Optimizing the Routing Queue on page 680 See also maxrouters 44 30 maxrouters Specifies the maximum number of router threads the MTA can start The default is 16 valid values...

Page 92: ...al msglog See Section 41 4 2 Enabling MTA Message Logging on page 643 See also messagelogsettings messagelogdays and messagelogmaxsize NetWare MTA Linux MTA Windows MTA Syntax messagelogdays days mess...

Page 93: ...DA handled the functions now consolidated into the MTA admin thread Hence the switch name noada 44 37 nodns Disables DNS lookups for the MTA See Using Dynamic Internet Links in Connecting to GroupWise...

Page 94: ...26 Maintaining Domain and Post Office Databases on page 377 44 41 nosnmp Disables SNMP for the MTA The default is to have SNMP enabled See Section 42 6 Using an SNMP Management Console on page 667 44...

Page 95: ...nnections on page 675 44 45 tcpport Sets the TCP port number on which the MTA listens for incoming messages The default is 7100 See Using TCP IP Links between Domains on page 618 44 46 tcpwaitconnect...

Page 96: ...etWare Account for Agent Access Optional in the GroupWise 7 Installation Guide See also password and dn 44 50 vsnoadm Prevents GroupWise administration messages from being processed by an integrated v...

Page 97: ...ctory However if the domain is located on a different server from where the MTA will run use a local directory so the MTA cannot lose its connection to its mslocal directory NetWare MTA Linux MTA Wind...

Reviews: