Skip to content

Commit bbd734a

Browse files
authored
tikv / titan: Add note for disabling titan (#20996)
1 parent 06ef9e5 commit bbd734a

File tree

1 file changed

+6
-2
lines changed

1 file changed

+6
-2
lines changed

storage-engine/titan-configuration.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -138,7 +138,7 @@ To disable Titan, you can configure the `rocksdb.defaultcf.titan.blob-run-mode`
138138
- When the option is set to `read-only`, all newly written values are written into RocksDB, regardless of the value size.
139139
- When the option is set to `fallback`, all newly written values are written into RocksDB, regardless of the value size. Also, all compacted values stored in the Titan blob file are automatically moved back to RocksDB.
140140

141-
To fully disable Titan for all existing and future data, you can follow these steps. Note that you can skip Step 2 because it greatly impacts online traffic performance. In fact even without Step 2, the data compaction consumes extra I/O and CPU resources when it moves data from Titan to RocksDB, and performance will degrade (sometimes as much as 50%) when TiKV I/O or CPU resources are limited.
141+
To disable Titan for all existing and future data, you can follow these steps. Note that you can skip Step 2 because it greatly impacts online traffic performance. In fact even without Step 2, the data compaction consumes extra I/O and CPU resources when it moves data from Titan to RocksDB, and performance will degrade (sometimes as much as 50%) when TiKV I/O or CPU resources are limited.
142142

143143
1. Update the configuration of the TiKV nodes you wish to disable Titan for. You can update configuration in two methods:
144144

@@ -167,7 +167,11 @@ To fully disable Titan for all existing and future data, you can follow these st
167167

168168
3. After the compaction is finished, wait for the **Blob file count** metrics under **TiKV-Details**/**Titan - kv** to decrease to `0`.
169169

170-
4. Update the configuration of these TiKV nodes to disable Titan.
170+
4. For TiDB v8.5.0 or a later version, update the configuration of these TiKV nodes to disable Titan.
171+
172+
> **Warning:**
173+
>
174+
> For versions earlier than v8.5.0, it is recommended to skip this step, because it might cause TiKV to crash. In these earlier versions, following Step 1 is sufficient to disable Titan. There is no performance difference between the configuration changes in Step 1 and the following changes in this step after the data migration is complete.
171175

172176
```toml
173177
[rocksdb.titan]

0 commit comments

Comments
 (0)