Complete your documentation

[DarkKnight]

It'd be great if the correct process for replacing a drive in a BTRFS secondary cache pool were documented, or you know, any documentation for replacing a cache drive:

 

https://wiki.unraid.net/index.php/Replace_A_Cache_Drive

 

Quote

There is currently no text in this page. You can search for this page title in other pages, or search the related logs, but you do not have permission to create this page.

 

Replaced one drive in an 8 drive R10 cache pool and, of course instead of formatting just the one drive and rebalancing the R10 array like any normal single raid-10 drive replacement should do, it just re-formatted the entire array and deleted the shares that existed only on that pool. Yes, there was a warning box listing all drives in the pool, and yes, I did tell it to do so suspecting it would re-format all those drives.

 

That being said, since google searches returned more useless results from reddit than this forum, and the actual documentation for this is non-existent, there wasn't much choice. I was smart, and backed up the data from the cache pool elsewhere just in case something like this happened, but it kinda feels like if you were going to release the multiple cache pool 'feature' it'd either work intuitively or at least have whatever command-line driven voodoo is necessary be documented.

 

I've had to write documentation for software processes before (ISO-9001 requirements) and no, it's no fun. It is part of the job though. Please make the time to document how-to do this properly without losing all the data on the array. Also, maybe consider extending the pool start script to have this function without resorting to users having to go to the command line and do it manually. 

 

 

[JorgeB]

FYI pool device replacement is broken since v6.9.x

 

 

[MrGrey]

Newbie here... Am I to understand that a "basic" Unraid operation is broken, or is it just the documentation?

 

MGrey.

[JorgeB]

1 hour ago, MrGrey said:

or is it just the documentation?

Documentation is in multiple places, i.e., about cache there's some info below, including how to replace a device, but like mentioned that part is currently not working.

 

https://wiki.unraid.net/Manual/Storage_Management#Why_use_a_Pool.3F

[Squid]

4 hours ago, JorgeB said:

FYI pool device replacement is broken since v6.9.x

 

Is this still an issue on 6.10RC-2?

[JorgeB]

Is this still an issue on 6.10RC-2?

Yep, I bumped the bug report a couple of times but after that stopped to not be a pain.

[MrGrey]

If I bump it, being a newbie, is it more or less of a pain?... How do I make a poll?

 

MGrey.

[JorgeB]

4 hours ago, MrGrey said:

If I bump

Fee free to do it.