skip to main content
Troubleshooting the OpenAccess SDK Server : Debug Log Files : Service Debug Log Files
 

Service Debug Log Files

The OpenAccess SDK service debug log files contain information about processing that occurs outside the context of a client session. This pair of files includes a service debug file and an IP service debug file. The IP service debug file contains information from the IP and the OpenAccess SQL engine. Each debug log file includes a fixed header that contains installation-specific information.
When you consult technical support, you may be asked for the contents of these log files. The names and location of the OpenAccess SDK service debug log files depend on your OpenAccess SDK Server platform.
The information that is logged depends on the value set for the ServiceDebugLogLevel and the ServiceIPLogOption service attributes. By default, logging is enabled for Fatal Error messages in ServiceDebugLogLevel and Enable Error Tracing in ServiceIPLogOption. Enabling additional logging levels uses large amounts of disk space and slows processing. We recommend that you enable these additional levels only while you are troubleshooting. How you turn on and off the logging option depends on your OpenAccess SDK Server platform. See Configuring Logging for information about setting debug levels.

Log File Names

The service debug log file name is:
servicename_processid.log
where:
servicename is the name of the OpenAccess SDK service.
processid is the numeric process identifier assigned by the operating system for the OpenAccess SDK service process. For example:
OpenAccessSDK810_C_5992.log
The IP service debug log file name has a suffix of -IP appended to the file name, for example:
OpenAccessSDK810_C_5992-IP.log

Log File Location on Windows

On Windows, the operator logging facility is the event log. You can access the event log by clicking the Event Viewer icon in the Administrative Tools program group. OpenAccess SDK Server logging belongs to the application class, with the service name as the source name. You can choose the messages that you want to view in the event log by using the Filter menu option.
Note: You may need to refresh the Event window to receive the latest logging information.

Log File Location on UNIX/Linux

The ServiceDebugLogPath service attribute specifies the location of the service debug log files. Messages are sent to the syslogid infrastructure. By default, the messages are sent as USER type messages; however, you can change the message type by setting the ServiceUnixSyslogFacility service attribute. For more information about specifying OpenAccess SDK service attributes, refer to the OpenAccess SDK Administrator’s Guide.