Skip to main content

Technical Advisory 10005

Date and Version​

Version: 2.39.0

Date: Calendar week 41/42 2023

Description​

Migrating to version >= 2.39 from < 2.39 will cause down time during setup starts and the new version is started. This is caused by storage optimisations which replace the eventstore.events database table with the new eventstore.events2 table. All existing events are migrated during the execution of the zitadel setup command. New events will be inserted into the new eventstore.events2 table. The old table evetstore.events is renamed to eventstore.events_old and will be dropped in a future release of ZITADEL.

Statement​

This change is tracked in the following PR: new eventstore framework. As soon as the release version is published, we will include the version here.

Mitigation​

If you use this table for TRIGGERS or Change data capture please check the new table definition and change your code to use eventstore.events2.

Impact​

Once the setup step renamed the table. Old versions of ZITADEL are not able to read/write events.

note

If the upgrade fails make sure to rename eventstore.events_old to eventstore.events. This change enables older ZITADEL versions to work properly.