gwpoa (1)


gwpoa - GroupWise Post Office Agent.


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


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.


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.


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 .


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.



Startup file where startup switches are specified.


Log file where error messages are written.


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.


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.


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

See Also

grpwise (1)

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