In general, upgrading Substrate is a matter of running
substrate upgrade. If your
substratebinary is not writeable,
substrate upgradewill produce the URL of the tarball you'll need to download and untar to get the new
substratebinary. You should put this in your PATH, replacing the old version.
After upgrading, you should re-run the bootstrapping and account creation commands. The most thorough upgrade requires that you run the following after replacing the binaries:
substrate create-admin-account -quality <quality>for each of your admin accounts
substrate create-account -domain <domain> -environment <environment> -quality <quality>for each of your other accounts
As a convenience,
substrate accounts -format shellwill generate all of these commands and put them in the proper order. For the most streamlined workflow, run
sh <(substrate accounts -format shell -no-apply), review what Terraform plans to do, and then run
sh <(substrate accounts -auto-approve -format shell)to apply the changes.
See the release notes for version-specific upgrade instructions. They will endeavor to call out which of these steps, and potentially additional steps, are necessary to gain access to new features.
Upgrade compatibility is only guaranteed from one month to the next so it's important to stay up-to-date. Behavior of upgrading several versions in one step is undefined and may not function properly.