My Oracle Support Banner

Understanding and Troubleshooting "ereport.fs.zfs.checksum" FMA Events (Doc ID 1517800.1)

Last updated on JANUARY 16, 2024

Applies to:

Solaris Operating System - Version 10 8/07 U4 and later
Information in this document applies to any platform.

Purpose

The purpose of this document is to provide the reader with information that can be used to troubleshoot the root cause for checksum errors reported by ZFS.  There are many causes for checksum errors.  This document provides some useful information about the meaning of the events and some detailed debugging techniques that can be used to understand the nature of the corruption.  The intention being that if the data block(s) found to be corrupt can be dumped and looked at it should help drive the root cause investigation to conclusion.

The detail within the FMA checksum events does not provide root cause, it simply gives the observer information about the corruption to assist with root cause.  Root cause is not always possible because there are many causes for corruption. A list of possible or probable cause may be all we can achieve.

Troubleshooting Steps

To view full details, sign in with your My Oracle Support account.

Don't have a My Oracle Support account? Click to get started!


In this Document
Purpose
Troubleshooting Steps
 Scrub Frequently
 FMA Event Payload Detail
 FMA Event Payload Example
 Troubleshooting Checksum Errors
 Using zfs_checksum.d to calculate the DVA for zdb
 Calculating DVA from an FMA Ereport
 Worked Example #1
 Worked Example #2
 Appendix
References

My Oracle Support provides customers with access to over a million knowledge articles and a vibrant support community of peers and Oracle experts.