You can use the switches listed below when starting the GroupWise WebAccess Agent. The switches override any configuration settings you specified through ConsoleOne.
During installation of the WebAccess Agent, the Installation program creates a default startup file, agent_name.waa, where agent_name is the name assigned to the WebAccess Agent (for example, webac80a.waa). The location of the startup file varies by platform.
NetWare: |
|
Linux: |
|
Windows: |
The table below summarizes WebAccess Agent startup switches for all platforms and how they correspond to configuration settings in ConsoleOne.
Switch starts with: a b c d e f g h i j k l m n o p q r s t u v w x y z
NetWare WebAccess Agent |
Linux WebAccess Agent |
Windows WebAccess Agent |
ConsoleOne Settings |
---|---|---|---|
N/A |
|||
N/A |
N/A |
N/A |
|
N/A |
|||
N/A |
|||
N/A |
|||
N/A |
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
N/A |
|||
|
|||
|
|||
N/A |
|||
N/A |
N/A |
N/A |
|
|
|||
N/A |
N/A |
N/A |
|
s |
|||
N/A |
N/A |
N/A |
|
|
Specifies a startup file to use. You can add any of the WebAccess Agent startup switches to the startup file and then reference the file when starting the WebAccess Agent. For example:
NetWare: |
load sys:system\gwinter @webac80a.waa |
Linux: |
/opt/novell/groupwise/agents/bin/gwinter @webac80a.waa |
Windows: |
c:\Program Files\Novell\GroupWise Server\WebAccess\gwinter.exe @webac80a.waa |
During installation of the WebAccess Agent, the Installation program creates a default startup file, agent_name.waa, where agent_name is the name assigned to the WebAccess Agent object (for example, webac80a.waa). The default startup file is created in the following platform-specific locations:
NetWare: |
sys:\system |
Linux: |
/opt/novell/groupwise/agents/share |
Windows: |
c:\Program Files\Novell\GroupWise Server\WebAccess |
The startup file is referenced from the batch files or scripts so that you do not need to specify the startup file when you start the WebAccess Agent.
NetWare: |
strtweb.ncf |
Linux: |
grpwise |
Windows: |
strtweb.bat |
NetWare WebAccess Agent |
Linux WebAccess Agent |
Windows WebAccess Agent |
|
---|---|---|---|
Syntax: |
|
|
|
Example: |
|
|
|
Enables the WebAccess Agent to run in a clustered environment (using Novell Cluster Services). See Implementing WebAccess in a NetWare Cluster
in Novell Cluster Services on NetWare
in the GroupWise 8 Interoperability Guide.
If you are running the NetWare WebAccess Agent on the latest version of NetWare 6.5/OES NetWare and Novell Cluster Services, the WebAccess Agent can detect the cluster automatically.
NetWare WebAccess Agent |
Linux WebAccess Agent |
Windows WebAccess Agent |
|
---|---|---|---|
Syntax: |
/cluster |
N/A |
N/A |
Disables the Document Viewer Agent for troubleshooting purposes.
NetWare WebAccess Agent |
Linux WebAccess Agent |
Windows WebAccess Agent |
|
---|---|---|---|
Syntax: |
/gwdvadisable |
--gwdvadisable |
/gwdvadisable |
Displays a listing and description of the startup switches. When this switch is used, the WebAccess Agent does not start.
NetWare WebAccess Agent |
Linux WebAccess Agent |
Windows WebAccess Agent |
|
---|---|---|---|
Syntax: |
/help or /? |
--help |
/help or /? |
Example: |
load gwinter /help |
./gwinter --help |
gwinter.exe /help |
Specifies the path to the WebAccess Agent’s gateway directory under the domain directory. If you use the default WebAccess Agent gateway directory name, the path is x:\domain\wpgate\webac80a. This switch is required.
NetWare WebAccess Agent |
Linux WebAccess Agent |
Windows WebAccess Agent |
|
---|---|---|---|
Syntax: |
|
|
|
Example: |
|
|
|
If the WebAccess Agent’s Web console is disabled in ConsoleOne, this switch enables the Web console. See Enabling the WebAccess Agent Web Console.
NetWare WebAccess |
Linux WebAccess |
Windows WebAccess |
|
---|---|---|---|
Syntax: |
/http |
--http |
/http |
See also /httppassword, /httpport, and /httpuser.
Specifies the password that must be entered when logging in to the WebAccess Agent’s Web console. See Enabling the WebAccess Agent Web Console.
NetWare WebAccess Agent |
Linux WebAccess Agent |
Windows WebAccess Agent |
|
---|---|---|---|
Syntax: |
/httppassword-unique_password |
--httppassword unique_password |
/httppassword-unique_password |
Example: |
/httppassword-AgentWatch |
--httppassword AgentWatch |
/httppassword-AgentWatch |
Sets the HTTP port number used for the WebAccess Agent to communicate with your Web browser. The default is 7211; the setting must be unique. See Using the WebAccess Agent Web Console.
NetWare WebAccess Agent |
Linux WebAccess Agent |
Windows WebAccess Agent |
|
---|---|---|---|
Syntax: |
/httpport-port_number |
--httpport port_number |
/httpport-port_number |
Example: |
/httpport-7212 |
--httpport 7213 |
/httpport-7214 |
See also /http, /httppassword, and /httpuser.
Specifies the username that must be entered when logging in to the WebAccess Agent’s Web console. See Enabling the WebAccess Agent Web Console.
NetWare WebAccess Agent |
Linux WebAccess Agent |
Windows WebAccess Agent |
|
---|---|---|---|
Syntax: |
/httpuser-unique_name |
--httprefresh unique_name |
/httprefresh-unique_name |
Example: |
/httpuser-GWWebCon |
--httpuser GWWebCon |
/httpuser-GWWebCon |
See also /http, /httpport, and /httppassword.
Specifies the IP address of the WebAccess Agent’s server.
NetWare WebAccess Agent |
Linux WebAccess Agent |
Windows WebAccess Agent |
|
---|---|---|---|
Syntax: |
|
|
|
Example: |
|
|
|
Specifies the path to the log file directory. The default location varies by platform.
NetWare and Windows: |
domain\wpgate\webac80a\000.prc |
Linux: |
/var/log/novell/groupwise/domain.gateway/000.prc |
For more information about the WebAccess Agent’s logging, see Section 56.4.1, Controlling WebAccess Agent Logging.
NetWare WebAccess Agent |
Linux WebAccess Agent |
Windows WebAccess Agent |
|
---|---|---|---|
Syntax: |
|
|
|
Example: |
|
|
|
Log files are named mmdd.nnn, where mm is the month, dd is the day, and nnn is a sequenced number starting with 001. For example, the first log file used on March 28 is named 0328.001, and the second log file used is named 0328.002.
See also /logdays, /logdiskon, /loglevel, and /logmax
Specifies the maximum number of days to keep log files. This setting works in combination with the /logmax setting. Log files are deleted when the maximum number of days or disk space size is reached, whichever comes first. The default is 30 days.
For more information about the WebAccess Agent’s logging, see Section 56.4.1, Controlling WebAccess Agent Logging.
NetWare WebAccess Agent |
Linux WebAccess Agent |
Windows WebAccess Agent |
|
---|---|---|---|
Syntax: |
/logdays-days |
--logdays days |
/logdays-days |
Example: |
/logdays-15 |
--logdays 45 |
/logdays-60 |
See also /log, /logdiskon, /loglevel, and /logmax
Turns disk logging on. By default, the log file is not written to disk on NetWare and Windows. On Linux, the log file is written to disk by default.
For more information about the WebAccess Agent’s logging, see Section 56.4.1, Controlling WebAccess Agent Logging.
NetWare WebAccess Agent |
Linux WebAccess Agent |
Windows WebAccess Agent |
|
---|---|---|---|
Syntax: |
/logdiskon |
--logdiskon |
/logdiskon |
Specifies the level of information to write to the screen and to disk. There are three levels:
, , and . The default level is . You can use to receive more information. You should use only if you are having problems with the WebAccess Agent. The verbose and diagnostic logging levels do not degrade Internet Agent performance, but log files saved to disk consume more disk space when verbose or diagnostic logging is in use.For more information about the logging levels, see Section 56.4.1, Controlling WebAccess Agent Logging.
NetWare WebAccess Agent |
Linux WebAccess Agent |
Windows WebAccess Agent |
|
---|---|---|---|
Syntax: |
/loglevel-level |
--loglevel level |
/loglevel-level |
Example: |
/loglevel-verbose |
--loglevel verbose |
/loglevel-verbose |
See also /log, /logdays, /logdiskon, and /logmax
Specifies the maximum disk space to use for logging. This setting works in combination with the /logdays setting. Log files are deleted when the maximum disk space or number of days is reached, whichever comes first. The default is 102400 KB (100 MB). The maximum allowable setting is 102400000 (1 GB).
For more information about the WebAccess Agent’s logging, see Section 56.4.1, Controlling WebAccess Agent Logging.
NetWare WebAccess Agent |
Linux WebAccess Agent |
Windows WebAccess Agent |
|
---|---|---|---|
Syntax: |
/logmax-kilobytes |
--logmax kilobytes |
/logmax-kilobytes |
Example: |
/logmax-32000 |
--logmax 130000 |
/logmax-16000 |
See also /log, /logdays, /logdiskon, and /loglevel
Specifies the maximum number of users that the WebAccess Agent allows to log in at one time. The default is 250.
NetWare WebAccess Agent |
Linux WebAccess Agent |
Windows WebAccess Agent |
|
---|---|---|---|
Syntax: |
/maxusers-number_of_users |
--maxusers number_of_users |
/maxusers-number_of_users |
Example: |
/maxusers-300 |
--maxusers 400 |
/maxusers-500 |
Used by the NetWare WebAccess Agent only. Specifies the Novell eDirectory password to use to access the network servers where the GroupWise domain directory and post office directories reside.
NetWare WebAccess Agent |
Linux WebAccess Agent |
Windows WebAccess Agent |
|
---|---|---|---|
Syntax: |
/password-NetWare_password |
N/A |
N/A |
Example: |
/password-GWise |
N/A |
N/A |
See also /user.
Specifies the port number the WebAccess Agent listens to. The default is 7205. See Section 54.1.5, Changing the WebAccess Agent’s Network Address or Port Numbers.
NetWare WebAccess Agent |
Linux WebAccess Agent |
Windows WebAccess Agent |
|
---|---|---|---|
Syntax: |
/port-port_number |
--port port_number |
/port-port_number |
Example: |
/port-1678 |
--port 1679 |
/port-1680 |
See also /ip.
Used by the Linux WebAccess Agent only. Running the WebAccess Agent with this option disabled (the default) causes the WebAccess Agent to run as a daemon without a user interface. Enabling this option causes the logging UI to appear in a terminal window.
NetWare WebAccess Agent |
Linux WebAccess Agent |
Windows WebAccess Agent |
|
---|---|---|---|
Syntax: |
N/A |
--show |
N/A |
Specifies the number of threads the WebAccess Agent uses to process user requests. The default is 12, which means the WebAccess Agent can process 12 user requests at one time. For more information, see Section 54.1, Configuring the WebAccess Agent.
NetWare WebAccess Agent |
Linux WebAccess Agent |
Windows WebAccess Agent |
|
---|---|---|---|
Syntax: |
/threads-number |
--threads number |
/threads-number |
Example: |
/threads-15 |
--threads 20 |
/threads-30 |
Used by the NetWare WebAccess Agent only. Specifies the eDirectory username to use to access the network servers where the GroupWise domain directory and post office directories reside. Must be used with /password.
NetWare WebAccess Agent |
Linux WebAccess Agent |
Windows WebAccess Agent |
|
---|---|---|---|
Syntax: |
/user-NetWare_user_ID |
N/A |
N/A |
Example: |
/user-GWAgents |
N/A |
N/A |
See also /password.
Specifies the path to the WebAccess Agent’s work directory. By default, the work directory is the same as the WebAccess Agent’s gateway directory (x:\domain\wpgate\webac80a).
NetWare WebAccess Agent |
Linux WebAccess Agent |
Windows WebAccess Agent |
|
---|---|---|---|
Syntax: |
|
|
|
Example: |
|
|
|