The Viewer Agent is configured by editing its startup file (gwdva.dva). The default location for the startup files varies by platform.
The table below summarizes Document Viewer 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 Viewer Agent |
Linux Viewer Agent |
Windows Viewer 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 |
|||
|
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 |
Runs each Document Viewer Agent worker thread in its own namespace. Specify the base name for the series of address space names that are created for the worker threads. The default base name is GWDVAWRKR, which results in address spaces named GWDVAWRKR1, GWDVAWRKR2, and so on.
|
NetWare Viewer Agent |
Linux Viewer Agent |
Windows Viewer Agent |
|---|---|---|---|
|
Syntax: |
/addrspacename-address_space_name |
N/A |
N/A |
|
Example: |
/addrspacename-GWDVA |
N/A |
N/A |
See also /minworkers and /maxworkers.
Enables the documentation caching capability of the Viewer Agent. See Section 54.8.4, Document Cache
See also /maxcache, /maxtrancache, /maxtrantime, and /maxprobtime.
Specifies the mail domain name for the Viewer Agent to use when sending e-mail notifications about quarantined documents. The Viewer Agent sends the notifications as gwdva@domain_name.This is necessary when you have configured the Viewer Agent to notify an administrator whenever a document is quarantined. See Section 54.8.3, Document Quarantine.
Provides the e-mail address of a user that the Viewer Agent should notify when it places a document in quarantine. See Section 54.8.3, Document Quarantine.
Enables the document quarantine feature of the Viewer Agent, which is disabled by default. See Section 54.8.3, Document Quarantine
Enables the Viewer Agent Web console. See Enabling the Document Viewer Agent Web Console.
Sets the HTTP port number used for the Viewer Agent to communicate with the WebAccess Agent. The default is 7439; the setting must be unique. See Enabling the Document Viewer Agent Web Console.
Specifies the password for the Viewer Agent to prompt for before allowing Viewer Agent status information to be displayed in your Web browser. Do not use an existing eDirectory password because the information passes over the non-secure connection between your Web browser and the Viewer Agent. See Enabling the Document Viewer Agent Web Console.
Specifies the username for the Viewer Agent to prompt for before allowing Viewer Agent status information to be displayed in a Web browser. Providing a username is optional. Do not use an existing eDirectory username because the information passes over the insecure connection between your Web browser and the Viewer Agent. See Enabling the Document Viewer Agent Web Console.
Specifies the IP address that the Viewer Agent listens on for client/server requests from the WebAccess Agent. The default is the first IP address that the Viewer Agent finds on the server. See Section 54.8.7, Client/Server Configuration.
|
NetWare Viewer Agent |
Linux Viewer Agent |
Windows Viewer Agent |
|---|---|---|---|
|
Syntax: |
/ip-IP_address |
--ip IP_address |
/ip-IP_address |
|
Example: |
/ip-172.16.5.18 |
--ip 172.16.5.18 |
/ip-172.16.5.18 |
See also /port.
Specifies the ISO language code that the Viewer Agent should use if it cannot determine the language of a document that needs conversion. The default is en for English.
Sets the directory where the Viewer Agent stores its log files. The default location varies by platform.
|
NetWare: |
sys:\system\gwdva.dir\log |
|
Linux: |
/var/log/novell/groupwise/gwdva |
|
Windows: |
c:\webacc\gwdva.dir\log |
For more information, see Section 56.4.3, Controlling Document Viewer Agent Logging.
Typically you find multiple log files in the specified directory. The first 4 characters represent the date. The next 3 characters identify the agent. A three-digit extension allows for multiple log files created on the same day. For example, a log file named 0518dva.001 indicates that it is a Viewer Agent log file, created on May 18. If you restart the Viewer Agent by restarting the WebAccess Agent on the same day, a new log file is created, named 0518dva.002.
Specifies how many days to keep Viewer Agent log files on disk. The default is 7 days. See Section 56.4.3, Controlling Document Viewer Agent Logging.
Controls the amount of information logged by the Viewer Agent. Valid settings are Normal, Verbose, Diagnostic, and Off. The default is Normal, which writes only the essential information suitable for a smoothly running Viewer Agent. Use Verbose to save the essential information, plus additional information helpful for troubleshooting. Verbose logging does not degrade Viewer Agent performance, but log files saved to disk consume more disk space when verbose logging is in use. See Section 56.4.3, Controlling Document Viewer Agent Logging.
Sets the maximum amount of disk space for all Viewer Agent log files. When the specified disk space is consumed, the Viewer Agent deletes existing log files, starting with the oldest. The default is 65536 KB. See Section 56.4.3, Controlling Document Viewer Agent Logging.
Specifies in megabytes the maximum amount of disk space that the library cache can occupy. The default is 100. To clear out the contents of the library cache, set /maxcache to 0 (zero); this also disables the library cache in the future. See Section 54.8.4, Document Cache.
|
NetWare Viewer Agent |
Linux Viewer Agent |
Windows Viewer Agent |
|---|---|---|---|
|
Syntax: |
/maxcache-megabytes |
--maxcache megabytes |
/maxcache-megabytes |
|
Example: |
/maxcache-150 |
--maxcache 200 |
/maxcache-300 |
See also /cache, /maxtrancache, /maxtrantime, and /maxprobtime.
Specifies in megabytes the maximum amount of disk space that the document quarantine can occupy. The default is 100. To clear out the contents of the quarantine, set /maxhold to 0 (zero); this also disables the quarantine in the future. See Section 54.8.3, Document Quarantine.
Specifies in days the maximum amount of time a document that cannot be converted remains on the list of problem documents. The default is 5. Section 54.8.4, Document Cache.
|
NetWare Viewer Agent |
Linux Viewer Agent |
Windows Viewer Agent |
|---|---|---|---|
|
Syntax: |
/maxprobtime-days |
--maxprobtime days |
/maxprobtime-days |
|
Example: |
/maxprobtime-3 |
--maxprobtime 7 |
/maxprobtime-10 |
See also /cache, /maxcache, /maxtrancache, and /maxtrantime.
Specifies in kilobytes the maximum size to which a file can grow during the conversion process. The default is 1024. Section 54.8.5, Agent Performance.
|
NetWare Viewer Agent |
Linux Viewer Agent |
Windows Viewer Agent |
|---|---|---|---|
|
Syntax: |
/maxsize-kilobytes |
--maxsize kilobytes |
/maxsize-kilobytes |
|
Example: |
/maxsize-2048 |
--maxsize 4096 |
/maxsize-3072 |
See also /maxtime.
Specifies in seconds the maximum amount of time a worker thread can work on a converting a single document. The default is 120 (2 minutes). Section 54.8.5, Agent Performance.
|
NetWare Viewer Agent |
Linux Viewer Agent |
Windows Viewer Agent |
|---|---|---|---|
|
Syntax: |
/maxtime-seconds |
--maxtime seconds |
/maxtime-seconds |
|
Example: |
/maxtime-240 |
--maxtime 360 |
/maxtime-60 |
See also /maxsize.
Specifies in megabytes the maximum amount of disk space that the transient cache can occupy. The default is 20. To clear out the contents of the transient cache, set /maxtrancache to 0 (zero); this also disables the transient cache in the future. See Section 54.8.4, Document Cache.
See also /cache, /maxcache, /maxtrantime, and /maxprobtime.
Specifies in days the maximum amount of time a document remains in the transient cache. The default is 1. Section 54.8.4, Document Cache.
|
NetWare Viewer Agent |
Linux Viewer Agent |
Windows Viewer Agent |
|---|---|---|---|
|
Syntax: |
/maxtrantime-days |
--maxtrantime days |
/maxtrantime-days |
|
Example: |
/maxtrantime-2 |
--maxtrantime 3 |
/maxtrantime-5 |
See also /cache, /maxcache, /maxtrancache, and /maxprobtime.
Specifies the maximum number of worker threads that the Viewer Agent starts. The default is 15. The maximum number of threads is limited only by available memory resources on the server. Section 54.8.5, Agent Performance.
|
NetWare Viewer Agent |
Linux Viewer Agent |
Windows Viewer Agent |
|---|---|---|---|
|
Syntax: |
/maxworkers-number |
--maxworkers number |
/maxworkers-number |
|
Example: |
/maxworkers-20 |
--maxworkers 40 |
/maxworkers-60 |
See also /minworkers.
Specifies the minimum number of worker threads that the Viewer Agent starts. The default is 5. The maximum number of threads is limited only by available memory resources on the server. See Section 54.8.5, Agent Performance.
|
NetWare Viewer Agent |
Linux Viewer Agent |
Windows Viewer Agent |
|---|---|---|---|
|
Syntax: |
/minworkers-number |
--minworkers number |
/minworkers-number |
|
Example: |
/minworkers-10 |
--minworkers 20 |
/minworkers-30 |
See also /maxworkers.
Specifies the port number where the Viewer Agent listens for client/server requests from the WebAccess Agent. The default is 7440. Worker threads are assigned ascending port numbers from the primary port number. For example, the first 5 worker threads would be assigned ports 7441 through 7445. See Section 54.8.7, Client/Server Configuration.
|
NetWare Viewer Agent |
Linux Viewer Agent |
Windows Viewer Agent |
|---|---|---|---|
|
Syntax: |
/port-port_number |
--port port_number |
/port-port_number |
|
Example: |
/port-7450 |
--port 7460 |
/port-7470 |
See also /ip.
Specifies the IP address of a relay host if your system includes one. This is necessary if you have configured the Viewer Agent to notify an administrator whenever a document is quarantined. See Section 54.8.3, Document Quarantine.
Sets the path to the directory where the Viewer Agent creates its temporary files. The default varies by platform. See Section 54.8.2, Document Conversion.
|
NetWare: |
sys:\system\gwdva.dir\temp |
|
Linux: |
/opt/novell/groupwise/agents/bin/gwdva.dir/temp |
|
Windows: |
c:\webacc\gwdva.dir\temp |