59.1 How to Use Startup Switches

The default location for the GWIA configuration file (gwia.cfg) file varies by platform.

Linux:

/opt/novell/groupwise/agents/share

Windows:

c:\Program Files\Novell\GroupWise Server\GWIA

The GWIA reads the gwia.cfg file at startup and restart. Only one switch is required in the gwia.cfg file. The ‑‑home switch points to the GWIA's gateway directory. This is always a subdirectory of wpgate in the domain directory structure.

NOTE:A boilerplate version of the gwia.cfg file is stored in the domain/wpgate directory, but the GWIA does not read it. Do not edit the switches in the gwia.cfg file in the domain/wpgate directory.

When you update the GWIA software, the existing gwia.cfg file can be retained or overwritten as needed.

Linux:

When you use both the Install and Configure options in the Internet Agent Installation program, the existing gwia.cfg file is backed up and then overwritten. When you use only the Install option, the existing gwia.cfg file is retained.

Windows:

When you select Install the software files, but do not configure the Internet Agent in the Internet Agent Installation program, the existing gwia.cfg file is retained. When you do not select this option, the existing gwia.cfg file is backed up and then overwritten.

You can use the gwia.cfg file to override primary configuration settings that are stored in the domain database (wpdomain.db) and modified in ConsoleOne. You can also use the gwia.cfg file to set secondary configuration settings that are not available in ConsoleOne. Section 59.2, Alphabetical List of Switches indicates which settings are available in ConsoleOne and which settings are not. You can view the GWIA startup file from the Configuration page of the GWIA Web console.

59.1.1 Changing GWIA Settings in ConsoleOne

We recommend that you modify configuration settings in ConsoleOne rather than using corresponding switches in the gwia.cfg file.

59.1.2 Modifying the gwia.cfg File

If you need to change the GWIA’s configuration and do not have access to ConsoleOne, you can manually edit the gwia.cfg file. Any changes you make to the gwia.cfg file override the primary settings in ConsoleOne so that the GWIA starts using the new settings. However, the primary settings are not changed in the domain database as a result of editing the gwia.cfg file. In order to specify secondary configuration settings that are not available in ConsoleOne, you must edit the gwia.cfg file.

The location of the gwia.cfg file used by the GWIA depends on the GWIA’s platform:

Linux:

The gwia.cfg file used by the Linux GWIA is located in the /opt/novell/groupwise/agents/share directory.

Windows:

The gwia.cfg file used by the Windows GWIA is located in the domain\wpgate\gwia directory. Do not edit the gwia.cfg file located in the same directory as the GWIA program. This gwia.cfg file is only used to redirect the GWIA to the gwia.cfg file in the domain\wpgate\gwia directory.

59.1.3 Editing Guidelines

If you decide to manually edit the gwia.cfg file, keep the following guidelines in mind:

  • Archive a copy of the file in case you need to return to the original switch settings.

  • Use a text editor to edit the file.

  • The comment characters include the semicolon (;), pound sign (#), and asterisk (*), and are used to disable a switch or to add comments. The GWIA ignores any line that begins with a comment character.

  • Changes made to the configuration file do not take effect until you restart the GWIA.

  • On Linux, use a space to separate a switch from its value. On Windows, you can use a hyphen (-) or an equals sign (=) to separate a switch from its value. The equals sign is especially useful when the value includes a hyphen.

  • None of the switches or switch values are case sensitive. For example, ‑‑sd 12 is the same as ‑‑SD 12.

  • If a switch is specified more than once in the configuration file or on the command line, and if it has a value (such as ‑‑loglevel normal), only the last instance of the switch is used.

  • The gwia.cfg file is used by default. However, you can also specify another configuration file or use startup switches on the command line when starting the GWIA program. If no other configuration file is specified on the command line (using the gwia @file_name syntax), the default gwia.cfg configuration file is read and processed before, and in addition to, any command line switches.

  • If a configuration file other than gwia.cfg is specified on the command line, the default gwia.cfg file is not read.