If you're upgrading to a new major release, you should generate a new configuration file using the latest Dispatch version. Doing so ensures that any new settings are visible and configured if required.
Beyond that, upgrades are simple as bumping the version of Dispatch (which will cause any changed dependencies to upgrade), running data migrations, and restarting all related services.
The easiest way to upgrade the Dispatch package using
pip install --upgrade dispatch
You may prefer to install a fixed version rather than the latest, as it will allow you to control changes.
If you're installing from source code, you may have additional unfulfilled requirements, so take the necessary precautions of testing your environment before committing to the upgrade.
Just as during the initial setup, migrations are applied with the upgrade command.
dispatch database upgrade
You'll need to ensure that all of Dispatch's services are restarted after an upgrade. Restarting these services is required because Python loads modules in memory, and code changes will not be reflected until they are restarted.
These services include:
dispatch server start
dispatch scheduler start