Updating to a newer version of ehrBase

Implementation Platform
1

Hey all!

We’re currently using version 0.27 of EHRBase and want to upgrade to the lastest version however we have many compositions & templates stored currently.

How difficult would it be to upgrade? Or is there any documentation around this? I’m keen to understand the scope of the task before trying to do it.

Thanks!

2

I think you may have to do a formal migration, as the internal data structures have changed considerably.

@vidi42 - is this correct? Is the migration tool ready to go?

3 Likes
3

@DavidD to update to the latest version there are a few steps you should take to ensure a smooth update, because as @ian.mcnicoll mentioned, the data structure has changed considerably when 2.0.0 was released.

  1. Make sure to update to the latest pre 2.0.0 version, which is 0.32.0. For that you need to check the UPDATING script from 0.32.0. This way your data and data structure will be as ready as possible for the migration.
  2. Now that you are on 0.32.0, you can use the migration tool to transition to 2.0.0. I’m happy to say that others have tried it and were able to migrate successfully, however, there are some disclaimers to make:
    • Make sure to have backups. The migration tool won’t remove the source database, so you can retry it as many times as you need, but hey, better safe than sorry
    • Depending on the data you have in EHRbase, there may be some inconsistencies that show up during the migration. Don’t worry, just reach out to us via GitHub issues or trough a private message here.
  3. Once you have successfully migrated to 2.0.0, you can follow again the UPDATING path to get to the latest 2.x version.

Hope this helps. Please let us know how’s it going.

4 Likes