57.1 WebAccess Agent Startup Switches

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:

sys:\system

Linux:

/opt/novell/groupwise/agents/share/

Windows:

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

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

@filename

@filename

@filename

N/A

/cluster

N/A

N/A

N/A

/gwdvadisable

--gwdvadisable

/gwdvadisable

N/A

/help

--help

/help

N/A

/home

--home

/home

N/A

/http

--http

/http

N/A

/httppassword

--httppassword

/httppassword

GroupWise > Optional Gateway Settings > HTTP Password

/httpport

--httpport

/httpport

GroupWise > Network Address > HTTP Port

/httpuser

--httpuser

/httpuser

GroupWise > Optional Gateway Settings > HTTP User Name

/ip

--ip

/ip

GroupWise > Network Address

/log

--log

/log

GroupWise > Log Files > Log File Path

/logdays

--logdays

/logdays

GroupWise > Log Files > Max Log File Age

/logdiskon

--logdiskon

/logdiskon

N/A

/loglevel

--loglevel

/loglevel

GroupWise > Log Settings > Logging Level

/logmax

--logmax

/logmax

GroupWise > Log Settings > Max Log Disk Space

/maxusers

--maxusers

/maxusers

N/A

/password

N/A

N/A

N/A

/port

--port

/port

GroupWise > Network Address

N/A

--show

N/A

N/A

/threads

--threads

/threads

WebAccess > Settings > Maximum Threads

/user

N/A

N/A

N/A

/work

--work

/work

 

57.1.1 @filename

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:

  • @[vol:][\dir\]file
  • @\\svr\vol\dir\file
  • @[/dir/]file
  • @[drive:][\dir\]file
  • @\\svr\sharename\dir\file

Example:

  • load gwinter @webac80a.waa
  • load gwinter @sys:\agt\webac80a.waa
  • load gwinter @\\s2\sys\agt\webac80a.waa
  • ./gwinter @webac80a.waa
  • gwinter.exe @webac80a.waa
  • gwinter.exe @d:\agt\webac80a.waa
  • gwinter.exe @\\s2\c\agt\webac80a.waa

57.1.2 /cluster

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

57.1.3 /gwdvadisable

Disables the Document Viewer Agent for troubleshooting purposes.

NetWare WebAccess Agent

Linux WebAccess Agent

Windows WebAccess Agent

Syntax:

/gwdvadisable

--gwdvadisable

/gwdvadisable

57.1.4 /help

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

57.1.5 /home (Required)

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:

  • /home-[svr\][vol:]\dir
  • /home-\\svr\vol\dir
  • --home /dir
  • /home-[drive:]\dir
  • /home-\\svr\sharename\dir

Example:

  • /home-\provo1
  • /home-mail:\provo1
  • /home-server2\mail:\provo1
  • /home-\\server2\mail\provo1
  • --home /gwsystem/provo1
  • /home-\provo1
  • /home-m:\provo1
  • /home-\\server2\c\provo1

57.1.6 /http

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.

57.1.7 /httppassword

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

See also /http, /httpport, and /httpuser.

57.1.8 /httpport

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.

57.1.9 /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.

57.1.10 /ip

Specifies the IP address of the WebAccess Agent’s server.

NetWare WebAccess Agent

Linux WebAccess Agent

Windows WebAccess Agent

Syntax:

  • /ip-IP_address
  • /ip-”full_DNS_name
  • --ip IP_address
  • --ip ”full_DNS_name
  • /ip-IP_address
  • /ip-”full_DNS_name

Example:

  • /ip-172.16.5.18
  • /ip-”webacsvr.provo.novell.com”
  • --ip 172.16.5.18
  • --ip ”webacsvr.provo.novell.com”
  • /ip-172.16.5.18
  • /ip-”webacsvr.provo.novell.com”

57.1.11 /log

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:

  • /log-[svr\][vol:]\dir
  • /log-\\svr\vol\dir
  • --log /dir
  • /log-[drive:]\dir
  • /log-\\svr\sharename\dir

Example:

  • /log-\agt\log
  • /log-\\server2\mail:\agt\log
  • /log-\\server2\mail\agt\log
  • --log /gwsystem/logs
  • /log-\agt\log
  • /log-m:\agt\log
  • /log-\\server2\c\mail\agt\log

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

57.1.12 /logdays

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

57.1.13 /logdiskon

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

See also /log, /logdays, /loglevel, and /logmax

57.1.14 /loglevel

Specifies the level of information to write to the screen and to disk. There are three levels: Normal, Verbose, and Diagnostic. The default level is Normal. You can use Verbose to receive more information. You should use Diagnostic 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

57.1.15 /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

57.1.16 /maxusers

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

57.1.17 /password

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.

57.1.18 /port-number

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.

57.1.19 --show

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

57.1.20 /threads-number

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

57.1.21 /user

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.

57.1.22 /work

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:

  • /work-[svr\][vol:]\dir
  • /work-\\svr\vol\dir
  • --work /dir
  • /work-[drive:]\dir
  • /work-\\svr\sharename\dir

Example:

  • /work-\webwork
  • /work-mail:webwork
  • /work-server2\mail:\webwork
  • /work-\\server2\mail\webwork
  • --work /webwork
  • /work-\webwork
  • /work-m:\webwork
  • /work-\\server2\c\mail\webwork