gwia (1)

Name

gwia - GroupWise Internet Agent

Syntax

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

Description

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

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

Options

Usage Options:

--home gateway_directory

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

@startup_file

Specifies the location of the Internet Agent startup file, which is gwia.cfg by default. The Internet Agent looks for gwia.cfg in the /opt/novell/groupwise/agents/share directory.

--dhome SMTP_directory

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

--hn hostname

Provides the hostname that is displayed when someone connects to your Internet Agent via a Telnet session. You should enter the hostname assigned to you by your Internet service provider. Normally, the Internet Agent 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.

--show

Starts the Internet Agent with a user interface similar to that provided for the NetWare and Windows Internet Agent. By default, no user interface is provided for the Internet Agent 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.

Files

/opt/novell/groupwise/agents/share/gwia.cfg

Startup file where startup switches are specified.

/var/log/novell/groupwise/domain_name.gwia/mmddgwia.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 Internet Agent to run as a non-root user.

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

Start the Internet Agent by specifying its gateway directory in the domain.

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

Start the Internet Agent by specifying its startup file.

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

Run the Internet Agent with a user interface.

Diagnostics

If you have used the --show startup switch, error messages are displayed in the Log Message box of the Internet Agent server console where it is running. By default, error messages are also written to the Internet Agent 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 Internet Agent 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 Internet Agent error messages, see Troubleshooting 1: Error Messages.

Authors

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

See Also

grpwise (1).

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