Sun Java System Messaging Server 6.3 Administration Guide

3.4.3.1 How to Enable Debugging on Sun Cluster

Messaging Server Data Service Sun Cluster agents uses two APIs to log debug messages:

scds_syslog_debug()writes a debugging message to the system log at 1 level.

scds_syslog() writes a message to the system log at daemon.notice, daemon.info and daemon.error levels.

All syslog messages are prefixed with the following:


SC[resourceTypeName, resourceGroupName, resourceName,methodName]

For example:


Dec 11 18:24:46 mars SC[SUNW.ims,MS-RG,mail-rs,ims_svc_start]: [ID 831728daemon.debug]
Groupname mail exists. 
Dec 11 18:24:46 mars SC[SUNW.ims,MS-RG,mail-rs,ims_svc_start]: [ID 383726daemon.debug] 
Username mailsrv exists.
Dec 11 18:24:46 mars SC[SUNW.ims,MS-RG,mail-rs,ims_svc_start]: [ID 244341daemon.debug] 
IMS_serverroot = /opt/mars/SUNWmsgsr
Dec 11 15:55:52 mars SC[SUNW.ims,MS_RG,MessagingResource,ims_svc_validate]: 
[ID 855581daemon.error] Failed to get the configuration info
Dec 11 18:24:46 mars SC[SUNW.ims,MS-RG,mail-rs,ims_svc_start]: [ID 833212daemon.info]
Attempting to start the data service under process monitor facility.

To log messages from the Messaging Server Resource Type SUNW.ims, create the Resource Type Directory under /var/cluster as shown below:


mkdir -p /var/cluster/rgm/rt/SUNW.ims

To see all debugging messages for resource type SUNW.ims, issue the following command on all the nodes of your cluster:


echo 9 > /var/cluster/rgm/rt/SUNW.ims/loglevel

To suppress debugging messages for resource type SUNW.iws, issue the following command on all nodes of your cluster:


echo 0 > /var/cluster/rgm/rt/SUNW.ims/loglevel

To log debug messages from the Sun Cluster Data services and the most common debugging information from the Messaging Server Agents, edit the syslog.conf file. For example, to log all syslog messages to the file /var/adm/clusterlog, add the following line to the syslog.conf file:


daemon.debug /var/adm/clusterlog

This will log all messages at the following levels (emerg, alert, critical, error, warning, notice, information, debug). See syslog.conf man page for more information

Now restart the syslogd daemon:


pkill -HUP syslogd