TrueNAS CORETrueNAS CORE Version Documentation
This content follows the TrueNAS CORE 13.0 releases. Use the Product and Version selectors above to view content specific to different TrueNAS software or major version.

Disk Replacement

Hard drives or solid-state drives (SSDs) have a finite lifetime and can fail unexpectedly. When a disk fails in a Stripe (RAID0) pool, the entire pool has to be recreated and all data restored from backups. Creating non-stripe storage pools that have disk redundancy is always recommended.

To prevent further loss of redundancy or eventual data loss, always replace a failed disk as soon as possible! TrueNAS integrates new disks into a pool to restore the pool to full functionality.

Replacing a Disk

Another disk of the same or greater capacity is required to replace a failed disk. This disk must be installed in the TrueNAS system and not part of an existing storage pool. Any data on the replacement disk is wiped as part of the process.

Although GELI encryption is deprecated, TrueNAS implements GELI encryption during a “GELI-Encrypted (Legacy) pool” disk replacement. TrueNAS uses GELI encryption for the lifetime of that pool, even after replacement.

The TrueNAS Dashboard shows when a disk failure degrades a pool.

Degraded Pool
Figure 1: Degraded pool on dashboard widget.

Click the on the pool card to go to the Storage > Pools > Pool Status screen and locate the failed disk.

Taking a Failed Disk Offline

Clicking for the failed disk shows additional operations.

Disk Options
Figure 2: Pool Status disk options.

We recommend you offline the disk before starting the replacement. This removes the device from the pool and can prevent swap issues. To offline a disk:

Go to Storage > Pools screen.

Click on the settings icon, and then select Status to display the list of disks in the pools.

Click the icon for the disk you plan to remove, and then select Offline.

Select Confirm to activate the OFFLINE button, then click OFFLINE. The disk should now be offline.

There are some situations where a disk that has not completely failed can be left online to provide additional redundancy during the replacement procedure. We don’t recommend leaving failed disks online unless you know the exact condition of the failing disk! Attempting to replace a heavily degraded disk without off-lining it first results in a significantly slower replacement process.
If the offline operation fails with a Disk offline failed - no valid replicas message, go to Storage > Pools, click the for the degraded pool, and select Scrub Pool. When the scrub operation finishes, reopen the pool Status and try to offline the disk again.

When the disk status shows as Offline, physically remove the disk from the system.

Offline Disk
Figure 3: Pool Status disk offline.

If the replacement disk is not already physically added to the system, add it now.

Bringing a New Disk Online

In the Pool Status, open the options for the offline disk and click Replace

Replacing Disk
Figure 4: Replacing disk screen.

Select a new member disk and click Replace Disk. The new disk must have the same or greater capacity as the disk you are replacing. The replacement fails when the chosen disk has partitions or data present. To destroy any data on the replacement disk and allow the replacement to continue, set the Force option.

When the disk wipe completes and TrueNAS starts replacing the failed disk, the Pool Status changes to show the in-progress replacement.

Replacing Started
Figure 5: Pool Status replacing disk.

TrueNAS resilvers the pool during the replacement process. For pools with large amounts of data, resilvering can take a long time. When the resilver completes, the pool status screen updates to show the new disk, and the pool status returns to Online.

Replacement Complete
Figure 6: Pool Status disk replacement complete.

Related Content

Related Storage Articles