gwmta (1)


gwmta - GroupWise Message Transfer Agent


gwmta [--show] --home domain_directory
gwmta [--show] @startup_file


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

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 /opt/novell/groupwise/agents/share directory.


Usage Options:

--home domain_directory

Specifies the domain directory, 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 Agent Installation program automatically sets the --home switch to the domain directory in the MTA startup file.


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


Starts the MTA with a user interface similar to that provided for the Windows MTA. By default, no user interface is provided for the MTA 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 MTA 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 MTA to run as a non-root user.

/opt/novell/groupwise/agents/bin/gwmta --home /gwsystem/provo1

Starts the MTA by specifying the domain directory.

/opt/novell/groupwise/agents/bin/gwmta @provo1.mta

Starts the MTA by specifying the MTA startup file.

/opt/novell/groupwise/agents/bin/gwmta --show @provo1.mta

Starts the MTA with a user interface.


If you use the --show startup switch, error messages are displayed in the Alert box of the MTA server console where the MTA is running. By default, error messages are also written to the MTA log file located in the /var/log/novell/groupwise/domain_name.mta 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 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.

For information about MTA 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.