52.1 How to Use Startup Switches

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

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 52.2, Alphabetical List of Switches indicates which settings are available in ConsoleOne and which settings are not.

52.1.1 Changing Internet Agent Settings in ConsoleOne

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

52.1.2 Modifying the gwia.cfg File

If you need to change the Internet Agent’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 Internet Agent 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 Internet Agent depends on the Internet Agent’s platform:

NetWare:

The gwia.cfg file used by the NetWare® Internet Agent is located in the same directory as the agent (typically sys:\system). Do not edit the gwia.cfg file located in the domain\wpgate\gwia directory; if you do, the changes do not affect the Internet Agent.

Linux:

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

Windows:

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

52.1.3 Editing Guidelines

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

  • 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 Internet Agent ignores any line that begins with a comment character.

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

  • Switches used in the configuration file must begin with one of the following switch delimiters: / (forward slash) or - (hyphen). For example, you can use /sd or -sd. On Linux, you can use the Linux double-hyphen standard (for example, --sd).

  • You can use either a hyphen (-) or an equals sign (=) to separate a switch from its value. For example, you can use /sd-12 or /sd=12. If you use a hyphen rather than a forward slash as the switch delimiter, you must use an equal sign (for example, -sd=12). If you use the Linux double-hyphen standard, you must user a space (for example, --sd 12).

  • 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 Internet Agent program. If no other configuration file is specified on the command line (using the gwia @filename 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.