Skip to content

KenyaEMR 3.x 18.6.2 Platform upgrade script update
Compare
Choose a tag to compare
@donaldkibet donaldkibet released this 23 Oct 06:15
· 466 commits to main since this release
v1.0.9
1d10d14
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.

Release Notes: KenyaEMR 3.x 18.6.2 Upgrade v1.0.9

Introduction

We are excited to announce the release of KenyaEMR version 3.x 18.6.2. This release focuses on upgrading various components for better performance, compatibility, and security. Before starting the upgrade, please ensure you have taken a backup of your existing database and configurations.

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