Replacing a bad disk is one of the most important things that a user can do with his or her FreeNAS system, and right now, if the pool is encrypted, the documentation is very confusing.
There have been multiple forum posts where people try to make sure they understand, before they go through the process. The rest of the FreeNAS documentation is super clear, but this is one place that many people stumble.
Here's an example:
Wait until resilvering is complete before restoring the encryption keys to the pool. Restore the encryption keys before the next reboot or access to the pool will be permanently lost.
- Highlight the pool that contains the recently replaced disk and click Add Recovery Key to save the new recovery key. The old recovery key will no longer function, so it can be safely discarded.
"Restore the encryption keys before the next reboot." Is this a step? What do I click to perform this step? Or does this step merely describe the step listed as the singular "1" below? Also, the term "Add recovery key" is misleading too. It should say save / download. The whole thing could really be cleaned up, as described in the forum post here.