gwpoa (1)

Name

gwpoa - GroupWise Post Office Agent

Syntax

gwpoa [--show] --home /post_office_folder
gwpoa [--show] @/post_office_folder/post_office_name.poa

Description

A post office serves as an administrative unit for a group of users and mailboxes. Messages are delivered to mailboxes by the Post Office Agent (POA).

The Post Office Agent (POA) responds to GroupWise client requests for mailbox data and delivers messages between users’ mailboxes in a post office. The POA also communicates with the MTA to route messages to and from the post office. In addition, the POA performs a variety of maintenance tasks in the post office.

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 post office folder.

Options

Usage Options:

--home /post_office_folder

Specifies the post office folder, 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.

The Installation Wizard automatically sets the --home switch to the post office folder in the POA startup file.

@/post_offce_folder/post_office_name.poa

Specifies the location of the POA startup file. The POA startup file is created in the post office folder and is named after the post office, with a .poa extension. The POA startup file includes the --home switch.

For information about agent startup switches, see the GroupWise Administration Guide .

--show

Starts the POA with a server console user interface. The agent user interface requires that the X Window System and Open Motif are running on the Linux server.

By default, no user interface is provided for the agents on Linux. An agent that runs with a user interface cannot be managed in the GroupWise Admin console.

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 agent startup file.

Help Options:

--help , -?: Displays the help information and exits.

Files

/post_office_folder/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 agent to run as a non-root user.

/opt/novell/groupwise/agents/bin/gwpoa --home /gwsystem/acct: Starts the POA by specifying the post office folder.
/opt/novell/groupwise/agents/bin/gwpoa @/gwsystem/acct/acct.poa: Starts the POA by specifying the POA startup file.
/opt/novell/groupwise/agents/bin/gwpoa --show @/gwsystem/acct/acct.poa: Starts the POA with a user interface. An agent that runs with a user interface cannot be managed in the GroupWise Admin console because it is not running as a service.

Diagnostics

By default, error messages are written to the POA log file located in the /var/log/novell/groupwise/post_office_name.poa folder. You can view agent log files in the agent console.

Typically, you find multiple log files in this folder. The first four characters of each file name represent the date. The next three characters 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.