Understanding the ZFS Pool Scrub Operation, Tuning Scrub Performance, and Troubleshooting Scrub Issues (Doc ID 1496376.1)

Last updated on MAY 17, 2023

Applies to:

Solaris Operating System - Version 10 6/06 U2 and later
Oracle Solaris on x86 (32-bit)
Oracle Solaris on SPARC (64-bit)
Oracle Solaris on x86-64 (64-bit)

Purpose

This document explains how the ZFS pool scrub operation works, how to tune the performance, and how to troubleshoot issues relating to the ZFS scrub operation

Details

	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

What does the scrub operation do?

Factors affecting zpool scrub performance

Scrub Traversal Order

Troubleshooting zpool scrub issues

Changing the zpool scrub performance

zfs_scrub_delay_ms

zfs_scrub_delay

zfs_max_scrubio

zfs_top_maxinflight

zfs_scan_idle_ms

zfs_scan_min_synctime_pct

zfs_scan_min_time_ms

Scrub and DeDup (DTT) Interaction

Reference Material

Oracle Solaris ZFS Resource Center

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