Skip to content

Upgrade a Platform Deployment

A Platform Deployment is upgraded by

  • Upgrading the off-chain components
  • Upgrading the on-chain state and components (smart contracts, plugins and binder)

Upgrade Off-chain Components

The off-chain components consists of the docker containers running the blockchain nodes, execution engines and Browser.

In order to upgrade these nodes, you need to pull the newest docker images, and restart all components.

Upgrade On-chain State and Components

The on-chain state and components can be upgraded by running the platform-installer with the upgrade command against the running Platform Deployment.

This will upgrade the core module and all installed modules step-wise to the newest version. Any custom deployed contracts will not be upgraded. These needs to be upgraded manually.

Danger

  1. Upgrade is only allowed from platform version 1.68.0 or newer.
  2. Upgrade is not allowed if a module installation is in progress.
  3. The off-chain components MUST be upgraded before upgrading the on-chain.

The README in the platform-dev-runner repository describes how to use the installer. Note that the installer can be run using the --help option to print the usage of the installer.