59.5 Environment Switches

The following switches configure GWIA environment settings such as working directories, clustering support, and SNMP support.

59.5.1 --cluster

Informs the GWIA that it is running in a cluster. A clustered GWIA automatically binds to the IP address configured for the GWIA object even if the Bind Exclusively to TCP/IP Address option is not selected on the GWIA Network Address page in ConsoleOne. This prevents unintended connections to other IP addresses, such as the loopback address or the node’s physical IP address. For information about clustering the GWIA, see the GroupWise 2012 Interoperability Guide.

Syntax: --cluster

59.5.2 --ip

Binds the GWIA to the specified IP address so that, on a server with multiple IP addresses, the GWIA uses only the specified IP address.

Syntax: --ip address

Example: --ip 172.16.5.18

59.5.3 --ipa

Specifies the IP address (or hostname) of a GroupWise POA that the GWIA can use to resolve IP addresses of other POAs in the system. This replaces the need to configure post office links for the GWIA in ConsoleOne (GWIA object > Post Office Links > Settings).

If you have established a GroupWise name server (ngwnameserver), you can use it. See Section 36.2.2, Simplifying Client/Server Access with a GroupWise Name Server.

Syntax: --ipa address

Example: --ipa ngwnameserver

59.5.4 --ipp

Specifies the port number of a GroupWise POA that the GWIA can use to resolve IP addresses of other POAs in the system. This replaces the need to configure post office links for the GWIA in ConsoleOne (GWIA object > Post Office Links > Settings).

If you have established a GroupWise name server (ngwnameserver), you can use it. See Section 36.2.2, Simplifying Client/Server Access with a GroupWise Name Server.

Syntax: --ipp port_number

Example: --ipp 678

59.5.5 --nosnmp

Disables SNMP for the GWIA. The default is to have SNMP enabled. See Section 37.6, Using an SNMP Management Console.

Syntax: --nosnmp

59.5.6 --smtphome

Specifies a secondary SMTP queues directory for inbound and outbound messages. This secondary directory can be helpful for troubleshooting by providing a way to trap messages before they are routed to the Internet. You can also use the secondary directory to run third-party utilities such as a virus scanner on Internet-bound messages. See Section 57.1, Relocating the GWIA’s Processing Directories.

The GWIA places all outbound messages in this secondary directory. The messages must then be moved manually (or by another application) to the primary SMTP queue’s send directory (‑‑dhome switch) before the GWIA routes them to the Internet.

Syntax: --smtphome path

Example: --smtphome mail:\provo1\wpgate\gwia\smtp2

59.5.7 --work

Sets the directory where the GWIA stores its temporary files. On Linux, the work directory is located in the domain by default. On Windows, it is not.

Syntax: --work path_name

Linux Example: --work /opt/novell/groupwise/tmp

Windows Example: /work -j:\tmp\work

59.5.8 --nasoq

By default, the GWIA sends the accounting file (acct) to users specified as accountants in ConsoleOne (GWIA object > GroupWise > Gateway Administrators). The file is sent daily at midnight and any time the GWIA shuts down.

This switch instructs the GWIA to send the acct file once daily at midnight, not each time the GWIA quits or is shut down.

Syntax: --nasoq