Sun Java System Communications Services 6 2005Q1 Delegated Administrator Guide |
Appendix C
Debugging Delegated AdministratorYou can obtain log information for Delegated Administrator by examining log files generated by the Delegated Administrator components, by the Web container to which Delegated Administrator has been deployed, and by Directory Server and Access Manager.
This appendix includes the following topics:
Debugging the Command-Line UtilitiesTo debug the Delegated Administrator utility (commadmin), you can print debug messages in the client by using the -v option with the commadmin command.
Delegated Administrator Console LogThe Delegated Administrator console creates a runtime log file:
You can specify your own log file by editing a log properties file:
You can change the following properties in the logger.properties file:
Delegated Administrator Server LogYou can create a Delegated Administrator server log that contains debug statements generated by the Delegated Administrator servlets installed on the Web container.
To do so, you enable a Debug servlet to log debug messages from the Delegated Administrator servlet execution. You can turn on the Debug servlet through your browser by going to the following url path:
http://machine name:port/commcli/debug?op=set&state=all&package=all&filename=full path
where
For example:
http://abc.red.iplanet.com:8008/commcli/debug?op=set&state=all&package=all&filename=/tmp/debug.log
The preceding url would log Debug servlet messages to the following path and file:
/tmp/debug.log
Whenever you restart the Web container, you must turn on the Debug servlet.
Web Container Server LogsYou can debug Delegated Administrator further by examining the server logs generated by your Web container.
Web Server
Web Server maintains access and error logs, located in the following path:
/web_server_base/https-machine name/logs
where
Application Server 7.x
Application Server 7.x maintains access and error logs, located in the following path:
/application_server7_base/domains/domain1/server1/logs
where
Application Server 8.x
Application Server 7.x maintains access and error logs, located in the following paths.
Server log:
/application_server8_base/domains/domain1/logs
Access log:
/application_server8_base/domains/domain1/logs/access/server_access_log
where
Directory Server and Access Manager LogsYou can debug Delegated Administrator further by examining the logs generated by Directory Server and Access Manager.
Directory Server
Directory Server maintains access and error logs, located in the following path:
/var/opt/mps/serverroot/slapd-hostname/logs
where
Access Manager
Access Manager maintains log files in the following paths.
/var/opt/SUNWam/debug
The preceding path contains the amProfile and amAuth logs.
/var/opt/SUNWam/logs
The preceding path contains the amAdmin.access and amAdmin.error logs.