Changing Internet Agent Settings in ConsoleOne

We recommend that you modify the ConsoleOne setting rather than the gwia.cfg startup switch. If you do modify a gwia.cfg switch, you need to be aware that the switch not only overrides the corresponding ConsoleOne setting but also replaces it.

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 are reflected in ConsoleOne.

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 will not affect the Internet Agent.

• Linux: The guia.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.

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 - (dash). For example, you can use /sd or -sd.
• You can use either a dash (-) 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 dash rather than a forward slash as the switch delimiter, you must use an equal sign (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 /ll=normal), only the last instance of the switch will be used.
• The gwia.cfg configuration 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 will be 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 configuration file will not be read.