gwdva (1)


gwdva - GroupWise Document Viewer Agent


          gwdva [@/post_office_folder/post_office_name.dva]


The Document Viewer Agent (DVA) converts attached document files from a wide variety of formats into HTML format for indexing by the POA and for viewing in GroupWise WebAccess. You can run up to three DVAs to service conversion requests for a single instance of the POA. Each DVA must be installed on a different server.

The DVA consists of a master DVA process, and multiple worker DVA processes. The master DVA process communicates with the WebAccess Application and the POA to transfer documents back and forth for conversion. Each worker process converts a single document. Because some documents contain unexpected data, they cannot be successfully converted. Such a conversion failure terminates a worker process, but does not affect the stability of the master DVA process.

You can provide DVA startup switches on the command line or in a startup file. By default, the startup file is named after the post office and has a .dva extension. It is located in the /opt/novell/groupwise/agents/share folder.


Usage Options:

--home folder

Specifies the path to the DVA working folder. The default location is /var/opt/novell/groupwise/gwdva.


Specifies the location of the DVA startup file. The DVA startup file is created in the /opt/novell/groupwise/agents/share folder and is named after the post office, with a .dva extension.

For information about agent startup switches, see the GroupWise 18 Administration Guide.

Help Options:

--help , -?

Displays the help information and exits.



Startup file where startup switches are specified.


Log file where error messages are written.


This program must run as root.


Starts the DVA using its default configuration.

/opt/novell/groupwise/agents/bin/gwdva --home /var/opt/novell/groupwise/gwdva

Starts the DVA and specifies its working folder.

/opt/novell/groupwise/agents/bin/gwdva @gwdva.dva

Starts the DVA by specifying its startup file.


Error messages are written to the DVA log file located in the /var/log/novell/groupwise/gwdva folder. You can view agent log files in the agent console.

Typically, you find multiple log files in this folder. The first four characters of each file name represent the date. The next three 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 DVA log file created on May 18. If you restart the DVAA on the same day, a new log file is created, named 0518dva.002.

See Also