Skip to content

Releases and Migration Notes

Jump to bottom
Jonathan Cameron edited this page Nov 13, 2020 · 21 revisions

This document gives an overview of BHIMA software releases and migrations

Basics

The BHIMA sofware operates on two types of installations (or "sites"): (1) production sites, and (2) test sites.

In most cases the BHIMA software that is installed on production servers is the latest released version. All production servers will receive and run the same BHIMA software. In some cases, installation of the software update may be delayed based on ability to access the remote systems involved.

The BHIMA software does most of its automated testing using a non-production test site called BHIMA Test.

Releases

In the process of developing the BHIMA software, once a set of changes is complete , a release is created. A release is defined set of the software parts of the BHIMA software that has been tested and verified that it works consistently in the test site. A release generally includes bug fixes, new features, improved work-flows, and documentation. Once a release has been made, it is usually installed on each production site as soon as practical. The process of installing the updated software on production sites is called migration. Installing the updated BHIMA software on production sites is straightforward; it simply involves replacing the existing software with the newly released software. Updating the underlying database data is more complicated.

The database data (SQL) for each production site will vary. The primary setup of database tables and basic configuration data is the same for all installations, but each production site will have differences such as data about known users, patients, stock inventories, etc. So the process of updating the database for each production site will be somewhat different. Since we do not want to loose the data that the site already has about its local configuration, we use migrations.

Database SQL Data for BHIMA software

The BHIMA files defining the basic tables and data for the BHIMA software is in these files:

  • server/models/*.sql

Key files are:

  • schema.sql - Defines the database tables for the BHIMA installations
  • bhima.sql - Adds data to the tables for basic BHIMA operations, menus, etc

Before describing migrations, it is useful to review how updating the BHIMA test site software works. In the BHIMA software

Migrations

Clone this wiki locally