General Troubleshooting Strategies

The general troubleshooting strategies listed below can help with problems that have not been resolved by more specific troubleshooting strategies:


Getting the Most from Log Files

Policy and Distribution Services programs write log information to the following log files:

File Name Location Purpose

_RESnn.TXT
(where nn represents an incrementing number)

C:\TEMP

The Installation Wizard logs installation error messages to this file. Look up error messages found in this file in Installation Error Messages in the Installation guide.

DEFAULTLOG.TXT

ZENWORKS\PDS\TED

The TED agents log startup messages to this file. Look up error messages found in this file in Tiered Electronic Distribution Errors .

TED.LOG
(default name)

ZENWORKS\PDS\TED\DIST
and
ZENWORKS\PDS\TED\SUB
(default locations)

The Distributor Agent and the Subscriber Agent log error and status messages to these files. Look up error messages found in these files in Tiered Electronic Distribution Errors .

ZFSINIT.TXT
(default name)

ZENWORKS\PDS\SMANAGER
(default location)

The Policy/Package Agent logs startup messages to this file. Look up error messages found in this file in Policy/Package Agent Errors .

ZFSLOG.TXT

ZENWORKS\PDS\SMANAGER

After starting successfully, the Policy/Package Agent logs errors to this file. Look up error messages found in this file in Policy/Package Agent Errors .

ZFSLOG.DG

ZENWORKS\PDS\DB
(default location)

The Policy/Distribution database logs Distribution status. You can generate status reports as described in Reporting in Policy and Distribution Services in the Administration guide. You can also gather status information using the Remote Web Console as described in Monitoring the Distribution Process and Monitoring Specific Agents in Policy and Distribution Services in the Administration guide.

Getting the Most from the Remote Web Console

The Remote Web Console, available when you install and configure the ZfS Management role in Novell iManager as described in Installing Web-Based Management for Policy and Distribution Services in the Installation guide, provides some excellent troubleshooting tools that are not available in ConsoleOne®. The table below lists the troubleshooting tasks you can perform and how to use the Tiered Electronic Distribution view of the Remote Web Console to perform each task:

Troubleshooting Task Remote Web Console
Tab and Option

View the Distributor and Subscriber event logs, where critical and warning messages are displayed regardless of the messaging level at which the Distributor Agent and Subscriber Agent write to their log files. For assistance resolving event log error messages, see Tiered Electronic Distribution Errors .

Events > Distributor Event Log or Subscriber Event Log

Check the current status of a Distribution after it has arrived at an end node Subscriber

Distributions > Received Distributions

Check the current status of the various distribution threads started by the TED agents to perform their various functions

Configuration > Threads

Determine the route that a Distribution would take through the routing hierarchy from a Distributor or parent Subscriber to a subordinate Subscriber

Configuration > Route to Subscriber

Check the current status of the various distribution threads started by the TED agents to perform their various functions

Configuration > Threads