gwpoa (1)

Name

gwpoa - GroupWise Post Office Agent.

Syntax

gwpoa [--show] --home post_office_directory
gwpoa [--show] @startup_file

Description

A post office is a collection of user mailboxes and GroupWise objects. Messages are delivered to mailboxes by the Post Office Agent (POA).

You can provide POA startup switches on the command line or in a startup file. By default, the startup file is named after the post office and has a .poa extension. It is located in the /opt/novell/groupwise/agents/share directory.

Options

Usage Options:

--home post_office_directory

Specifies the post office directory, where the POA can access message and user databases. There is no default location. You must use this switch in order to start the POA. During installation, the --home switch is automatically set to the post office directory in the POA startup file.

@startup_file

Specifies the location of the POA startup file. By default, the POA startup file is created in the /opt/novell/groupwise/agents/share directory and is named after the post office, with a .poa extension. The startup file includes the --home switch and must reside on the same server where the POA is installed. For information about startup switches, see the GroupWise Administration Guide .

--show

Starts the POA with a user interface similar to that provided for the Windows POA. By default, no user interface is provided for the POA on Linux. The --show startup switch can be used on the command line or in the gwha.conf file used by the GroupWise High Availability Service; it cannot be placed in the POA startup file.

Help Options:

--help , -?

Displays the help information and exits.

Files

/opt/novell/groupwise/agents/share/post_office_name.poa

Startup file where startup switches are specified.

/var/log/novell/groupwise/post_office.poa/mmddpoa.nnn

Log file where error messages are written.

Examples

By default, this program runs as root, but it is preferable to run it as a non-root user. See the GroupWise Installation Guide to set up the POA to run as a non-root user.

/opt/novell/groupwise/agents/bin/gwpoa --home /gwsystem/acct

Starts the POA by specifying the post office directory.

/opt/novell/groupwise/agents/bin/gwpoa @acct.poa

Starts the POA by specifying the POA startup file.

/opt/novell/groupwise/agents/bin/gwpoa --show @acct.poa

Starts the POA with a user interface.

Diagnostics

If you use the --show startup switch, error messages are displayed in the Log Message box of the POA server console where the POA is running. By default, error messages are also written to the POA log file located in the /var/log/novell/groupwise/post_office.poa directory.

Typically you find multiple log files in this directory. The first four characters of each file name represent the date. The next three identify the agent. A three-digit extension allows for multiple log files created on the same day. For example, a log file named 0518poa.001 indicates that it is a POA log file created on May 18. If you restart the POA on the same day, a new log file is created, named 0518poa.002.

For information about POA error messages, see Troubleshooting 1: Error Messages.

Authors

Copyright 2004-2012, Novell, Inc.. All rights reserved.

See Also

grpwise (1)

To report problems with this software or its documentation, visit Novell Bugzilla.