You are here: System administration > Checking on production tasks that are running as services

Checking on production tasks that are running as services

FYI, the Checklist for Support Issues document refers to this topic by name. So don't change or delete it without fixing that doc.

Checking the service logs

This section assumes that Log to file is selected (as it is by default) in the Logging settings of the Logging policy dialog. If that was changed to Log to Windows event log, use Windows Event Viewer to view logged information.

Production service events are logged to the ClosedReadSoft DOCUMENTS Production service log (ServicesLog.html). The location of this file is specified in Logging policy dialog.

DOCUMENTS logs service events, including start and stop time, methods, and process IDs. Click theLoglinkin thecolumn to view a detailed description of each event.

Check the Service log overview file (ServicesLog.html) daily, in case of problems. Also check it if you see indications of problems in Supervision (locked objects) or in Production (batches and documents not being processed through the system). This is a good starting point for checking if the service and production tasks are running properly, or when tracing errors and problems. It will pinpoint any log files for a production task that reported specific errors.

The Service log overview file is created daily and updated continuously. It contains information about all the production tasks that run as services (time started, stopped and errors).

You can see if a service stopped running as intended if for every Start row, there is an End row with the same PID. If the End row is missing, the service stopped unexpectedly.

There will be several occurrences of the same PID if:

However, for each production task and PID there should be a matching pair of Start and End rows. Otherwise, the service did not run correctly.

The location of the application log from the Production module, the services log overview file (ServicesLog.html), and the license log file depends on the operating system. The Logging settings of the Logging policy dialog tells you the location.
 

Checking for locked objects

  1. Use the Document searches dialog to find any objects that are locked by the service user.

  2. Follow these instructions, using the Locked by filter. Specify the name of the service user in the filter.

  3. Sort the hits by Lock time and look for objects that have been locked for a long time.

  4. Sort the results by Type in order to look at all batches.

  5. Check to see whether the user or production task that locked the batch is still active. If not, unlock the batch.

Configuring the ReadSoft Production service

Production as a service: Overview

Troubleshooting Windows services