Skip to content

Releases: palladiumkenya/openmrs-config-kenyaemr

KENYAEMR3.x_v1.10.3_MON-27-NOV-2023

27 Nov 19:45
@donaldkibet donaldkibet
v1.10.3
995f5d0
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.
Compare
Choose a tag to compare
KENYAEMR3.x_v1.10.3_MON-27-NOV-2023

Setup Instructions

N.B Ensure you have upgraded your system to platform 2.6.2 in the previous release

  1. Download the release package and run
sh setup_script.sh

Ensure you have the correct mysql username and password updated on the script.

  1. Run post upgrade script to ensure system configured well.
sh post_upgrade.sh
Assets 3
Loading

KENYAEMR3.x_v1.10.2_SUN-19-NOV-2023.

19 Nov 18:56
@donaldkibet donaldkibet
v1.10.2
b04371e
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.
Compare
Choose a tag to compare
KENYAEMR3.x_v1.10.2_SUN-19-NOV-2023. Pre-release
Pre-release

For Internal testing to be released later on

Release notes

  1. RDE Support Introduced

    • Feature: Support for RDE (Remote Data Entry) has been added.
    • Usage: To enter data using RDE, initiate a visit on a chosen date.
    • Data Association: Once the visit starts, all subsequent data entries will be timestamped with the start time of that visit, marking it as the time of the encounter.

  2. Enhanced Patient Enrollment and Disenrollment

    • Improvement: Patient enrollment and disenrollment in various programs have been enhanced for better performance.
    • Robustness: The new update makes these processes more robust and reliable.
    • Care Panel Sections: Enhancements have also been made to the care panel sections, improving the overall management and tracking of patient care within the programs.
      Certainly! Here are brief notes on the additional release notes:

  3. Enhanced Tablet Support

    • Feature: Improvements have been made to support tablet devices.
    • Additions: A calendar feature, along with 'Save' and 'Cancel' buttons, have been added specifically for tablet users.
    • User Interface: These additions likely enhance the user interface and usability on tablet devices.

  4. Drug Order Feature in New Release

    • New Functionality: The ability to place drug orders is now available.
    • Prescription Capability: Users can prescribe medication using the KenyaEMR version 3.x.
    • Significance: This feature enhances the system’s capabilities in medication management and prescription within the EMR (Electronic Medical Records) system.

Setup instructions.

Please ensure you have upgrade your platform to run MySQL 8.0 and OpenMRS platform 2.6.x
Checkout instructions to upgrade here

Enhanced Setup Guide

To ensure a smooth setup of the new release, follow these detailed steps:

  1. Download and Unpack

    • Action: Download the latest release package.
    • Unpacking: Extract the downloaded files into your preferred directory.
    • Note: Choose a directory where you have sufficient permissions and storage space.

  2. Run the Setup Script

    • Command: In your terminal or command prompt, navigate to the directory where you unpacked the files.
    • Execution: Type the following command and press Enter: 
      sh setup_script.sh
    • Purpose: This script initializes the installation and configures necessary components.

  3. Wait for Tomcat Restart

    • Patience Required: After running the setup script, wait for the Tomcat server to restart completely.
    • Verification: Confirm that the KenyaEMR login page is accessible.
    • Post-Upgrade Script:
      Once Tomcat has restarted and the login page is visible, execute the post-upgrade script by typing: 
      sh post_upgrade.sh
    • Function: This script performs necessary post-installation updates and checks.

  4. Upgrade Address Template

    • Access Admin Page: Log into the KenyaEMR and go to the admin page.
    • Navigation: Look for the section labeled Manage Address Template.
    • Update Process:
      • Copy the provided XML value.
      • Paste and update it in the Manage Address Template section.
    • Purpose: This step ensures that the address template is up-to-date with the latest standards and requirements.
<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>
Assets 3
Loading

KENYAEMR3.x_v1.10.1_WED-08-NOV-2023

05 Nov 18:29
@donaldkibet donaldkibet
v1.10.1
a716a91
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.
Compare
Choose a tag to compare
KENYAEMR3.x_v1.10.1_WED-08-NOV-2023

We are pleased to announce the latest updates and enhancements to our software:

  • Form Engine Enhancement: We have updated the form engine to provide an improved user interface experience specifically designed for tablet users, ensuring better accessibility and interaction.

  • Drug Concepts Expansion: Our drug database has been meticulously updated to include concepts that were not captured in the previous release, thereby expanding our coverage and accuracy.

  • Care Panel Improvements: We have restructured the care panel to present a more ordered and logical flow, in addition to refining the processes related to program enrollments for enhanced user engagement.

  • Queue Screen Optimizations: A series of fixes and enhancements have been implemented on the queue screen to improve its performance and user experience.

We believe these updates will significantly improve the efficiency and usability of our system. We thank you for your continued support and welcome any feedback that you may have.

Setup Instructions

N.B Ensure you have upgraded your system to platform 2.6.2 in the previous release

  1. Download the release package and run
sh setup_script.sh

Ensure you have the correct mysql username and password updated on the script.

  1. Run post upgrade script to ensure system configured well.
sh post_upgrade.sh
Assets 3
Loading

KenyaEMR_3.x_18.6.2_October_25_2023 v1.10.0

25 Oct 00:54
@donaldkibet donaldkibet
v1.10.0
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.
Compare
Choose a tag to compare
KenyaEMR_3.x_18.6.2_October_25_2023 v1.10.0

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

Introduction

We are thrilled to unveil KenyaEMR version 3.x 18.6.2, 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

KenyaEMR 3.x 18.6.2 Platform upgrade script update

23 Oct 06:15
@donaldkibet donaldkibet
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.
Compare
Choose a tag to compare
KenyaEMR 3.x 18.6.2 Platform upgrade script update

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

v1.0.8

16 Oct 22:15
@donaldkibet donaldkibet
v1.0.8
ecf6ede
Compare
Choose a tag to compare
v1.0.8

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

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

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

KenyaEMR 3.x 18.6.2 Platform upgrade

15 Oct 20:13
@donaldkibet donaldkibet
v1.0.7
ecf6ede
Compare
Choose a tag to compare
KenyaEMR 3.x 18.6.2 Platform upgrade

Release Notes: KenyaEMR 3.x 18.6.2 Upgrade

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

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

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

KenyaEMR 18.6.2 03 Platform upgrade

03 Oct 13:44
@donaldkibet donaldkibet
v1.0.6
ecf6ede
Compare
Choose a tag to compare
KenyaEMR 18.6.2 03 Platform upgrade

Release Notes: KenyaEMR 3.x 18.6.2 Upgrade

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

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

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

KenyaEMR 18.6.2 O3 Sites Updated forms V1.0.5

30 Aug 12:59
@donaldkibet donaldkibet
v1.0.5
6dbcf1a
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.
Compare
Choose a tag to compare
KenyaEMR 18.6.2 O3 Sites Updated forms V1.0.5

Release Notes - KenyaEMR 18.6.2 O3 Sites Updated forms V1.0.5

Patch release folloing v1.0.4 deployment issues

  1. Enhanced Form Availability for Clinical Use

In response to user feedback, we have updated the Kenya EMR back end to provide access to all necessary forms for clinical use. This means that healthcare professionals now have a comprehensive set of forms at their disposal, streamlining the data collection process and enhancing the quality of patient care.

  1. Improved HTS Form Functionality:

We have diligently worked on refining the HTS (HIV Testing Services) forms to ensure seamless functionality. Specifically, the HTS Initial and HTS Re-test forms have been fine-tuned to work correctly. This improvement guarantees accurate data capture during HIV testing, aiding healthcare providers in making informed decisions and offering appropriate counseling.

  1. Revamped HIV Green Card Based on User Feedback:

Building upon the feedback received from our users regarding the HIV Green Card in release v1.0.4, we have implemented the requested changes. The updated HIV Green Card now aligns more closely with user preferences and requirements. This enhancement will facilitate improved patient monitoring and management within the system.

We appreciate your continued support and feedback as we strive to enhance the Kenya EMR platform. Please don't hesitate to reach out to our support team if you encounter any issues or have further suggestions. Together, we are advancing towards more efficient and effective healthcare data management.

Assets 3
Loading

KenyaEMR 18.6.2 O3 Sites Updated forms V1.0.4

28 Aug 09:04
@donaldkibet donaldkibet
v1.0.4
5b7f086
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.
Compare
Choose a tag to compare
KenyaEMR 18.6.2 O3 Sites Updated forms V1.0.4

Release Notes - KenyaEMR 18.6.2 O3 Sites Updated forms V1.0.4

We are excited to introduce the latest update to the Kenya EMR system, version 1.0.4 This release brings a variety of enhancements and fixes to improve your clinical experience. Here are the key highlights:

  1. Enhanced Form Availability for Clinical Use

In response to user feedback, we have updated the Kenya EMR back end to provide access to all necessary forms for clinical use. This means that healthcare professionals now have a comprehensive set of forms at their disposal, streamlining the data collection process and enhancing the quality of patient care.

  1. Improved HTS Form Functionality:

We have diligently worked on refining the HTS (HIV Testing Services) forms to ensure seamless functionality. Specifically, the HTS Initial and HTS Re-test forms have been fine-tuned to work correctly. This improvement guarantees accurate data capture during HIV testing, aiding healthcare providers in making informed decisions and offering appropriate counseling.

  1. Revamped HIV Green Card Based on User Feedback:

Building upon the feedback received from our users regarding the HIV Green Card in release v1.0.4, we have implemented the requested changes. The updated HIV Green Card now aligns more closely with user preferences and requirements. This enhancement will facilitate improved patient monitoring and management within the system.

We appreciate your continued support and feedback as we strive to enhance the Kenya EMR platform. Please don't hesitate to reach out to our support team if you encounter any issues or have further suggestions. Together, we are advancing towards more efficient and effective healthcare data management.

Assets 3
Loading