56.3 Monitoring the Document Viewer Agent

Like the WebAccess Agent, the Document Viewer Agent has a server console and a Web console

56.3.1 Using the Document Viewer Agent Server Console

The Document Viewer Agent server console functions just like the WebAccess Agent server console. For more information, see Section 56.1.1, Using the WebAccess Agent Server Console.

56.3.2 Using the Document Viewer Agent Web Console

Like the WebAccess Agent, the Document Viewer Agent also has a Web console.

Enabling the Document Viewer Agent Web Console

Because the Document Viewer Agent is currently configured using switches in its startup file, you must activate the switches that pertain to its Web console.

  1. Use an ASCII text editor to edit the Document Viewer Agent startup file (gwdva.dva).

    The default location of the startup file depends on the platform where the Document Viewer Agent is running:

  2. Scroll down to the HTTP monitoring section.

  3. Remove the comment character (;) from the /http startup switch to enable HTTP for the Document Viewer Agent.

  4. If the default HTTP port of 7439 is already in use on the server, remove the comment marker from the /httpport switch and provide a unique port number.

  5. If you want to secure the Document Viewer Agent Web console by requiring a username and password to access it, remove the comment characters from the /httpuser and /httppw switches, then provide a username and password.

  6. Save the gwdva.dva file, then exit the text editor.

  7. Restart the WebAccess Agent to put the new settings into effect.

Each time you update the WebAccess software, the existing gwdva.dva file is backed up as gwdva.nnn. Therefore, after updating the WebAccess software, you need to rename the modified gwdva.nnn file back to gwdva.dva or repeat the editing changes in the updated gwdva.dva file.

Viewing the Document Viewer Agent Web Console

  1. In a Web browser, enter the following URL:

    http://server_address:port_number

    where server_address is the Web server’s IP address or DNS hostname and port_number is 7439 or whatever port number you have specified in the Viewer Agent startup file.

  2. If you provided a username and password in the startup file, enter the username and password when prompted.

    The Web console is displayed.

    Document Viewer Agent Web console

Through the Web console you can view the following information:

  • Status: Displays how long the Document Viewer Agent has been up, the number of worker threads it has started, the current server utilization, and statistics about the files the worker threads have processed.

  • Configuration: Displays the current settings of all the options that you can set in the Viewer Agent startup file (gwdva.dva). For more information, see Section 54.7, Configuring the Document Viewer Agent.

  • Environment: Displays server information such as name, operating system date, memory, processor utilization, and loaded modules.

  • Log Files: Lets you view the contents of the Viewer Agent’s log files and the current log settings. For more information, see Section 56.4.3, Controlling Document Viewer Agent Logging.

  • Problem Files: Indicates whether a list of problem files is being generated, and if so, what files have failed the conversion process. For more information, see Section 54.7.4, Document Cache.

  • Quarantine Files: Indicates whether the document quarantine is enabled, and if so, what files have been quarantined. For more information, see Section 54.7.3, Document Quarantine

For detailed information about each field on the Status, Configuration, Environment, Log Files, Problem Files, or Quarantine Files page, select the page, then click Help.

You cannot use the Web console to change any of the Viewer Agent’s settings. Changes must be made through the Viewer Agent startup file.