Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Note
titleRelease 2.0.0 & 2.0.1

Release 2.0.1 was published soon after release 2.0.0 and as such we have simply updated the deployment steps to reflect the 2.0.1 changes. 2.0.1 includes several minor fixes to the endTB exports, see the release notes for more details here.


Upgrade endTB Bahmni from 1.5.1 to 2.0.1

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

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


    Code Block
    languagebash
    sudo yum remove -y bahmni-installer
    sudo yum install -y https://dl.bintray.com/bahmni/rpm/rpms/bahmni-installer-0.88-101.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.


    Code Block
    languagebash
    sudo bahmni -i inventory db-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


    Code Block
    languagebash
    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/Bahmni/endtb-config/archive/2.0.1.zip
    sudo unzip 2.0.1.zip
    sudo mv endtb-config-2.0.1 endtb_config


  4. Copy the inventory file from here to /etc/bahmni-installer.  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.

    Code Block
    languagebash
    #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/Bahmni/endtb-config/2.0.1/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/Bahmni/endtb-config/2.0.1/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



Fresh installation of endTB Bahmni 2.0.1

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

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

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


Note

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.



Code Block
languagebash
cd /etc/bahmni-installer/deployment-artifacts
sudo wget https://github.com/Bahmni/endtb-config/archive/2.0.1.zip
sudo unzip 2.0.1.zip
sudo mv endtb-config-2.0.1 endtb_config

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


Note

Copy the inventory file from here to /etc/bahmni-installer (as shown in steps below).  Ensure that the previously existing inventory file is updated with the latest one.


Warning

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


Code Block
languagebash
#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/Bahmni/endtb-config/2.0.1/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/Bahmni/endtb-config/2.0.1/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


Note

Please restart openmrs after the upgrade

Code Block
languagebash
sudo service openmrs restart