Skip to content

KENYAEMR3.x_v1.10.4_WED-13-DEC-2023
Compare
Choose a tag to compare
@RAJABIBRAZ RAJABIBRAZ released this 13 Dec 10:57
· 426 commits to main since this release
v1.10.4
493b1a0

KENYAEMR3.x_v1.10.4_WED-13-DEC-2023

Introduction

We are thrilled to unveil KenyaEMR version 3.x 18.7.0, featuring a significant update to our system. This release is dedicated to enhancing performance, compatibility, and security. Before proceeding with the upgrade, we strongly recommend you create a comprehensive backup of your current database and configurations, as this new version introduces important updates to the drug database as well.

Upgrade Instructions

MySQL Upgrade

  • Target Version: MySQL 8.0
  • Note: Ensure you backup your database prior to the upgrade.

To initiate the upgrade, in the package directory, execute the following command:

bash mysql_upgrade.sh

OpenMRS Platform Upgrades

Upgrade to Platform 2.4

Execute the following command:

sh setup_script_2.4.sh

Upgrade to Platform 2.6

Execute the following command:

sh setup_script_2.6.sh

Post upgrade script

Once the upgrade has been successful. Please run the post upgrade command

sh post_upgrade.sh

Resolving CSRF Token Issues

For instances where CSRF token issues might arise, copy the provided properties file to the OpenMRS directory using the following command:

sudo cp csrfguard.properties /var/lib/OpenMRS

MySQL Optimization

To optimize MySQL post-upgrade and ensure it's configured correctly for KenyaEMR, run:

bash mysql_config.sh

Address template

Once the server is up and running update the address template to have the following

<org.openmrs.layout.address.AddressTemplate>
  <nameMappings>
    <entry>
      <string>countyDistrict</string>
      <string>County</string>
      <requiredInHierarchy>true</requiredInHierarchy>
    </entry>
    <entry>
      <string>stateProvince</string>
      <string>Sub County</string>
    </entry>
    <entry>
      <string>address4</string>
      <string>Ward</string>
    </entry>
  </nameMappings>
  <sizeMappings>
    <entry>
      <string>countyDistrict</string>
      <string>40</string>
    </entry>
    <entry>
      <string>stateProvince</string>
      <string>40</string>
    </entry>
    <entry>
      <string>address4</string>
      <string>40</string>
    </entry>
  </sizeMappings>
  <elementDefaults>
    <entry>
      <string>countyDistrict</string>
      <string></string>
    </entry>
  </elementDefaults>
  <requiredElements>
     <string>countyDistrict</string>
     <string>stateProvince</string>
     <string>address4</string>
  </requiredElements>
  <lineByLineFormat>
    <string>address4</string>
    <string>countyDistrict, stateProvince</string>
  </lineByLineFormat>
  <maxTokens>0</maxTokens>
</org.openmrs.layout.address.AddressTemplate>

Important Reminders

  • Always backup before performing an upgrade.
  • These instructions assume you have necessary permissions to execute shell scripts and make changes to your system.

Support

For any issues or further assistance with the upgrade, please contact our support team or refer to the KenyaEMR documentation.

Thank you for being a part of the KenyaEMR community! We hope you find this upgrade beneficial for your medical and operational needs.

Assets 3
Loading