Review the information in the following sections before tracing or troubleshooting Identity Manager:
This chapter is intended for application server and database administrators, front-line support engineers, and partners who are responsible for maintaining Identity Manager in a deployment environment.
Before troubleshooting problems with Identity Manager, you must
Be familiar with Java 5.0 (required for Sun Identity Manager 8.1)
Understand the components that you are trying to troubleshoot
Before you start tracing or troubleshooting Identity Manager, note the following:
Tracing affects system performance. To ensure optimal performance, use the minimum tracing level needed or turn off tracing after debugging the systems.
Do not enable tracing for the com.waveset class. The com.waveset class is verbose and has many classes, so tracing this class might cause your server to hang.
Do not configure Identity Manager to trace at the advanced level unless instructed to do so by Sun Support.
If you set exception.trace in the Waveset.properties file to debug a specific problem, do not use it for an extended period of time and be sure you disable it after debugging. Setting exception.trace in the Waveset.properties file can significantly affect system performance.
Before you call Sun Technical Support for assistance with a problem, consider the following suggestions for narrowing the problem area:
Try using web browser search tools to research the problem.
Use resource-specific support options when available. Your problem might be related to a resource and fixed using a resource patch.
Remove Identity Manager from the equation by using an appropriate client tool when possible. For example, by using a Java LDAP browser.
Also, you must collect and have the following information available before calling Sun Support for assistance.
In addition to the information provided in this chapter, consult the documents and web sites listed in this section for information related to tracing and troubleshooting Identity Manager.
See the following documents for information related to tracing and troubleshooting Identity Manager:
Testing Your Customized Form in Sun Identity Manager Deployment Reference for the recommended method of tracing XPRESS functions.
The article titled Using JConsole to Monitor Applications for information about using JConsole to monitor applications that run on the Java platform. This article is available from the following URL:
http://java.sun.com/developer/technicalArticles/J2SE/jconsole.html
The following table describes web sites related to troubleshooting Identity Manager.
Table 5–1 Useful Web Sites
Generally, you can identify and resolve problems in your deployment if you follow the steps shown in the following illustration.
See Tracing Identity Manager Objects and Activities for information about how to enable tracing for different Identity Manager objects and activities.
See Troubleshooting and Fixing Common Problems for information about how to troubleshoot problems that commonly occur for those objects and activities.