Download
Share
Print this page
  1. Manuals
  2. Brands
  3. Novell Manuals
  4. Software
  5. GROUPWISE 8 - POST OFFICE AGENT
  6. Manual

Novell GROUPWISE 8 - POST OFFICE AGENT Manual

Post office agent - pages 473-616
Hide thumbs

Advertisement

Quick Links

Download this manual
IX
Post Office Agent
I X
Chapter 35, "Understanding Message Delivery and Storage in the Post Office," on page 475
Chapter 36, "Configuring the POA," on page 487
Chapter 37, "Monitoring the POA," on page 529
Chapter 38, "Optimizing the POA," on page 561
Chapter 39, "Using POA Startup Switches," on page 581
Post Office Agent
473

Advertisement

loading
Need help?

Need help?

Do you have a question about the GROUPWISE 8 - POST OFFICE AGENT and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Novell GROUPWISE 8 - POST OFFICE AGENT

Summary of Contents for Novell GROUPWISE 8 - POST OFFICE AGENT

  • Page 1 Post Office Agent Chapter 35, “Understanding Message Delivery and Storage in the Post Office,” on page 475 Chapter 36, “Configuring the POA,” on page 487 Chapter 37, “Monitoring the POA,” on page 529 Chapter 38, “Optimizing the POA,” on page 561 Chapter 39, “Using POA Startup Switches,”...
  • Page 2 474 GroupWise 8 Administration Guide...
  • Page 3 Understanding Message Delivery and Storage in the Post Office ® A post office is a collection of user mailboxes and GroupWise objects. Messages are delivered into mailboxes by the Post Office Agent (POA). The following topics help you understand the post office and the functions of the POA: Section 35.1, “Post Office Representation in ConsoleOne,”...
  • Page 4 GroupWise View Showing Post Offices in Relationship to Domains Figure 35-2 35.2 Post Office Directory Structure Physically, a post office consists of a set of directories that house all the information stored in the post office. See “Post Office Directory” in GroupWise 8 Troubleshooting 3: Message Flow and Directory Structure.
  • Page 5 Message Body: The message body contains the message text in an encrypted format and a distribution list containing user IDs of the sender and recipients. File Attachments (optional): File attachments can be any type of file that is attached to the message.
  • Page 6 Outgoing messages from local senders are stored in the message database assigned to each sender. Incoming messages from users in other post offices are stored in the message database that corresponds to the message database assigned to the sender in his or her own post office. In each case, only one copy of the message is stored in the post office, no matter how many members of the post office it is addressed to.
  • Page 7 MTA Output Queue in the Post Office The MTA output queue in each post office is the directory. post_office\wpcsout If the MTA has a mapped or UNC link to the post office, the MTA writes user messages directly into its output queue, which requires write access to the post office. If the MTA has a TCP/IP link to the post office, the MTA transfers user messages to the POA by way of TCP/IP.
  • Page 8 Library Databases The databases for managing libraries are stored in the directory and its subdirectories in the gwdms post office. file is a database shared by all libraries in the post office. It contains information about dmsh.db where each library in the post office is located. Each library has its own subdirectory in the gwdms directory.
  • Page 9 Historical Note: In GroupWise 5.x, the GroupWise client allowed the user to enter a path to the post office directory to facilitate direct access mode. The GroupWise 6.x and later clients no longer offer the user that option. However, you can force the GroupWise 6.x and later client to use direct access by starting it with the /ph switch and providing the path to the post office directory.
  • Page 10 In client/server mode, the POA is enabled for secure SSL connections by default. If necessary, you can configure the POA to force SSL connections with all clients. See Section 36.3.3, “Securing the Post Office with SSL Connections to the POA,” on page 511.
  • Page 11 Post offices can be located on the following platforms: ® ® Novell NetWare Windows Server Linux The GroupWise agents can run on the following platforms: Novell NetWare Windows Server Linux Understanding Message Delivery and Storage in the Post Office 483...
  • Page 12 In general, GroupWise is most efficient if you match the agent platform with the network operating system, so the POA and the post office should be on the same platform, and the client should be on a compatible platform. Those with mixed networks might wonder what combinations are possible. You have several alternatives.
  • Page 13 NetWare POA Linux POA Windows POA Post Office on Windows Post Office on Macintosh For these combinations, an NFS* connection is required, which is not a supported configuration for the agents. The NetWare POA cannot service a post office on a Windows server because Windows does not support the required cross-platform connection.
  • Page 14 486 GroupWise 8 Administration Guide...
  • Page 15 Configuring the POA For detailed instructions about installing and starting the POA for the first time, see “Installing GroupWise Agents” in the GroupWise 8 Installation Guide. ® As your GroupWise system grows and evolves, you might need to modify POA configuration to meet the changing needs of the post office it services.
  • Page 16 POAs for an existing post office if message traffic in the post office is heavy. To accomplish this, you must create additional POA objects as well. ® To create a new POA object in Novell eDirectory: 1 In ConsoleOne, browse to and right-click the Post Office object for which you want to create a new POA object, then click New >...
  • Page 17 7 In the Description field, type one or more lines of text describing the POA. This description displays on the POA server console as the POA runs. When you run multiple POAs on the same server, the description should uniquely identify each one. If multiple administrators work at the server where the POA runs, the description could include a note about who to contact before stopping the POA.
  • Page 18 ConsoleOne Properties Pages Corresponding Tasks and Startup Switches and Settings Domain.PO Section 36.1.1, “Creating a POA Object in eDirectory,” on page 488. Distinguished Name Name Agent Type Description Platform POA Agent Settings Page Message File Processing Section 38.2.2, “Configuring a Dedicated Message File Processing POA,”...
  • Page 19 ConsoleOne Properties Pages Corresponding Tasks and Startup Switches and Settings Disable Administration Task See /noada. Processing HTTP User Name Section 37.2.1, “Setting Up the POA Web Console,” on page 544. HTTP Password See also /httpuser and /httppassword. Network Address Page TCP/IP Address Section 36.2.1, “Using Client/Server Access to the Post Office,”...
  • Page 20 ConsoleOne Properties Pages Corresponding Tasks and Startup Switches and Settings Maintenance Handler Threads See Section 38.4.1, “Adjusting the Number of POA Threads for Database Maintenance,” on page 575. See also /gwchkthreads and /nogwchk. Perform User Upkeep Section 36.4.3, “Performing Nightly User Upkeep,” on page 526.
  • Page 21 ConsoleOne Properties Pages Corresponding Tasks and Startup Switches and Settings LDAP Authentication Section 36.3.4, “Providing LDAP Authentication for GroupWise Users,” on page 514. See also /ldapipaddr, /ldapport, /ldapuser, /ldappwd, ldapuserauthmethod, /ldapdisablepwdchg, /ldapssl, /ldapsslkey, ldaptimeout, and /noldapx. See also /ldapippooln, /ldappoolresettime, ldapportpooln, /ldapsslpooln, and /ldapsslkeypooln.
  • Page 22 5 In the Message Transfer field, specify the TCP port on which the POA will listen for incoming messages from the MTA. The default message transfer port for the POA to listen on is 7101. 6 Click OK to save the TCP/IP information and return to the main ConsoleOne window. Corresponding Startup Switches You can also use the /mtpinipaddr /mtpinport...
  • Page 23 For a sample message flow for this configuration, see “TCP/IP Link Open: Transfer between Post Offices Successful” in “Message Delivery to a Different Post Office” in GroupWise 8 Troubleshooting 3: Message Flow and Directory Structure. Corresponding Startup Switches You can also use the /mtpoutipaddr /mtpoutport startup...
  • Page 24 Corresponding Startup Switches You can also use the /mtpoutport startup switch in the POA startup file to establish an exclusive bind to the specified IP address. 36.1.5 Moving the POA to a Different Server As your GroupWise system grows and evolves, you might need to move a POA from one server to another.
  • Page 25 The full post office name is used in the filename. However, all letters are lowercase and any spaces in the post office name are removed. The startup file is located in the directory. /opt/novell/groupwise/agents/share 3 Adjust the setting of the /home switch to point to the new location of the post office directory.
  • Page 26 Log File Path: Browse to and select the directory where you want this POA to store its log files. The default location varies by platform: NetWare: post_office\wpcsout\ofs Linux: /var/log/novell/groupwise/post_office.poa Windows: post_office\wpcsout\ofs For more information about log settings and log files, see Section 37.3, “Using POA Log Files,”...
  • Page 27 Configure the POA so network management and monitoring programs can use TCP/IP to send SNMP requests to this POA Set up an external server with Internet access for the POA Configure the POA to provide a Web console for use with GroupWise Monitor Configure the POA to communicate with IMAP (Internet Message Application Protocol) clients Configure the POA to communicate with SOAP (Simple Object Access Protocol) clients...
  • Page 28 6 On the Network Address page, click the pencil icon for the TCP/IP Address field to display the Edit Network Address dialog box. 7 Select IP Address, then specify the IP address, in dotted decimal format, of the server where the POA is running.

  • Page 29: Name Server

    11 Click OK to save the network address and port information and return to the main ConsoleOne window. ConsoleOne then notifies the POA to restart with client/server processing enabled. For a sample message flow for this configuration, see “Message Delivery in the Local Post Office”...
  • Page 30 How a GroupWise Name Server Helps the GroupWise Client Start After a server has been designated as , and a POA using the default port number of ngwnameserver 1677 is running on that server, the GroupWise client can connect to the POA of the appropriate post office by contacting the POA located on .
  • Page 31 3 Fill in the following fields: Enable IMAP: Select Enable IMAP to turn on IMAP processing. Max IMAP Threads: Specify the maximum number of IMAP threads you want to the POA to start. The default maximum number of IMAP threads is 40. This is adequate for most post offices, because each IMAP thread can service multiple IMAP clients.
  • Page 32 36.2.4 Supporting SOAP Clients Simple Object Access Protocol (SOAP) is used by e-mail clients such as Evolution to access mailboxes. You can configure the POA to communicate with SOAP-enabled e-mail clients much like the GroupWise client does. 1 In ConsoleOne, browse to and select the POA object to configure, then click Properties. 2 Click GroupWise >...
  • Page 33 Users of Evolution 2.0 and later can find instructions for connecting to a GroupWise system in the Evolution online help. For more information about using Evolution to access a GroupWise mailbox, see “Evolution” in “Non-GroupWise Clients” in the GroupWise 8 Interoperability Guide.
  • Page 34 6 Click OK to save the GroupWise version and/or date settings. ConsoleOne then notifies the POA to restart so the new settings can be put into effect. Corresponding Startup Switches You can also use the /gwclientreleaseversion, gwclientreleasedate, and /enforceclientversion startup switches in the POA startup file to configure the POA to check client version and/or date information.
  • Page 35 3 Set Max Thread Usage for Priming and Moves as needed. By default, the POA allocates 30% of its client/server handler threads for priming mailboxes for users who are using Caching mode for the first time. By default, the POA starts 10 client/ server handler threads, so in a default configuration, three threads are available for priming.
  • Page 36 4 In the Maximum Send Message Size field, specify in megabytes the size of the largest message you want users to be able to send outside the post office, then click OK. 5 To exit the Link Configuration tool and save your changes, click File > Exit > Yes. ConsoleOne then notifies the POA to restart using the new maximum message size limit.
  • Page 37 Section 36.3.5, “Enabling Intruder Detection,” on page 519 Section 36.3.6, “Configuring Trusted Application Support,” on page 520 36.3.1 Securing Client/Server Access through an External Proxy Server If the server where the POA runs is behind your firewall, you can link it to an external proxy server in order to provide client/server access to the post office for GroupWise client users who are outside the firewall.
  • Page 38 5 Select IP Address, then specify the external IP address, in dotted decimal format, of the external server that GroupWise client users access from outside your firewall. Typically, this is the public IP address presented by your external proxy server, generic proxy, NAT, or PAT.
  • Page 39 addresses and a second POA to always redirect users to proxy IP addresses. Users are then redirected based on which POA IP address they provide in the GroupWise Startup dialog box when they start the GroupWise client to access their mailboxes. 1 Configure the initial POA for the post office with the IP address that you want for internal users.
  • Page 40 3 To force SSL connections between the POA and its MTA, select Required in the Message Transfer SSL drop-down list. The POA must use a TCP/IP link with the MTA in order to use SSL for the connection. See “Using TCP/IP Links between the Post Office and the Domain” on page 493.
  • Page 41 For optimum security, select Required in the IMAP SSL drop-down list if you want the POA to force SSL connections, so that non-SSL connections from IMAP clients are denied. 8 To use SSL connections between the POA and SOAP clients, select Required in the Internal SOAP SSL drop-down list and/or the External SOAP SSL drop-down list so that internal and/or external SOAP clients must use SSL connections to the POA.
  • Page 42 “Configuring a Pool of LDAP Servers” on page 517 “Specifying Failover LDAP Servers (Non-SSL Only)” on page 518 NOTE: If multiple eDirectory trees are involved, refer to TID 10067272 in the Novell Support Knowledgebase (http://www.novell.com/support) for additional instructions. Providing LDAP Server Configuration Information Information about your available LDAP servers must be provided in ConsoleOne before you can enable LDAP authentication for users.
  • Page 43 If you do not specify a full path, the POA looks in the following locations for the trusted root certificate: NetWare: POA installation directory Linux: /opt/novell/groupwise/agents/lib/nldap Windows: POA installation directory For more information about the trusted root certificate, see Section 75.3, “Trusted Root Certificates and LDAP Authentication,”...
  • Page 44 5 If you want the POA to access the LDAP server with specific rights to the LDAP directory, specify a username that has those rights. If you are using a Novell LDAP server, you can browse for an eDirectory User object. The information returned from eDirectory uses the following format:...
  • Page 45 For more information about LDAP usernames, see Section 76.3, “Authenticating to GroupWise with Passwords Stored in an LDAP Directory,” on page 1169. 6 If you want to prevent GroupWise users from changing their LDAP passwords by using the Password dialog box in the GroupWise client, select Disable LDAP Password Changing. This option is deselected by default, so that if users change their passwords in the GroupWise client through the Security Options dialog box (GroupWise Windows client >...
  • Page 46 4 Select one or more LDAP servers in the Available Servers list, then click the arrow button to move them into the Selected Servers list. 5 Click OK to save the list of LDAP servers. 6 Click OK to save the security settings for the post office. ConsoleOne then notifies the POA to restart so the new LDAP settings can be put into effect.
  • Page 47 36.3.5 Enabling Intruder Detection You can configure the POA to detect system break-in attempts in the form of repeated unsuccessful logins. This feature can be especially helpful when allowing Remote client users to establish client/ server connections to MTAs in your system. See Section 41.2.2, “Enabling Live Remote,”...
  • Page 48 POA Web Console You can view current intruder detection settings on the Configuration page and change them using the Intruder Detection link. You cannot disable intruder detection from the POA Web console. 36.3.6 Configuring Trusted Application Support For background information about setting up trusted applications in ConsoleOne, see Section 4.12, “Trusted Applications,”...
  • Page 49 By default, the POA performs the following maintenance events: Default Daily Maintenance Event: The default daily maintenance event occurs at 2:00 a.m. The POA performs a Structure check on user, message, and document databases and fixes any problems it encounters. Default Weekly Maintenance Event: The default weekly maintenance event occurs on Saturday at 3:00 a.m.
  • Page 50 5 To modify a default database maintenance action, select one of the existing actions, then click Edit. To create a new database maintenance action, click Create, then type a name for the new database maintenance action. Database maintenance actions and options you can schedule include: Actions Options on Actions Analyze/Fix Databases...
  • Page 51 36.4.2 Scheduling Disk Space Management By default, the POA performs one recurring disk space management event. Every 5 minutes, the POA checks to make sure there is at least 2048 MB of free disk space in the post office directory. If there is ever less than 2048 MB of free disk space, the POA performs a Reduce operation on the user and message databases in the post office.
  • Page 52 The Scheduled Events page lists a pool of POA events available to all POAs in your GroupWise system. 7 To modify the default disk space management event, which affects all POAs that have this disk space management event enabled, select Default Disk Check Event, then click Edit. To create a new disk space management event, which is added to the pool of POA events that can be enabled for any POA in your GroupWise system, click Create, then type a name for the new disk space management event.
  • Page 53 9 In the Trigger Actions At field, specify the minimum amount of available disk space you want to have in the post office. When the minimum amount is reached, the Disk Check actions are triggered 10 In the Stop Mail Processing At field, specify the minimum amount of available disk space at which you want the POA to stop receiving and processing messages.
  • Page 54 You might want to create several disk space management events with different triggers and actions. For some specific suggestions on implementing disk space management, see Section 12.3, “Managing Disk Space Usage in the Post Office,” on page 190. POA Web Console You can view the currently scheduled disk check events on the Scheduled Events page.
  • Page 55 3 Select Perform User Upkeep. 4 In the Start User Upkeep field, specify the number of hours after midnight for the POA to start performing user upkeep. The default is 1 hour. 5 If you have Remote or Caching users, select Generate Address Book for Remote. 6 Specify the number of hours after midnight for the POA to generate the daily copy of the GroupWise Address Book for Remote and Caching users.
  • Page 56 528 GroupWise 8 Administration Guide...
  • Page 57 Section 37.3, “Using POA Log Files,” on page 553 Section 37.4, “Using GroupWise Monitor,” on page 554 Section 37.5, “Using Novell Remote Manager,” on page 555 Section 37.6, “Using an SNMP Management Console,” on page 555 Section 37.7, “Notifying the GroupWise Administrator,” on page 559 Section 37.8, “Using the POA Error Message Documentation,”...
  • Page 58 ® NetWare The POA server console always displays on the NetWare server console. Linux: You must use the --show startup switch in order to display the Linux POA server console. “Starting the Linux Agents with a User Interface” in “Installing GroupWise Agents”...
  • Page 59 Processing: Displays a rotating bar when the POA is running. If the bar is not rotating, the POA has stopped. For assistance, see “Post Office Agent Problems” in GroupWise 8 Troubleshooting 2: Solutions to Common Problems. Busy: Displays the number of POA threads currently in use (busy) for client/server connections, message files, or both, depending on POA configuration.
  • Page 60 Requests Pending (for client/server processing): Displays the number of client/server requests from GroupWise clients the POA has not yet been able to respond to. If the number is large, see “POA Statistics Box Shows Requests Pending” in “Post Office Agent Problems”...
  • Page 61 Error Messages If the POA encounters a problem processing a message, it displays an error message in the POA Log Message box. See “Post Office Agent Error Messages” in GroupWise 8 Troubleshooting 1: Error Messages. POA Admin Thread Status Box The POA admin thread updates the post office database (wphost.db) when users and/or user information are added, modified, or removed, and repairs it when damage is detected.
  • Page 62 “Displaying Detailed Statistics about POA Functioning” on page 536 “Displaying Client/Server Information” on page 537 “Listing Message Queue Activity” on page 538 “Displaying Message Transfer Status” on page 538 “Restarting the MTP Thread” on page 539 “Displaying POA Admin Thread Status” on page 539 “Recovering the Post Office Database Automatically or Immediately”...
  • Page 63 Stopping the Linux POA When It Is Running As a Daemon To stop the Linux POA when it is running in the background as a daemon and you started it using script: grpwise 1 Make sure you are logged in as root 2 Change to the directory.
  • Page 64 POA Web Console You can suspend and resume the POA admin thread from the Configuration page. Under the General Settings heading, click Admin Task Processing > Suspend or Resume > Submit. Displaying the POA Software Date It is important to keep the POA software up-to-date. You can display the date of the POA software from the POA server console.
  • Page 65 POA Web Console You can display statistics on the Status page. Displaying Client/Server Information When the POA and the GroupWise clients communicate in client/server mode, you can display statistics to indicate the performance level of the TCP/IP communication. 1 At the server where the POA is running, display the POA server console. 2 Click Statistics >...
  • Page 66 Listing Message Queue Activity The POA uses eight queues to process message files. You can view the activity in each of these queues. For more information about message queues, see “Post Office Directory” in GroupWise 8 Troubleshooting 3: Message Flow and Directory Structure.
  • Page 67 Restarting the MTP Thread When the POA links to the MTA by way of TCP/IP, you can restart the Message Transfer Protocol (MTP) thread that provides the link between the POA and the MTA. 1 At the server where the POA is running, display the POA server console. 2 Click Actions >...
  • Page 68 Admin Thread Box The Admin Thread box displays the following information: Status: Displays one of the following statuses: Running: The POA admin thread is active. Suspended: The POA admin thread is not processing administrative messages. Starting: The POA admin thread is initializing. Terminated: The POA admin thread is not running.
  • Page 69 To change the setting permanently, see Section 36.1.2, “Configuring the POA in ConsoleOne,” on page 489. POA Web Console You can see whether automatic message and user database recovery is enabled on the Configuration page under the Performance Settings heading. Updating QuickFinder Indexes GroupWise uses QuickFinder technology to index messages and documents stored in post offices.
  • Page 70 To recreate QuickFinder indexes for the post office: 1 At the server where the POA is running, display the POA server console. 2 Click Actions > QuickFinder > Delete and Regenerate Indexes. NetWare Note: Use Options (F10) > Actions > Delete and QuickFinder Indexes. You can also press Ctrl+Q.
  • Page 71 Windows Note: For the Windows POA, you can select the viewer to use by providing the full path to the viewer program. The default viewer is Notepad. 4 Click View. For explanations of messages in the POA log file, see “Post Office Agent Error Messages”...
  • Page 72 NetWare Note: Press F1 for information in any dialog box or menu. 37.2 Using the POA Web Console The POA Web console enables you to monitor and control the POA from any location where you have access to a Web browser and the Internet. This provides substantially more flexible access than the POA server console, which can only be accessed from the server where the POA is running.
  • Page 73 9b Click Set Password. 9c Type the password twice for verification. 9d Click Set Password. ® Unless you are using an SSL connection, do not use a Novell eDirectory username and password because the information passes over the non-secure connection between your Web browser and the POA.
  • Page 74 Corresponding Startup Switches You can also use the /httpport, /httpuser, /httppassword, and httpssl startup switches in the POA startup file to enable and secure the POA Web console. In addition, you can use the /httprefresh switch to control how often the POA refreshes the information provided to your Web browser.
  • Page 75 “Viewing and Searching POA Log Files” on page 548 “Listing POA Scheduled Events” on page 549 “Checking Link Status to the MTA” on page 550 “Taking Performance Snapshots” on page 550 Monitoring POA Status When you first access the POA Web console, the Status page is displayed. Online help on the Status page helps you interpret the status information being displayed.
  • Page 76 POA Web Console Environment Page for a NetWare Server Figure 37-5 On a Linux server, the following information is displayed: POA Web Console Environment Page for a Linux Server Figure 37-6 On a Windows server, the following information is displayed: POA Web Console Environment Page for a Windows Server Figure 37-7 Viewing and Searching POA Log Files...
  • Page 77 POA Web Console with the Log Files Page Displayed Figure 37-8 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 the Events Containing field, select Select All, then click View Events.
  • Page 78 QuickFinder indexing and remote downloadable Address Book generation can be controlled using links from the Configuration page. The Configuration page also displays information about disk check events and database maintenance events. However, scheduled events must be created and modified using ConsoleOne. Checking Link Status to the MTA On the POA Web console menu, click MTP Status to view status information about the link between the POA for the post office and MTA for the domain.
  • Page 79 The POA takes a snapshot every 60 seconds. 3 Refresh your browser window to display data as it is collected. 4 Specify the interval at which you want to write data to a file on disk for permanent storage. Performance data is saved to the file, where represents the current month mmddsnap.nnn...
  • Page 80 POA Web Console with the Configuration Page Displayed Figure 37-11 Click any hyperlinked configuration items to change settings for the current agent session. The settings that can be modified are much the same as those that can be changed at the POA server console, as described in Section 37.1.2, “Controlling the POA from the POA Server Console,”...
  • Page 81 POA Web Console with the Message Transfer Protocol Settings Page Displayed Figure 37-13 On this page, you can restart MTA processing between the POA and the MTA. On the MTP status page, you can restart the send and receive threads separately. 37.3 Using POA Log Files Error messages and other information about POA functioning are written to log files as well as displaying on the POA server console.
  • Page 82 37.3.2 Viewing POA Log Files You can view the contents of the POA log file from the POA server console and Web console. See the following tasks presented in Section 37.1.1, “Monitoring the POA from the POA Server Console,” on page 529: “Browsing the Current POA Log File”...
  • Page 83 37.5 Using Novell Remote Manager If the POA 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 POA. This is also true for other GroupWise agents (MTA, Internet Agent, and WebAccess Agent) running on NetWare 6.5/OES...
  • Page 84 3 Locate the file on your Linux server. snmpd.conf 4 In a text editor, open the file and add the following line: snmpd.conf dlmod Gwsnmp /opt/novell/groupwise/agents/lib/libgwsnmp.so 5 Save the file and exit the text editor. snmpd.conf 556 GroupWise 8 Administration Guide...
  • Page 85 6 Restart the SNMP daemon (snmpd) to put the changes into effect. IMPORTANT: Make sure that the SNMP daemon always starts before the POA starts. 7 Skip to Section 37.6.2, “Copying and Compiling the POA MIB File,” on page 558. Setting Up SNMP Services for the Windows POA SNMP support is provided for up to eight Windows POAs on the same Windows server.
  • Page 86 4 Continue through the rest of the installation process as prompted by the Agent Installation program. The Agent Installation program copies the SNMP support files to the agent installation directory, makes the appropriate Windows registry entries, and restarts the Windows SNMP service.
  • Page 87 37.6.3 Configuring the POA for SNMP Monitoring In order for SNMP monitoring programs to monitor the POA, the POA must be configured with a network address and SNMP community string. 1 Browse to and right-click the POA object, then click Properties. 2 Click GroupWise >...
  • Page 88 Corresponding Startup Switches By default, the POA generates error mail if an administrator has been assigned for the domain. Error mail can be turned off using the /noerrormail switch in the POA startup file. POA Web Console Another way to receive e-mail notification of POA problems is to use GroupWise Monitor to access the POA Web console.
  • Page 89 Optimizing the POA You can adjust how the POA functions to optimize its performance. Before attempting optimization, you should run the POA long enough to observe its efficiency and its impact on other network applications running on the same server. See Chapter 37, “Monitoring the POA,”...
  • Page 90 If GroupWise client users cannot connect to the POA immediately or if response is sluggish, you can increase the number of threads. ® 1 In ConsoleOne , browse to and right-click the POA object, then click Properties. 2 Click GroupWise > Agent Settings to display the Agent Settings page. 3 Increase the number in the Client/Server Handler Threads field to increase the maximum number of threads the POA can create for client/server processing.
  • Page 91 38.1.2 Adjusting the Number of Connections for Client/Server Processing Connections are the number of “sockets” through which client/server requests are communicated from the GroupWise client to the POA. Application connections: Each GroupWise user uses one application connection when he or she starts GroupWise.
  • Page 92 5 Click OK to save the new connection settings. ConsoleOne then notifies the POA to restart so the new connection settings can be put into effect. Corresponding Startup Switches You can also use the /maxappconns /maxphysconns switches in the POA startup file to adjust the POA client/server processing. POA Web Console The Status page helps you assess whether the POA is currently meeting the...
  • Page 93 5 Increase the number in the Client/Server Handler Threads field as needed to increase the maximum number of threads the POA can create. The optimum number of threads for a POA is affected by many factors, including available system resources, number of users in Caching mode, number of users priming Caching mailboxes, and so on.
  • Page 94 38.2 Optimizing Message File Processing If you run only one POA for the post office, you can adjust the number of POA threads for message file processing. If message file processing needs are extremely heavy for a post office, you can set up a dedicated message file processing POA to meet those needs.
  • Page 95 POA uses, the more incoming messages it can process simultaneously. However, the more threads the POA uses, the fewer threads are available to other processes running on the same server. 4 Click OK to save the new thread setting. ConsoleOne then notifies the POA to restart so the new setting can be put into effect. Corresponding Startup Switches You can also use the /threads switch in the POA startup file to...
  • Page 96 5 Increase the number in the Message Handler Threads field as needed. You can configure as many as 20 message handler threads. The optimum number is affected by many factors, including available system resources. 6 Deselect Enable Client/Server. Make sure another POA handles client/server processing. 7 Select Disable Administration Task Processing, so that this POA does not run an admin thread.
  • Page 97 For a list of the file types that the POA can index, see Oracle Outside In Technology Supported Formats (http://www.oracle.com/technology/products/content-management/oit/ds_oitFiles.pdf). 38.3.1 Regulating Indexing By default, the POA indexes messages and documents in the post office every 24 hours at 8:00 p.m. You can modify this interval if users need messages and documents indexed more quickly.
  • Page 98 For security reasons, you should enable the quarantine only to collect sample problem documents in order to submit them to Novell for investigation. Then you should turn off the quarantine to reestablish appropriate security for attached documents.
  • Page 99 3 Select Quarantine Files That Fail during Conversion, then click OK. 4 Collect problem files for investigation. 5 Disable the quarantine to return to normal POA operations with full security for attached files. POA Web Console: You can see whether the quarantine is on or off on the Configuration page.
  • Page 100 To configure a basic dedicated indexing POA: 1 Create a new POA object for the post office as described in Section 36.1.1, “Creating a POA Object in eDirectory,” on page 488. 2 Right-click the new POA object, then click Properties. 3 Click GroupWise >...
  • Page 101 14 Deselect Enable Automatic Database Recovery. Make sure another POA handles database recovery. 15 Set Maintenance Handler Threads to 0 (zero). Make sure another POA handles database maintenance and disk space management. 16 Deselect Perform User Upkeep and deselect Generate Address Book for Remote. Make sure another POA handles these tasks.

  • Page 102: Reclaiming Disk Space

    When you have a large number of user databases that need to be indexed, you can configure the POA to index a specific range of databases based on user FIDs. For a task of this magnitude, you should run multiple dedicated indexing POAs with each POA configured to process a specific range of databases.
  • Page 103 files to conserve disk space during periods of heavy indexing. It is primarily applicable when .inc using /qflevel=1 where indexing is a lower priority task. For /qflevel=2 and /qflevel=3, indexing itself is a higher priority than compression and deletion cleanup tasks. 38.4 Optimizing Database Maintenance If you run only one POA for the post office, you can adjust the number of database maintenance threads.
  • Page 104 4 Click OK to save the new thread setting. ConsoleOne then notifies the POA to restart so the new setting can be put into effect. Corresponding Startup Switches You can also use the /gwchkthreads switch in the POA startup file to increase the number of POA threads started for database maintenance activities. POA Web Console The Status page helps you assess whether the POA is currently meeting the...
  • Page 105 8 Click Apply to save the updated information on the Maintenance page. 9 Click GroupWise > Scheduled Events, then create database maintenance events as needed, as described in Section 36.4.1, “Scheduling Database Maintenance,” on page 520 Section 36.4.2, “Scheduling Disk Space Management,” on page 523.
  • Page 106 3 Increase the number in the CPU Utilization field to allow the NetWare POA to use more server resources. Decrease the number in the CPU Utilization field to give the NetWare POA fewer server resources so those resources can be used by other programs on the server. 4 Decrease the number in the Delay Time field to allow NetWare POA threads to take on new tasks more quickly.
  • Page 107 By default, the POA is configured to handle a typical amount of purging efficiently. However, if the default configuration is unacceptably slow during periods of heavy purging, you can prevent users' client response time from degrading by adjusting the POA’s configuration so that it passes pass additional purge operations to background threads.
  • Page 108 580 GroupWise 8 Administration Guide...
  • Page 109 Using POA Startup Switches ® You can override settings provided in ConsoleOne by using startup switches in the POA startup file. When you run the Agent Installation program, an initial POA startup file is created in the agent installation directory. It is named using the first 8 characters of the post office name with a .poa extension.
  • Page 110 NetWare POA Linux POA Windows POA ConsoleOne Settings /httprefresh --httprefresh /httprefresh /httpssl --httpssl /httpssl HTTP SSL /httpuser --httpuser /httpuser HTTP User Name /imap --imap /imap IMAP /imapmaxthreads --imapmaxthreads /imapmaxthreads Max IMAP Threads /imapport --imapport /imapport IMAP Port /imapreadlimit --imapreadlimit /imapreadlimit /imapssl --imapssl /imapssl...
  • Page 111 NetWare POA Linux POA Windows POA ConsoleOne Settings /log --log /log Log File Path /logdays --logdays /logdays Max Log File Age /logdiskoff --logdiskoff /logdiskoff Logging Level /loglevel --loglevel /loglevel Logging Level /logmax --logmax /logmax Max Log Disk Space /maxappconns --maxappconns /maxappconns Max Application Connections /maxphysconns...
  • Page 112 NetWare POA Linux POA Windows POA ConsoleOne Settings /notcpip --notcpip /notcpip Enable Client/Server /nuuoffset --nuuoffset /nuuoffset Start User Upkeep /password --password /password Remote Password /port --port /port Client/Server Port /primingmax --primingmax /primingmax Max Thread Usage for Priming and Moves /qfbaseoffset --qfbaseoffset /qfbaseoffset Start QuickFinder Indexing...
  • Page 113 The full path must be included if the file does not reside in the same directory with the POA program. Linux: The startup file always resides in the /opt/novell/groupwise/agents/share directory. Windows: The full path must be included if the file does not reside in the same directory with the POA program.
  • Page 114 For information about clustering the POA, see the GroupWise 8 Interoperability Guide. If you are running the NetWare POA on the latest version of NetWare 6.5/OES NetWare and Novell Cluster Services , the POA can detect the cluster automatically. NetWare POA...
  • Page 115 NetWare POA Linux POA Windows POA Syntax: /enforceclientversion-setting --enforceclientversion setting /enforceclientversion-setting Exampl /enforceclientversion-version --enforceclientversion date /enforceclientversion-both See also /gwclientreleasedate, and /gwclientreleaseversion. 39.8 /evocontrol Determines which versions of Evolution are allowed to access the post office. Users might experience problems using Evolution to connect to their GroupWise mailboxes if they are using Evolution 2.6.0 or earlier.
  • Page 116 39.10 /gwchkthreads Specifies the number of threads the POA starts for Mailbox/Library Maintenance activities. The default is 4; valid values range from 1 to 8. See Section 38.4.1, “Adjusting the Number of POA Threads for Database Maintenance,” on page 575. NetWare POA Linux POA Windows POA...
  • Page 117 NetWare POA Linux POA Windows POA Syntax: /help or /? --help /help or /? Example: load gwpoa /help ./gwpoa --help gwpoa.exe /help 39.14 /home Specifies the post office directory, where the POA can find the message and user databases to service.
  • Page 118 39.17 /httprefresh Specifies the rate at which the POA refreshes the status information in your Web browser. The default is 60 seconds. See Section 37.2, “Using the POA Web Console,” on page 544. NetWare POA Linux POA Windows POA Syntax: /httprefresh-seconds --httprefresh seconds /httprefresh-seconds...
  • Page 119 NetWare POA Linux POA Windows POA Example: /imap-enabled --imap disabled /imap-enabled See also /imapmaxthreads, /imapport, /imapssl, /imapsslport, and /imapreadlimit. 39.21 /imapmaxthreads Specifies the maximum number of IMAP threads the POA can create to service IMAP clients. The default is 40. This setting is appropriate for most systems. See Section 36.2.3, “Supporting IMAP Clients,”...
  • Page 120 39.24 /imapssl Sets the availability of secure SSL communication between the POA and IMAP clients. Valid settings are enable and disable. See Section 36.3.3, “Securing the Post Office with SSL Connections to the POA,” on page 511. NetWare POA Linux POA Windows POA Syntax: /imapssl-setting...
  • Page 121 IP addresses. See Section 36.1.4, “Binding the POA to a Specific IP Address,” on page 495. See also “Editing Clustered Agent Startup Files” in “Novell Cluster Services on NetWare” in the GroupWise 8 Interoperability Guide. NetWare POA Linux POA Windows POA...
  • Page 122 /language-code Example: /language-de --language de /language-fr Contact your local Novell sales office for information about language availability. See Chapter 7, “Multilingual GroupWise Systems,” on page 111 for a list of language codes. 39.33 /ldapdisablepwdchg Prevents GroupWise users from changing their LDAP passwords by using the Password dialog box in the GroupWise client.
  • Page 123 39.34 /ldapipaddr Specifies the LDAP server’s network address as either an IP address or a DNS hostname. You can specify multiple network addresses to provide failover capabilities for your LDAP servers. See “Specifying Failover LDAP Servers (Non-SSL Only)” on page 518.
  • Page 124 39.37 /ldapport Specifies the port number that the LDAP server listens on for authentication. The default is 389. See Section 36.3.4, “Providing LDAP Authentication for GroupWise Users,” on page 514. NetWare POA Linux POA Windows POA Syntax: /ldapport-port_number --ldapport port_number /ldapport-port_number Example: /ldapport-390...
  • Page 125 See also /ldapipaddr, /ldapport, /ldapuser, /ldappwd, /ldapuserauthmethod, /ldapdisablepwdchg, ldapsslkey and /ldaptimeout. 39.41 /ldapsslpooln Indicates to the POA that the pooled LDAP server it is logging in to is using SSL. See “Configuring a Pool of LDAP Servers” on page 517. NetWare POA Linux POA Windows POA...
  • Page 126 NetWare POA Linux POA Windows POA Exampl /ldapsslkeypool4- --ldapsslkeypool4 /certs/ /ldapsslkeypool4-\ldap\gwkey.der \ldap\gwkey.der gwkey.der /ldapsslkeypool4- /ldapsslkeypool4- m:\ldap\gwkey.der svr2\sys:\ldap\gwkey.der /ldapsslkeypool4- /ldapsslkeypool4- \\svr2\c\ldap\gwkey.der \\svr2\sys\ldap\gwkey.de See also /ldapippooln, /ldapportpooln, /ldappoolresettime, and /ldapsslpooln. 39.44 /ldaptimeout Specifies the number of seconds that the POA connection to the LDAP server can be idle before the POA drops the connection.
  • Page 127 See also /intruderlockout, /incorrectloginattempts, and /attemptsresetinterval. 39.48 /log Specifies the directory where the POA stores its log files. The default location varies by platform. NetWare: post_office\wpcsout\ofs Linux: /var/log/novell/groupwise/post_office_name.poa Windows: post_office\wpcsout\ofs For more information, see Section 37.3, “Using POA Log Files,” on page 553.
  • Page 128 Typically you find multiple log files in the specified directory. The first 4 characters represent the date. The next 3 characters identify the agent. A three-digit extension allows for multiple log files created on the same day. For example, a log file named indicates that it is a POA log 0518poa.001 file, created on May 18.
  • Page 129 39.52 /logmax Sets the maximum amount of disk space for all POA log files. When the specified disk space is consumed, the POA deletes existing log files, starting with the oldest. The default is 102400 KB (100 MB). See Section 37.3, “Using POA Log Files,” on page 553.
  • Page 130 NetWare POA Linux POA Windows POA Syntax: /mtpinipaddr-network_addr --mtpinipaddr network_addr /mtpinipaddr-network_addr Example: /mtpinipaddr-172.16.5.18 --mtpinipaddr 172.16.5.19 /mtpinipaddr-172.16.5.20 /mtpinipaddr-server1 --mtpinipaddr server2 /mtpinipaddr-server3 See also /mtpinport, /mtpoutipaddr, /mtpoutport, /mtpsendmax, and /nomtp. 39.56 /mtpinport Sets the message transfer port number the POA listens on for messages from the MTA. The default is 7101.
  • Page 131 39.59 /mtpsendmax Sets the maximum size in megabytes for messages being sent outside the post office. By default, messages of any size can be transferred to the MTA. See Section 36.2.7, “Restricting Message Size between Post Offices,” on page 507. NetWare POA Linux POA Windows POA...
  • Page 132 The POA admin thread must run for at least one POA for each post office. However, it can be disabled for POAs with specialized functioning where the database update and repair activities of the POA admin thread could interfere with other, more urgent processing. NetWare POA Linux POA Windows POA...
  • Page 133 39.67 /nogwchk Turns off Mailbox/Library Maintenance processing for the POA. The default is for the POA to perform Mailbox/Library Maintenance tasks requested from ConsoleOne and configured as POA scheduled events. NetWare POA Linux POA Windows POA Syntax: /nogwchk --nogwchk /nogwchk See also /gwchkthreads.
  • Page 134 See also /nomf and /nomflow. 39.71 /nomflow Turns off processing lower priority messages files (message queues 2 through 7). For information about message queues, see “Post Office Directory” in GroupWise 8 Troubleshooting 3: Message Flow and Directory Structure. NetWare POA Linux POA Windows POA Syntax:...
  • Page 135 39.75 /nordab Disables daily generation of the GroupWise Address Book for Remote users. See Section 36.4.3, “Performing Nightly User Upkeep,” on page 526. NetWare POA Linux POA Windows POA Syntax: /nordab --nordab /nordab See also /rdaboffset. 39.76 /norecover Disables automatic database recovery. The default is for automatic database recovery to be turned If the POA detects a problem with a database when automatic database recovery has been turned off, the POA notifies the administrator, but it does not recover the problem database.
  • Page 136 Two specialized configurations that require turning off automatic database recovery are described in Section 38.2.2, “Configuring a Dedicated Message File Processing POA,” on page 567 Section 38.3.3, “Configuring a Dedicated Indexing POA,” on page 571. 39.79 /nuuoffset Specifies the number of hours after midnight for the POA to start performing user upkeep. The default is 1 hour;...
  • Page 137 39.82 /primingmax Sets the maximum number of client/server handler threads that POA can use for priming users’ Caching mailboxes. The default is 30 per cent. See Section 36.2.6, “Supporting Forced Mailbox Caching,” on page 506. NetWare POA Linux POA Windows POA Syntax: /primingmax-percentage --primingmax percentage...
  • Page 138 NetWare POA Linux POA Windows POA Syntax: /qfdeleteold --qfdeleteold /qfdeleteold See also /qflevel, /qfnolibs, /qfnopreproc, /qfnousers, /qfusefidbeg, and /qfuserfidend. 39.86 /qfinterval Specifies the interval in hours for the POA to update the QuickFinder indexes in the post office. The default is 24 hours. See Section 38.3.1, “Regulating Indexing,”...
  • Page 139 QuickFinder Indexing Priority Levels Table 39-2 Priority Level Description Index a maximum of 1000 items at a time, rather than the default of 500. Index a maximum of 500 items at time using a low priority thread. This keeps frequent daytime indexing cycles from interfering with users’...
  • Page 140 NetWare POA Linux POA Windows POA Syntax: /qfnousers --qfnousers /qfnouser See also /qfdeleteold, /qflevel, /qfnolibs, /qfnopreproc, /qfusefidbeg, and /qfuserfidend. 39.92 /qfuserfidbeg Specifies the beginning of a range of FIDs associated with user databases ( ) that you userxxx.db want to index. The xxx in the user database filename is the FID. To determine what FIDs are in use, list the contents of the directory in the post office directory.
  • Page 141 NetWare POA Linux POA Windows POA Example: /rdaboffset-2 --rdaboffset 3 /rdaboffset-4 See also /nordab. 39.95 /rights Verifies that the POA has the required network rights or permissions to all directories where it needs access in the post office directory. When started with this switch, the POA lists directories it is checking, which can be a lengthy process.
  • Page 142 NetWare POA Linux POA Windows POA Syntax: /soap-enabled or disabled --soap enabled or disabled /soap-enabled or disabled Example: /soap-enabled --soap enabled /soap-disabled See also /soapmaxthreads, /soapport, /soapsizelimit, soapssl, and /soapthreads. 39.99 /soapmaxthreads Specifies the maximum number of SOAP threads the POA can create to service SOAP clients. The default is 4;...
  • Page 143 39.102 /soapssl Sets the availability of secure SSL communication between the POA and SOAP clients. Valid settings are enable and disable. See Section 36.3.3, “Securing the Post Office with SSL Connections to the POA,” on page 511. NetWare POA Linux POA Windows POA Syntax: /soapssl-setting...
  • Page 144 NetWare POA Linux POA Windows POA Syntax: /threads-number --threads number /threads-number Example: /threads-10 --threads 15 /threads-20 39.106 /user Provides the network user ID for the POA to use when accessing post offices and/or document storage areas on remote servers. You can also provide user and password information on the Post Office Settings page in ConsoleOne.

This manual is also suitable for:

Groupwise 8