[MDEV-26088] Document rocksdb_wal_recovery_mode Created: 2021-07-04  Updated: 2021-08-30  Resolved: 2021-08-30

Status: Closed
Project: MariaDB Server
Component/s: Documentation, Documentation - Support, Storage Engine - RocksDB
Affects Version/s: 10.2, 10.3, 10.4, 10.5, 10.6
Fix Version/s: N/A

Type: Bug Priority: Major
Reporter: Valerii Kravchuk Assignee: Ian Gilfillan
Resolution: Fixed Votes: 0
Labels: None


 Description   

Our KB:

https://mariadb.com/kb/en/myrocks-system-variables/#rocksdb_wal_recovery_mode

is not much helpful while describing this setting (and the enterprise documentation on it is not any better).

Please extend it with description that can be found here:

https://github.com/facebook/mysql-5.6/wiki/MyRocks-Crash-Recovery

and

https://github.com/facebook/rocksdb/wiki/WAL-Recovery-Modes

There is also missing correlation between these two, which goes as follows:

rocksdb_wal_recovery_mode = 1 (default)
wal_recovery_mode=kAbsoluteConsistency

rocksdb_wal_recovery_mode = 0
wal_recovery_mode=kTolerateCorruptedTailRecords

rocksdb_wal_recovery_mode = 2
wal_recovery_mode=kPointInTimeRecovery

rocksdb_wal_recovery_mode = 3
wal_recovery_mode=kSkipAnyCorruptedRecords

It can be verified by checking the $datadir/.rocksdb/OPTIONS-* file for wal_recovery_mode= value after using particular rocksdb_wal_recovery_mode setting.


Generated at Thu Feb 08 09:42:39 UTC 2024 using Jira 8.20.16#820016-sha1:9d11dbea5f4be3d4cc21f03a88dd11d8c8687422.