westerndigitalcorporation / zenfs

ZenFS is a storage backend for RocksDB that enables support for ZNS SSDs and SMR HDDs.
GNU General Public License v2.0
239 stars 87 forks source link

Step on-disk file format version and provide migration instructions #118

Closed yhr closed 2 years ago

yhr commented 2 years ago

Now we have two changes that requires on-disk-metadata updates:

https://github.com/westerndigitalcorporation/zenfs/issues/63 https://github.com/westerndigitalcorporation/zenfs/pull/117

After pulling in these changes running a full ci (to make sure we don't need any fixes to the data format it self), we need to bump the on-disk format version and make sure that we provide clear mount-time error messages for incompatible versions.

We also need to document instructions for how to migrate data between versions in the README, and which ZenFS versions have what on-disk format.

yhr commented 2 years ago

I think that the error message should say something like "Migrate the data or or switch back to the previously used zenfs version. See documentation at.."

yhr commented 2 years ago

fixed