Chapter 21. Troubleshooting Software Problems (Overview)

Table of Contents

What's New in Troubleshooting?
Possible Common Agent Container Problems in the Solaris OS
SMF Boot Archive Service Might Fail During System Reboot
Dynamic Tracing Facility
kmdb Replaces kadb as Standard Solaris Kernel Debugger
Where to Find Software Troubleshooting Tasks
Troubleshooting a System Crash
kmdb Replaces kadb as Standard Solaris Kernel Debugger
Solaris Dynamic Tracing Facility
What to Do if the System Crashes
Gathering Troubleshooting Data
Troubleshooting a System Crash Checklist

What's New in Troubleshooting?

This section describes new or changed troubleshooting information in this Solaris release. For information on new or changed troubleshooting features in the Solaris 10 release, see the following:

  • kmdb Replaces kadb as Standard Solaris Kernel Debugger

  • Solaris Dynamic Tracing Facility

For a complete listing of new Solaris features and a description of Solaris releases, see the What’s New in Solaris Express .

Possible Common Agent Container Problems in the Solaris OS

Solaris Express 4/06: The Common Agent Container is a stand-alone Java program that is now included in the Solaris OS. This program implements a container for Java management applications. The Common Agent Container provides a management infrastructure that is designed for Java Management Extensions (JMX) and Java Dynamic Management Kit (Java DMK) based functionality. The software is installed by the SUNWcacaort package and resides in the /usr/lib/cacao directory.

Typically, the container is not visible. However, there are two instances when you might need to interact with the container daemon:

  • It is possible that another application might attempt to use a network port that is reserved for the Common Agent Container.

  • In the event that a certificate store is compromised, you might have to regenerate the Common Agent Container certificate keys.

For information about how to troubleshoot these problems, see Troubleshooting Common Agent Container Problems in the Solaris OS.

SMF Boot Archive Service Might Fail During System Reboot

Solaris Express 6/05: If a system crash occurs in the GRUB based boot environment, it is possible that the SMF service svc:/system/boot-archive:default might fail when the system is rebooted. If this problem occurs, reboot the system and select the Solaris failsafe archive in the GRUB boot menu. Follow the prompts to rebuild the boot archive. After the archive is rebuilt, reboot the system. To continue the boot process, you can use the svcadm command to clear the svc:/system/boot-archive:default service. For instructions, see What to Do if the SMF Boot Archive Service Fails During a System Reboot. For more information on GRUB based booting, see Chapter 11, GRUB Based Booting (Tasks), in System Administration Guide: Basic Administration .

Dynamic Tracing Facility

Solaris 10: The Solaris Dynamic Tracing (DTrace) facility is a comprehensive dynamic tracking facility that gives you a new level of observerability into the Solaris kernel and user processes. DTrace helps you understand your system by permitting you to dynamically instrument the OS kernel and user processes to record data that you specify at locations of interest, called, probes. Each probe can be associated with custom programs that are written in the new D programming language. All of DTrace's instrumentation is entirely dynamic and available for use on your production system. For more information, see the dtrace ( 1M ) man page and the Solaris Dynamic Tracing Guide .

kmdb Replaces kadb as Standard Solaris Kernel Debugger

Solaris 10: kmdb has replaced kadb as the standard “in situ” Solaris kernel debugger.

kmdb brings all the power and flexibility of mdb to live kernel debugging. kmdb supports the following:

  • Debugger commands (dcmds)

  • Debugger modules (dmods)

  • Access to kernel type data

  • Kernel execution control

  • Inspection

  • Modification

For more information, see the kmdb ( 1 ) man page. For step-by-step instructions on using kmdb to troubleshoot a system, see the How to Boot the System With the Kernel Debugger (kmdb) in System Administration Guide: Basic Administration .