Skip to main content

Upgrading D2E

Note: These upgrade instructions are version-specific and cover incremental upgrades between consecutive versions only. Skipping versions has not been tested and is not recommended.

v0.17 to v0.18​

Generate new environment variable TREX_ROOT_KEY​

TREX_ROOT_KEY must be a random 32-byte value, base64-encoded (ie >=40 characters). Generate your own with the following command below, then add it in your .env file.

Using Node.js:

node -e "console.log(require('crypto').randomBytes(32).toString('base64'))"

v0.16 to v0.17​

Update Cache​

For each existing dataset that has both a source and a cache dataset, an admin must re-run Update cache from the dataset's "Select action" menu. Without this, concept search will not work on those datasets.

v0.15 to v0.16​

Sync Roles​

On first startup after upgrading, syncroles runs automatically and prompts for admin credentials. This step is required only on the first startup after upgrading.

Sync Roles screen

Upon successful completion, the following output is displayed:

All roles synced successfully. Set USER_MGMT__ROLE_SOURCE=logto in .env.local