Version 12.0.0
Upgrading WiredTiger applications

Upgrading to Version 12.0.0

Fixed-length column-store is removed

The storage format fixed-length column-store is no longer supported. This means that if you have a fixed-length column-store table it will not be readable as of 12.0.0, opening the database will return an error. In order to upgrade to this release you must re-write the table as either variable-length column-store, or row-store. However we will also be removing support for variable-length column-store so it is recommended to re-write the table as row-store.

The steps are as follows:

  1. Create a row store table with integer keys (key_format=i), and fixed-length bit values.
  2. Open a cursor on your FLCS table.
  3. For every key in the FLCS table read it in, and write it back to the row store table.
  4. Finally drop the FLCS table.

Upgrading to Version 11.3.1

Per-file configuration "huffman_value"

Huffman encoding is no longer supported for values or keys (support for keys was removed in a previous release).

Connection configuration "checkpoint_cleanup"

The checkpoint_cleanup configuration now uses a sub-configuration "method" to control how aggressively obsolete content is removed when creating checkpoints: "checkpoint_cleanup=[method=[none|reclaim_space]]"

Connection configuration "verbose"

Three eviction-related verbose config values ('evict', 'evict_stuck', and 'evictserver') have been merged into the 'eviction' config.

WT_SESSION.verify configuration "dump_app_data"

The 'dump_app_data' configuration of the WT_SESSION.verify command has been renamed to 'dump_all_data'.

WT_SESSION.set_timestamp configuration "oldest_timestamp" and "stable_timestamp"

An invalid oldest_timestamp or stable_timestamp value is no longer silently ignored, and now returns an error. The stable timestamp should always be greater than the oldest timestamp and neither can be set to a value older than the current one.


Upgrading to Version 11.2.0

Connection configuration "operation_timeout_ms"

The connection configuration "operation_timeout_ms" is now deprecated. The option is still accepted in this version but will have no effect when set.

Connection configuration "failpoint_eviction_fail_after_reconciliation"

The connection configuration "failpoint_eviction_fail_after_reconciliation" has been replaced by "failpoint_eviction_split".

Cursor configuration "prefix_search"

The cursor configuration "prefix_search" is now deprecated. The option is still accepted in this version but will have no effect when set. Users should look into the new bound cursor interface.

Session API "flush_tier" function

The session API "flush_tier" function is removed. Users of this function should move to calling "checkpoint" with the "flush_tier" configuration specified.


Upgrading to Version 11.1.0

Connection configuration "debug mode"

The connection configuration "debug_mode" (only used for testing) has had its "flush_checkpoint" option removed.

Connection configuration "timing_stress_for_test"

The connection configuration "timing_stress_for_test" (only used for testing) has had its "checkpoint_evict_page" option removed.

Connection configuration "verbose"

The verbose messaging system has had its range of debug options extended. The previous "DEBUG" level now maps to "DEBUG_1", and will output significantly fewer messages. If you want all of the same messages as the old "DEBUG" level, you'll need to use "DEBUG_5".


Upgrading to Version 11.0.0

The WiredTiger 11.0 release is a complete refresh of the WiredTiger storage engine. Applications written to earlier versions of the WiredTiger API will require review (although the API structure is substantially the same as previous releases). Applications using row-store data objects can use those objects without change. Applications using fixed- or variable-length column-store data objects will require a dump and reload cycle to import those objects into a 11.0 release environment.


Upgrading to Version older than 11.0.0

Please refer to the following link for upgrade suggestions for version older than 11.0.0. https://source.wiredtiger.com/10.0.0/upgrading.html