Capturing the State of the System in Error Situations

Carbondump is a tool for collecting all the necessary data from a running Carbon instance at the time of an error. The carbondump generates a zip archive with the collected data, which helps the WSO2 support team to analyze your system and determine the problem which caused the error. Therefore, it is recommended that you run this tool as soon as an error occurs in the Carbon instance.

When using the tool, you have to provide the process ID (pid) of the Carbon instance and the <PRODUCT_HOME> which is where your unzipped Carbon distribution files reside. The command takes the following format:

For example,

The tool captures the following information about the system:

• Operating system information** OS (kernel) version

  • Installed modules lists and their information

  • List of running tasks in the system

• Memory information of the Java process** Java heap memory dump

  • Histogram of the heap

  • Objects waiting for finalization

  • Java heap summary. GC algo used, etc.

  • Statistics on permgen space of Java heap

• Information about the running Carbon instance** Product name and version

  • Carbon framework version (This includes the patched version)

  • <PRODUCT_HOME>, <JAVA_HOME>

  • configuration files

  • log files

  • H2 database files

• Thread dump

• Checksum values of all the files found in the $CARBON_HOME