How to upgrade from v0.11.x to v0.12.x in Apache IoTDB database

How to upgrade from v0.11.x to v0.12.x in Apache IoTDB database? Should I back up my data?


Solution 1:

Upgrading from v0.11 to v0.12 , the upgrade tool will rewrite the data files automatically.

  1. Stop writing new data.
  2. Call flush command using sbin/start-cli.sh in original version to close all TsFiles. We recommend to backup the data file (also the wal files and mlog.txt) before upgrading for rolling back.
  3. Just download, unzip v0.12.x.zip, and modify conf/iotdb-engine.proeprties to let all the directories point to the folders set in previous version (or the backup folder). You can also modify other settings if you want. Any other config changes in v0.11 should be moved to v0.12.
  4. Stop IoTDB v0.11 or v0.10 instance, and start v0.12.x, then the IoTDB will upgrade data file format automatically. It is ok to read and write data when the upgrading process works. 5.After a log All files upgraded successfully! printed, the upgrading completes.

Here are some notices:

NOTICE 1: V0.12 changes many settings in conf/iotdb-engine.properties, so do not use previous configuration file directly.

NOTICE 2: V0.12 doesn't support upgrade from v0.9 or lower version, please upgrade to v0.10 first if needed.

NOTICE 3: We don't recommend to delete data before the upgrading finished. The deletion will fail if you try to delete data in the storage group with upgrading files.