Deployment Steps - Release endTB 2.0

Releases 2.0.0, 2.0.1, 2.0.2 & 2.0.3

Releases 2.0.1, 2.0.2 and 2.0.3 are patch releases on top of 2.0.0 and as such we have simply updated the deployment steps to reflect the 2.0.3 release. 2.0.1 ,2.0.2 and 2.0.3 comprised of only minor patches, see the release notes for more details here.


Upgrade endTB Bahmni from 1.5.1 to 2.0.3

Please follow the below steps to upgrade Bahmni from Release 1.5.1 to 2.0.3

  1. Download bahmni-installer and run it using the following commands

    sudo yum remove -y bahmni-installer
    sudo yum install -y https://dl.bintray.com/bahmni/rpm/rpms/bahmni-installer-0.88-123.noarch.rpm
  2. Take a backup of the current database and implementation_config directory before proceeding forward
    Note: You can also use your own way of taking backup if you have one in place.


    sudo bahmni -i inventory backup
    cp -R /var/www/implementation_config ~/implementation_config_backup
  3. Copy the latest endtb-config folder to the location /etc/bahmni-installer/deployment-artifacts


    cd /etc/bahmni-installer/deployment-artifacts
    sudo rm -rf /etc/bahmni-installer/deployment-artifacts/release-0.86.zip
    sudo rm -rf /etc/bahmni-installer/deployment-artifacts/endtb_config
    sudo wget https://github.com/DWB-eHealth/endtb-config/archive/2.0.3.zip
    sudo unzip 2.0.3.zip
    sudo mv endtb-config-2.0.3 endtb_config
  4. Copy the inventory file as per the steps below.  Ensure that the previously existing inventory file is updated with the latest one.  The setup.yml file is downloaded using the below commands. Once it is downloaded ensure that the timezone field is updated with the actual server timezone.

    #Manually patching the Oracle Java playbook due to deprecation of old download links.
    sudo wget https://raw.githubusercontent.com/Bahmni/bahmni-playbooks/release-0.89/roles/oracle-java/defaults/main.yml -O /opt/bahmni-installer/bahmni-playbooks/roles/oracle-java/defaults/main.yml
    
    
    #Download inventory file for endTB
    sudo wget https://raw.githubusercontent.com/DWB-eHealth/endtb-config/2.0.3/playbooks/examples/inventory -O /etc/bahmni-installer/inventory
       
    #Change the timezone parameter in /etc/bahmni-installer/setup.yml after the below step
    sudo wget https://raw.githubusercontent.com/DWB-eHealth/endtb-config/2.0.3/playbooks/examples/setup.yml -O /etc/bahmni-installer/setup.yml
    
    sudo yum clean all
    sudo bahmni -i inventory install
    sudo bahmni --implementation_play=/var/www/bahmni_config/playbooks/all.yml -i inventory install-impl
     
    #Run the batch program for the first time
    sudo su -s /bin/bash bahmni
    /usr/bin/bahmni-batch


    Please restart openmrs after the upgrade

    sudo service openmrs restart

Fresh installation of endTB Bahmni 2.0.3

Please follow the below steps to install Bahmni from Release 2.0.3 with the base database dump provided for endTB

Install the bahmni-installer along with its pre-requisite software using the following commands

sudo yum install -y unzip wget
sudo yum install -y https://dl.bintray.com/bahmni/rpm/rpms/bahmni-installer-0.88-123.noarch.rpm

Copy the latest endtb-config folder and base database dump (from endtb-config folder) to the location /etc/bahmni-installer/deployment-artifacts.
Please run the commands mentioned below.


cd /etc/bahmni-installer/deployment-artifacts
sudo wget https://github.com/DWB-eHealth/endtb-config/archive/2.0.3.zip
sudo unzip 2.0.3.zip
sudo mv endtb-config-2.0.3 endtb_config

sudo cp endtb_config/dbdump/mysql_dump.sql openmrs_backup.sql

Copy the inventory file as per the steps below.  Ensure that the previously existing inventory file is updated with the latest one.

Once setup.yml is downloaded ensure that the timezone field is updated with the actual server timezone.

#Manually patching the Oracle Java playbook due to deprecation of old download links.
sudo wget https://raw.githubusercontent.com/Bahmni/bahmni-playbooks/release-0.89/roles/oracle-java/defaults/main.yml -O /opt/bahmni-installer/bahmni-playbooks/roles/oracle-java/defaults/main.yml


#Download inventory file for endTB
sudo wget https://raw.githubusercontent.com/DWB-eHealth/endtb-config/2.0.3/playbooks/examples/inventory -O /etc/bahmni-installer/inventory
  
#Change the timezone parameter in /etc/bahmni-installer/setup.yml after the below step
sudo wget https://raw.githubusercontent.com/DWB-eHealth/endtb-config/2.0.3/playbooks/examples/setup.yml -O /etc/bahmni-installer/setup.yml

sudo yum clean all
sudo bahmni -i inventory install
sudo bahmni --implementation_play=/var/www/bahmni_config/playbooks/all.yml -i inventory install-impl

#Run the batch program for the first time
sudo su -s /bin/bash bahmni
/usr/bin/bahmni-batch

Please restart openmrs after the upgrade

sudo service openmrs restart


The Bahmni documentation is licensed under Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)