Version Migration Guide#
We always recommend using the latest version of Covalent in order to get the latest improvements to our UI, use the latest features, and to take advantage of speedups in workflow execution.
Migrating to 0.177.0#
If you are currently using Covalent v0.110.2 you can upgrade to covalent v0.177.0 or later as follows.
First identify the currently installed version and then stop the server.
$ pip show covalent | grep Version Version: 0.110.2 $ covalent stop Covalent server has stopped.
You can install the new version of Covalent using pip.
$ pip install covalent==0.177.0 --upgrade $ pip show covalent | grep Version Version: 0.177.0 $ covalent db migrate INFO [alembic.runtime.migration] Context impl SQLiteImpl. INFO [alembic.runtime.migration] Will assume non-transactional DDL. INFO [alembic.runtime.migration] Running upgrade -> b60c5ecdf927, init INFO [alembic.runtime.migration] Running upgrade b60c5ecdf927 -> 9b9d58f02985, v11 Migrations are up to date. $ covalent start Covalent server has started at http://localhost:48008
You should then be able to use our data migration tool to migrate any workflows you may want to port over to the new version of Covalent.
For example, for a workflow with dispatch id
$ covalent migrate-legacy-result-object ./results/e0ba03a2-fdc0-474e-9997-7fa8e82932c5/result.pkl Processing result object for dispatch e0ba03a2-fdc0-474e-9997-7fa8e82932c5 Processing node 0 Processing node 1 Processing node 2 Processing node 3 Processed transport graph Processed lattice
You should now be able to navigate to the UI (http://localhost:48008) and see your existing workflows.