gwia (1)


gwia - GroupWise Internet Agent


gwia [--show] --home /domain_folder/wpgate/gwia
gwia [--show] @/domain_folder/wpgate/gwia_folder/gwia.cfg
gwia [--show] --dhome /domain_folder/wpgate/smtp_folder
gwia [--show] --hn hostname


The Internet Agent (GWIA) converts GroupWise messages into SMTP format and transfers them to the Internet SMTP hosts where recipients are located. In reverse, it receives SMTP messages from Internet SMTP hosts and converts them into GroupWise format. The GWIA can also provide access for POP3 and IMAP4 clients to access GroupWise mailboxes.

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 /domain_folder/wpgate/gwia folder.


Usage Options:

--home /domain_folder/wpgate/gwia

Specifies the GWIA home folder (/domain_folder/wpgate/gwia), where the GWIA can find its databases, input/output queues, and configuration files. There is no default location. You must use this switch in order to start the GWIA.

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


Specifies the location of the GWIA configuration file (gwia.cfg). The gwia.cfg file is created in the /domain_folder/wpgate/gwia folder. The gwia.cfg file includes the --home switch.

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

--dhome /domain_folder/wpgate/SMTP_folder

Points to the SMTP service work area. This is normally the same as the GWIA folder (/domain_folder/wpgate/gwia).

--hn hostname

Specifies the hostname that is displayed when someone connects to your GWIA using a Telnet session. You should enter the hostname assigned to you by your Internet service provider.


Starts the GWIA 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 Administration 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.



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

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

Starts the GWIA by specifying its GWIA folder in the domain.

/opt/novell/groupwise/agents/bin/gwia @/gwsystem/provo1/wpgate/gwia/gwia.cfg

Starts the GWIA by specifying its startup file.

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

Starts the GWIA 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.


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

See Also