gwia (1)


gwia - GroupWise Internet Agent


gwia [--show] --home gateway_directory
gwia [--show] @startup_file
gwia [--show] --dhome SMTP_directory
gwia [--show] --hn hostname


The GroupWise Internet Agent (GWIA) enables you to send and receive messages over the Internet.

You can provide GWIA startup switches on the command line or in a startup file. At startup, the GWIA reads its startup file, gwia.cfg. It is located in the /opt/novell/groupwise/agents/share directory.


Usage Options:

--home gateway_directory

Points the GWIA to the GWIA’s gateway directory. Normally, this is the domain_directory/wpgate/gwia directory.


Specifies the location of the GWIA configuration file, which is gwia.cfg by default. The GWIA looks for gwia.cfg in the /opt/novell/groupwise/agents/share directory. For information about startup switches, see the GroupWise Administration Guide .

--dhome SMTP_directory

Points to the SMTP service work area. This is normally the same as the GWIA’s gateway directory (domain_directory/wpgate/gwia).

--hn hostname

Provides the hostname that is displayed when someone connects to your GWIA via a Telnet session. You should enter the hostname assigned to you by your Internet service provider. Normally, the GWIA can get the information from another source and does not need this switch. If you receive a message that the --hn switch is required, you must use the switch.


Starts the GWIA with a user interface similar to that provided for the Windows GWIA. By default, no user interface is provided for the GWIA on Linux. The --show startup switch can only be used on the command line; it cannot be placed in the 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 GWIA to run as a non-root user.

/opt/novell/groupwise/agents/bin/gwia --home /gwsystem/provo1/wpgate/gwia

Starts the GWIA by specifying its gateway directory in the domain.

/opt/novell/groupwise/agents/bin/gwia @gwia.cfg

Starts the GWIA by specifying its startup file.

/opt/novell/groupwise/agents/bin/gwia --show @gwia.cfg

Runs the GWIA with a user interface.


If you have used the --show startup switch, error messages are displayed in the Log Message box of the GWIA server console where it is running. By default, error messages are also written to the GWIA log file located in the /var/log/novell/groupwise/domain_name.gwia directory.

Log files are named according to the date they are created. If the GWIA restarts during the day, the file extension indicates which session is logged (for example 0518gwia.003 indicates the third session logged for May 18).

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