gwmta (1)

Name

gwmta - GroupWise Message Transfer Agent

Syntax

gwmta [--show] --home /domain_folder
gwmta [--show] @/domain_folder/domain_name.mta

Description

A domain organizes post offices into a logical grouping for administration and routing purposes in your GroupWise system. Messages are transferred between post offices and domains by the Message Transfer Agent (MTA). Messages are transferred to and from your GroupWise system by the Internet Agent (GWIA).

You can provide MTA startup switches on the command line or in a startup file. By default, the startup file is named after the domain and has a .mta extension. It is located in the domain folder.

Options

Usage Options:

--home /domain_folder

Specifies the domain folder, where the MTA can access the domain database (wpdomain.db). There is no default location. You must use this switch in order to start the MTA.

The Installation Wizard automatically sets the --home switch to the domain folder in the MTA startup file.

@/domain_folder/domain_name.mta

Specifies the location of the MTA startup file. The MTA startup file is created in the domain folder and is named after the domain, with a .mta extension. The startup file includes the --home switch.

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

--show

Starts the MTA with a server console user interface.

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

/domain_folder/domain_name.mta: Startup file where startup switches are specified.
/var/log/novell/groupwise/domain.mta/mmddmta.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/gwmta --home /gwsystem/provo1: Starts the MTA by specifying the domain folder.
/opt/novell/groupwise/agents/bin/gwmta @/gwsystem/provo1/provo1.mta: Starts the MTA by specifying the MTA startup file.
/opt/novell/groupwise/agents/bin/gwmta --show @/gwsystem/provo1/provo1.mta: Starts the MTA 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

Error messages are written to the MTA log file located in the /var/log/novell/groupwise/domain_name.mta 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 0518mta.001 indicates that it is an MTA log file created on May 18. If you restart the MTA on the same day, a new log file is created, named 0518mta.002.