Releases: palladiumkenya/openmrs-config-kenyaemr
KENYAEMR 3.x Facility-Wide v2.2.0 (2025-09-30).
TaifaCare v19.2.2 Release Notes
Sep 2025
Overview
TaifaCare v19.2.2 includes significant enhancements to system performance, user interface improvements, and critical bug fixes aimed at strengthening stability, usability, and interoperability across modules. This release focuses on:
- Case Surveillance
- Lab Manifest
Refer to the attached release notes for more information.
Compatible Products
- OpenMRS warfile 2.6.15
- MySQL 8.0
- Works with DWAPI 3.xLatest tag
Key Updates
Case Surveillance
-Fixed - HEI (24Months) without final documented outcome: Incorrect age in the report and some HEI are discontinued and yet appear in report and some have VL copies and not enrolled in HIV.
-Fixed - Delayed Viral Load Testing: Clients not eligible for VL are appearing in the case surveillance report.
-Fixed - Delayed Enhanced Adherence Counselling: Clients appearing with LDL appearing in report and yet no EAC is required, and baseline viral load is not initiated on ART are not eligible to EAC.
-Case Surveillance Report reconciled with Case Surveillance Dashboard.
-New HIV Surveillance tab & indicators in Case Surveillance Report.
-Dropped case surveillance indicators from CAR Report.
For Upgrade Instructions
Refer to the upgrade user manual on how to upgrade your instance of KenyaEMR.
Remember to run the post_upgrade.sh script
Facility Surveillance Dashboard Guide is available:
https://kenyahmis.org/wp-content/uploads/2025/03/Facility-Surveillance-Dashboard.pdf
Support
For any questions or assistance, please contact our Helpdesk:
- Toll-free: 0800 722 440
- Email: help@palladiumgroup.on.spiceworks.com
HIE Integration Note:
Configuration for integrating with the HIE will be provided separately following the upgrade.
Feedback
We value your feedback! Please report any issues or suggestions to help us improve KenyaEMR in future releases.
Thank you for using KenyaEMR. We're committed to continually improving our system to better serve healthcare providers and patients across Kenya.
KENYAEMR 3.x Facility-Wide v2.1.1 (2025-08-27).
TaifaCare v19.2.1 Release Notes
Aug 2025
Overview
TaifaCare v19.2.1 includes significant enhancements to system performance, user interface improvements, and critical bug fixes aimed at strengthening stability, usability, and interoperability across modules. This release focuses on:
- System Enhancements
- Billing
- Clinical Forms
- Reporting
Refer to the attached release notes for more information.
Compatible Products
- OpenMRS warfile 2.6.15
- MySQL 8.0
- Works with DWAPI 3.xLatest tag
Key Updates
Enhancements Highlights
-Ensure PHQ9 scores persisted in the database in depression screening extract and transmitted in the NDWH.
-Enabled radiology reports to be attached directly into EMR system alongside structured reports.
-Added departmental reports (OPD, Eye, Physiotherapy, Special Clinics, IPD, Pharmacy).
-Implemented compartment allocation in bed management with feature flag.
-Added support for Deposit for admission and surgery as variable patient services.
-Updated dispensing app to display vitals in patient profile.
-Enhanced dispensing UI by improving visibility of dispensing fields (dose, route, frequency).
-Avail search field in manifests to easily find patients.
Billing
-Fixed cashier module: only admin could create bills in Pharmacy/Lab now open to configured users.
-Corrected billable items sharing concept IDs (e.g. billing suspension vs. tablet).
-Prevented previous unclosed bills from appearing in new bills.
-Fixed inpatient invoices to include hospital logo & name.
-Resolved issue with inpatient bill doubling/multiple erroneous payments.
-Improved payment mode editing – validation on payment mode attributes.
Case Surveillance
-Fixed - HEI (24Months) without final documented outcome: Incorrect age in the report and some HEI are discontinued and yet appear in report and some have VL copies and not enrolled in HIV.
-Fixed - Delayed Viral Load Testing: Clients not eligible for VL are appearing in the case surveillance report.
-Fixed - Delayed Enhanced Adherence Counselling: Clients appearing with LDL appearing in report and yet no EAC is required, and baseline viral load is not initiated on ART are not eligible to EAC.
-Case Surveillance Report reconciled with Case Surveillance Dashboard.
-New HIV Surveillance tab & indicators in Case Surveillance Report.
-Dropped case surveillance indicators from CAR Report.
Reporting
-Added HPV-negative screening results to Cervical Cancer Register.
-Created reports for clinician workload (patients seen per clinician).
-Renamed DMI Scheduler to Program Monitoring.
-PHQ9 depression screening scores persisted in NDWH extracts.
-Added two new facilities in ML HTS Matrix.
-Added special clinics to Appointment Types
MOH Registers:
- MOH 240 Lab Register enhanced to pull correct data.
- MOH 240 Lab Register added to KenyaEMR 3.x for facility-wide reporting.
- MOH 270 Diabetes & Hypertension Permanent Register created.
- MOH 740 Diabetes & Hypertension Monthly Summary created.
- MOH 301 Inpatient Register created.
- Daily Bed Return (DBR) for inpatient added.
- MOH 705 A&B disease list aligned with ICD-11 mapping.
For Upgrade Instructions
Refer to the upgrade user manual on how to upgrade your instance of KenyaEMR.
Remember to run the post_upgrade.sh script
Facility Surveillance Dashboard Guide is available:
https://kenyahmis.org/wp-content/uploads/2025/03/Facility-Surveillance-Dashboard.pdf
Support
For any questions or assistance, please contact our Helpdesk:
- Toll-free: 0800 722 440
- Email: help@palladiumgroup.on.spiceworks.com
HIE Integration Note:
Configuration for integrating with the HIE will be provided separately following the upgrade.
Feedback
We value your feedback! Please report any issues or suggestions to help us improve KenyaEMR in future releases.
Thank you for using KenyaEMR. We're committed to continually improving our system to better serve healthcare providers and patients across Kenya.
KENYAEMR 3.x Facility-Wide v2.1.0 (2025-06-05).
TaifaCare v19.2.0 Release Notes
June 2025
Overview
TaifaCare v19.2.0, formerly known as KenyaEMR, brings a refreshed identity along with a range of functional improvements. The release introduces the official rebranding of TaifaCare powered by KenyaEMR, a tailored distribution of OpenMRS. In addition to the branding update, v19.2.0 includes significant enhancements to system performance, user interface improvements, and critical bug fixes aimed at strengthening stability, usability, and interoperability across modules
Refer to the attached release notes for more information.
Compatible Products
- OpenMRS warfile 2.6.15
- MySQL 8.0
- Works with DWAPI 3.xLatest tag
Key Updates
New Features
This release focuses on:
- Case Surveillance
- Commodity Management
- Forms Fixes and Validation Updates
- New Features and Improvements.
- Role Based Access Management.
Enhancements Highlights
- Enhancement on the system to support Retrospective Data Entry on Forms, Lab and drugs.
- Avail reason for requesting imaging orders visibility in the Imaging Orders module by the radiographers.
- Initiate billing of drugs from the Pharmacy to ensure efficient client flow.
- Indicate service where Transactions operation occurred.
- Add ability to order test from the imaging panel.
- Allow a drug order request for an already prescribed drug order with a provision to provide a reason for reordering.
- Allow Pharmacists to fill Quantity to dispense and remove from Prescription Order.
- Allow Pharmacists to modify prescriptions (Change duration and even to an extent, drugs)
- Add prescriptions weekly and monthly. If the user prescribes daily the system issues more drugs than what the client has been issued.
- Modify prescription to be applied to all prescriptions and not just those with bills.
- Service queues - Rename label from Change to Move.
- Add Age, Gender and clinical diagnosis as part of the patient info on the orders panel.
- Add ability to view results in lab panel.
- Increase the size of the clinical Notes in NCD follow up form.
- Update Clinical Encounter Forms with ICD11 Codes.
- Make CPIMS ID mandatory in the OVC enrollment form and correct the inform alert.
- Avail partograph and Nursing cardex forms.
- Auto-populate the variables already captured in the previous forms.
Bug Fixes Highlights
- Fixed - Diagnosis, Lab results and Vitals missing from the dispensing app.
- HIV Risk scores are not being saved in the database.
- The downloadable Appointment excel still has a column Gender.
- Fixed - Users have repeatedly indicated challenges with Refresh Tables on EMR ETL module.
- Fixed - milligram units are missing under quantity unit.
- Previously entered Clinical encounter forms and progress notes do not save when edited.
- Ensure all filled forms for a client have a provider indicated.
- Fixed - Contact form save button is deactivated until the 3 names of the contacts are filled. A need to change to allow first and last names to save the form.
- Fixed - In-Patient Form (Error on IPD procedure and Newborn Unit Admission form).
- Fixed - There is an error when updating the relationship start date for Index Case Testing clients. The form does not save.
- Fixed - Violence Screening Forms Not Rendering.
Case Surveillance
- Transmission of real time data for Case surveillance above site dashboards.
- Add case surveillance Summary to Facility Dashboard.
Commodity Management
- Add negative and positive adjustments to stock operations.
- Auto-populate person responsible for all transactions/ operations.
- Retain only batch numbers with existing stock and order by expiry date.
- Show/render the expiry date when doing an issue of stock operation.
- Align the clinician roles to allow access to the stock balances while prescribing a drug.
Reporting
- SHA- Number for inclusion in Active line-list.
- Add a column for TB screening in active on ART line list.
- Display the Daily Nutrition Registers 407A and B.
- Add MOH 240 - Lab Register in the KenyaEMR 3.X for facility wide reporting.
- Add Orthopedic Trauma Register MOH.
- Create Therapeutic Play Summary MOH 755.
- Create Eye Register MOH 416.
For Upgrade Instructions
Refer to the upgrade user manual on how to upgrade your instance of KenyaEMR.
Remember to run the post_upgrade.sh script
Facility Surveillance Dashboard Guide is available:
https://kenyahmis.org/wp-content/uploads/2025/03/Facility-Surveillance-Dashboard.pdf
Support
For any questions or assistance, please contact our Helpdesk:
- Toll-free: 0800 722 440
- Email: help@palladiumgroup.on.spiceworks.com
HIE Integration Note:
Configuration for integrating with the HIE will be provided separately following the upgrade.
Feedback
We value your feedback! Please report any issues or suggestions to help us improve KenyaEMR in future releases.
Thank you for using KenyaEMR. We're committed to continually improving our system to better serve healthcare providers and patients across Kenya.
KENYAEMR 3.x Facility-Wide v2.0.0 (2025-03-11).
KenyaEMR v19.1.4-SNAPSHOT Release Notes
March 2025
Overview
This release brings significant improvements and bug fixes to enhance the overall functionality and user experience of KenyaEMR. The update focuses on form validations, clinical workflow improvements, and new features to streamline healthcare delivery.
Refer to the attached release notes for more information.
Compatible Products
- OpenMRS warfile 2.6.1
- MySQL 8.0
- Works with DWAPI 3.xLatest tag
Key Updates
New Features
- Case Surveillance Facility Dashboards for tracking:
- HIV Positive Clients not linked to ART
- High-risk pregnant/postpartum women not linked to PrEP
- HEI without DNA PCR results and final documented outcomes
- Virally unsuppressed clients without enhanced adherence counseling
- Delayed Viral Load testing
- Printing Functionality for prescription orders, stock operations, and imaging reports
- Additional MOH Reports and Registers (204 A&B, 711, 717, and 705 A&B)
- Billing Improvements including waiver/exemptions reports and paid bill receipt preview
Form Updates and Validation
- Added Physical Assessment section to Triage form
- Enhanced COVID-19 Assessment, HTS Eligibility, and GOPC forms
- Added Cross Border screening form
- Updated Transfer to Facility functionality
- Enhanced clinical workflow conformity across multiple forms (Fertility, Gastroenterology, Special clinics)
Bug Fixes
- Fixed MOPC Form saving issue with Physiotherapy selection
- Fixed error loading billing exemptions tree node (#596)
- Resolved lab order requests from clinical encounter form
- Fixed refund functionality
- Fixed unresolved backend dependencies errors
- Corrected stock reports to show location name instead of UUID
- Fixed CWC number to include year part for cohort distinction
- Fixed HIV patient summary printing issues
Terminology Updates
- Updated population type terminology for compliance
- Renamed "Gender-based violence" to "Violence screening" throughout the system
- Removed Transgender variable from various forms and reports
For Upgrade Instructions
Refer to the upgrade user manual on how to upgrade your instance of KenyaEMR.
Facility Surveillance Dashboard Guide is available:
https://kenyahmis.org/wp-content/uploads/2025/03/Facility-Surveillance-Dashboard.pdf
Support
For any questions or assistance, please contact our Helpdesk:
- Toll-free: 0800 722 440
- Email: help@palladiumgroup.on.spiceworks.com
Feedback
We value your feedback! Please report any issues or suggestions to help us improve KenyaEMR in future releases.
Thank you for using KenyaEMR. We're committed to continually improving our system to better serve healthcare providers and patients across Kenya.
KENYAEMR 3.x Facility-Wide v1.11 (2024-11-14).
KenyaEMR v19.1.3 Release Notes
November 2024
⚠️ IMPORTANT UPGRADE NOTICE
This upgrade is only compatible with KenyaEMR version 19.1.0 and above. Please ensure your system meets this minimum version requirement before proceeding with the upgrade.
Overview
KenyaEMR v19.1.3 introduces significant improvements and bug fixes focused on enhancing overall functionality and user experience. Key focus areas include form improvements, validation updates, and new feature implementations.
System Requirements
- OpenMRS warfile 2.6.1
- MySQL 8.0
- Compatible with DWAPI v3122
Forms and Validation Updates
MCH (Maternal and Child Health) Updates
- Fixed visit date/time validation for delivery form
- Relaxed EDD validation in MCH enrollment form
- Updated MCH Antenatal form with syphilis workflow
- Removed ANC clinic number from MCH Antenatal form
- Updated ANC number format on MCH enrollment form
- Modified MCH discontinuation form to use date field instead of text
- Fixed issues with delivery form saving
HIV Care Updates
- Expanded family planning form access to all female clients of reproductive age
- Enhanced PrEP Initial form to include Partner Profile
- Removed "Cannot afford Treatment" and "Unknown" options from HIV Discontinuation form
- Added correct options for Morisky 8 section in HIV Green Card
- Removed facility field capture on HIV Enrollment Form
VMMC Updates
- Enhanced "discharged by" field in VMMC Immediate Post Operation Assessment
- Changed time-of-Placement to datetime in VMMC Circumcision Procedure form
Other Form Updates
- Updated ENT Form with expanded examination findings concept
- Fixed KVP Contact form editing redirect issue
- Updated beach concept on KVP Contact form
- Enhanced ENT form with additional history and examination documentation
New Features and Improvements
Clinical Features
- Added Speech and Language Therapy special clinic and form
- Included Adverse Drug Reaction Form
- Added Unique Encounter UUID for diabetic clinic
- Added TAF (Tenofovir Alafenamide) and TDF (Tenofovir Disoproxil Fumarate) under non-standard regimen in 3.x
- Enhanced Viral Load Order reasons
- Updated Concept dictionary for missing drugs
Billing and Payment Features
- Added capability to capture reasons for waiving, editing, and waiving bills
- Implemented ability to add and edit full payment mode attributes
- Prevented processing orders with pending bills
- Added patient information display to "No Bills" component
- Activated delete button in Bill manager with reason requirement
- Include option to configure additional Payment Point.
- Revised Billing receipt to include:
- Hospital Name
- Date and time
- Patient ID
- Receipt Number
- Patient Name
- Age
- Payment details (Item and price)
- Total Amount
- Payment Reference number from Mpesa
- Served by
- Recovery wishes message
System Administration
- Configured peer calendar for peer educator role
- Added location tag for cash points
- Added medical supplies order type
- Added lab manifest view to Lab technician role
- Made exemptions configurable per facility through lab module
- Fixed family planning encounter type
- Added relationship details editing capability
- Fixed DMI transmission to staging area
- Resolved care panel access errors for certain clients
Installation
Please refer to the upgrade user manual for detailed instructions on upgrading your KenyaEMR instance.
For more detailed information about these changes or if you encounter any issues, please refer to the project documentation or contact the support team.
Support
For any questions or assistance, please contact our Helpdesk:
- Toll-free: 0800 722 440
- Email: help@palladiumgroup.on.spiceworks.com
Feedback
We value your feedback! Please report any issues or suggestions to help us improve KenyaEMR in future releases.
Thank you for using KenyaEMR. We're committed to continually improving our system to better serve healthcare providers and patients across Kenya.
KENYAEMR 3.x Facility-Wide v1.10.27 (2024-10-02).
KenyaEMR-3.x v19.1.2 Release Notes
Overview
KenyaEMR v19.1.2 brings significant improvements and bug fixes to enhance the overall functionality and user experience of the system. This release focuses on:
- Enhancing clinical modules, including updates to the Endocrine system, Physical Examination, and MCH-ANC protocols.
- Improving data capture and management for various programs, including NCD, HTS, and Cancer screening.
- Addressing critical bugs in form saving, lab orders, and result viewing.
- Renaming and adjusting forms to align with current terminology and practices.
- Implementing new features such as the maxillofacial clinic and updating the HTS ML model.
These changes aim to improve the efficiency of healthcare providers, enhance data accuracy, and provide better support for patient care across various clinical areas.
DWAPI Compatibility: This version is compatible with DWAPI v3122 tag
Upgrading DWAPI to v3122 tag
sudo docker ps -a | grep "dwapi" | awk '{print $1}' | xargs sudo docker rm -f
sudo docker images -a | grep "dwapi" | awk '{print $3}' | xargs sudo docker rmi
sudo docker run --name dwapi -p 5757:5757 -p 5753:5753 -d --restart unless-stopped kenyahmis/dwapi:v3122
New Features and Improvements
- Updated Endocrine system and Physical Examination
- Enhanced MCH-ANC: Intermittent presumptive treatment dose now given up to 5th dose
- Renamed Clinic visit forms from KP to KVP
- Renamed HCW Overdose reporting tool to Opioid Overdose encounter
- Updated Billing version to allow editing billable services with decimal numbers
- Implemented HTS ML new PMML Model
- Added CD4 count order reasons
- Created maxillofacial_clinic
- Updated missing presenting complaints in Triage form
- Adjusted HTS Eligibility screening age to start from 18 months and above
Bug Fixes
- Rectified MAT_Psycho_social_Intake_Follow_up_Form saving
- Fixed Result viewer not showing results of individual test ordered
- Resolved issue where CPMIS unique identifier was picked as an observation instead of a unique identifier
- Fixed NCD Enrollment failure to save when drug (HYDROCHLOROTHIAZIDE) is selected
- Addressed issue with lab results showing added zeros
- Fixed error while saving CD4 lab order
- Fixed error while creating TB LAM order
- Fixed error while saving TB LAM orders
- Resolved PNS Relationship failure to display all recorded contact information
Form and Validation Updates
- Implemented changes to support form saving for NCD Init_Follow-up
- Added cancer screening validations for Male and Female clients
- Relax the validation on HIV Discontinuation form to allow a future Effective Discontinuation Date
For more detailed information about these changes or if you encounter any issues, please refer to the project documentation or contact the support team.
Support
For any questions or assistance, please contact our Helpdesk:
- Toll-free: 0800 722 440
- Email: help@palladiumgroup.on.spiceworks.com
Feedback
We value your feedback! Please report any issues or suggestions to help us improve KenyaEMR in future releases.
Thank you for using KenyaEMR. We're committed to continually improving our system to better serve healthcare providers and patients across Kenya.
KENYAEMR 3.x Facility-Wide v1.10.26 (2024-08-23) with Revised Tools Changes
KenyaEMR V19.1.0 August 2024 Release
Overview
This release focuses on Revised Tools changes and Facility Wide Bug fixes for the KenyaEMR system.
Compatibility
- OpenMRS warfile 2.6.1
- MySQL 8.0
- Compatible with DWAPI latest tag
Key Features
Revised Tools Changes
- Enhanced HIV green card
- Improved Triage form
- Updated HIV enrollment form
- Enhanced ANC, Delivery, and PNC forms
- Improved Child Welfare Services forms
- Updated HTS-related forms
- Enhanced PrEP Initiation and Violence reporting forms
- Improved Clinical Enrollment and Contact forms
- Updated Opioid Overdose encounter form
- Enhanced various registers (ANC, Delivery, Postnatal, HEI, etc.)
Facility Wide KenyaEMR Fixes
- HTS ML Model enhancements
- Data Modernization Initiative improvements
- User Roles Alignment
- Enhanced billing management
- Improved stock management and drug list alignment
- Added non-pharmaceuticals support
- Improved dispensing and quantification features
- Enhanced NCD Service Type management
- Various test and diagnostic improvements
Installation and Training Materials
For detailed installation instructions, and training resources, please visit:
https://kenyahmis.org/kenyaemr-3-x-content/
NB:
The system is now role based with the introduction of 03 roles. Please be sure to grant the clinicians both Clinician and
o3: Doctors/Clinicians/Specialists roles.
Upon upgrade, import the stock items using the import feature found under the Manage Stock app in the Items menu. The Import_Stock_Items.csv file, located in the stock folder under scripts, is included in the package for this purpose.
Thankyou for your continuous support.
Support
For any questions or assistance, please contact our Helpdesk:
- Toll-free: 0800 722 440
- Email: help@palladiumgroup.on.spiceworks.com
Feedback
We value your feedback! Please report any issues or suggestions to help us improve KenyaEMR in future releases.
Thank you for using KenyaEMR. We're committed to continually improving our system to better serve healthcare providers and patients across Kenya.
KENYAEMR 3.x Facility-Wide v1.10.25 (2024-07-24) with Nginx
KenyaEMR v19.0.0 Release Notes with nginx Configuration
Overview
This release introduces KenyaEMR v19.9.0 for the 3.x platform, running on MySQL 8. It brings significant enhancements, new features, and important bug fixes to improve the overall functionality and user experience of the system.
Important Notes
- Prerequisite Upgrade: You must have upgraded to KENYAEMR3.X_FACILITY_WIDE_v1.10.23_MON-2O-MAY-2024 before proceeding with this upgrade.
- DWAPI Compatibility: This version is compatible with the latest version of DWAPI (Data Warehouse and Analytics Platform Interface).
- Nginx Configuration: Proper Nginx setup is crucial for optimal performance gains. Please follow the installation guide carefully.
New Features and Enhancements
-
Nginx Integration for Performance Boost
- Implemented Nginx as a reverse proxy to significantly reduce page load times.
- Improved handling of concurrent connections for better system responsiveness.
- Enhanced static content delivery and caching mechanisms.
-
Appointment Form Enhancement
- Now supports retrospective documentation of appointments, providing greater flexibility in managing patient schedules.
-
IIT Risk Scores Optimization
- Significantly reduced processing time for generating Interruption in Treatment (IIT) Risk Scores, improving system performance.
-
Order Basket Expansion
- Added capability to include Radiology and Procedures in the Order Basket, streamlining the ordering process.
-
Contact Listing Feature
- Introduced a new feature for listing and managing patient contacts.
-
Automatic KP Identifier Generation
- Implemented functionality to auto-generate Key Population (KP) identifiers, enhancing data management for this group.
Retired Features
- The Missed Appointment Report has been retired in this version.
Bug Fixes
- Various bug fixes have been implemented to improve system stability and reliability. (Detailed list of fixes can be provided upon request)
System Requirements
- Platform: KenyaEMR 3.x
- Database: MySQL 8
Installation and Training Materials
Comprehensive Guide: Setting up Nginx for OpenMRS with Tomcat as backend
This guide will walk you through the process of installing Nginx and configuring it for OpenMRS with a Tomcat backend. We'll include necessary validations and explanations at each step.
1. Install Nginx
sudo apt-get update
sudo apt-get install nginxValidation:
After installation, check if Nginx is running:
sudo systemctl status nginxYou should see "active (running)" in the output.
2. Configure Nginx for OpenMRS
-
Open the Nginx configuration file:
sudo nano /etc/nginx/sites-available/default
-
Replace the contents with the following configuration:
upstream backend_assets { server localhost:8081; } server { listen 8080; server_name _; root /var/lib/OpenMRS/frontend; # CORS configuration add_header 'Access-Control-Allow-Origin' '*' always; add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS, PUT, DELETE' always; add_header 'Access-Control-Allow-Headers' 'DNT,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Range,Authorization' always; add_header 'Access-Control-Expose-Headers' 'Content-Length,Content-Range' always; location /openmrs/ { proxy_pass http://backend_assets; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; proxy_cache_valid 200 60m; proxy_cache_use_stale error timeout http_500 http_502 http_503 http_504; # CORS headers for proxied requests add_header 'Access-Control-Allow-Origin' '*' always; add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS, PUT, DELETE' always; add_header 'Access-Control-Allow-Headers' 'DNT,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Range,Authorization' always; add_header 'Access-Control-Expose-Headers' 'Content-Length,Content-Range' always; } # accessing legacy location ~ ^/openmrs/(kenyaemr|reports|admin|ms|scripts|moduleResources|dwr) { proxy_pass http://backend_assets; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; } # proper redirections location / { tcp_nopush on; keepalive_timeout 65; proxy_cache_valid 200 60m; proxy_cache_use_stale error timeout http_500 http_502 http_503 http_504; try_files $uri /index.html; } # CSS files location ~* \.css$ { add_header Content-Type text/css; proxy_cache_valid 200 60m; proxy_cache_use_stale error timeout http_500 http_502 http_503 http_504; } # JavaScript files location ~* \.js$ { add_header Content-Type application/javascript; proxy_cache_valid 200 60m; proxy_cache_use_stale error timeout http_500 http_502 http_503 http_504; } location ^~ /openmrs/spa/ { alias /var/lib/OpenMRS/frontend; try_files $uri /var/lib/OpenMRS/frontend/index.html; # Rewrite to check assets from root location ~* ^/openmrs/spa/(.+\.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|json|eot))$ { sendfile on; sendfile_max_chunk 1m; # Cache Prevention Start proxy_ignore_headers Cache-Control; add_header Last-Modified $date_gmt; add_header Cache-Control 'no-store, no-cache, must-revalidate, proxy-revalidate, max-age=0'; if_modified_since off; expires off; etag off; proxy_cache_valid 200 60m; proxy_cache_use_stale error timeout http_500 http_502 http_503 http_504; try_files /$1 =404; } } location = / { rewrite ^ /openmrs/ permanent; } location = /openmrs/spa { rewrite ^ /openmrs/spa/ permanent; } location = /openmrs/spaa { rewrite ^ /openmrs/spa/ permanent; } # Enable gzip compression gzip on; gzip_vary on; gzip_proxied any; gzip_comp_level 6; gzip_types text/plain text/css text/xml application/json application/javascript application/rss+xml application/atom+xml image/svg+xml; error_log /var/log/nginx/openmrs_error.log; access_log /var/log/nginx/openmrs_access.log; }
-
Save and exit the editor (in nano, press Ctrl+X, then Y, then Enter).
Validation:
Check the Nginx configuration for syntax errors:
sudo nginx -tYou should see "syntax is okay" and "test is successful".
3. Configure Tomcat
Ensure Tomcat is configured to run on port 8081 as specified in the Nginx upstream configuration:
-
Open the Tomcat server configuration file:
sudo nano /var/lib/tomcat9/conf/server.xml
-
Find the Connector element and ensure it's set to port 8081:
<Connector port="8081" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" />
-
Save and exit the editor.
-
remove SPA module
rm /var/lib/OpenMRS/modules/spa-1.0.9-SNAPSHOT.omodValidation:
Check if port 8081 is not already in use:
sudo netstat -tuln | grep 8081If this command returns no output, the port is free to use.
4. Restart Services
Restart both Tomcat and Nginx to apply the changes:
sudo systemctl restart tomcat9
sudo systemctl restart nginxValidation:
Check if both services are running without errors:
sudo systemctl status tomcat9
sudo systemctl status nginxBoth should show "active (running)" without any error messages.
5. Final Validation
- Test the Nginx configuration:
Open a web browser and navigate tohttp://localhost:8080/openmrs/
You should see the OpenMRS login page or welcome screen.
Troubleshooting
- If you encounter issues, check the Nginx error logs:
sudo tail -f /var/log/nginx/openmrs_error.log
- For Tomcat issues, check its logs:
sudo tail -f /var/log/tomcat9/catalina.out
Notes on the Nginx Configuration
- This configuration sets up Nginx to listen on port 8080 and proxy requests to a Tomcat server running on localhost:8081.
- It includes CORS headers to allow cross-origin requests.
- There are specific rules for handling static files (CSS, JS) and the OpenMRS Single Page Application (SPA).
- Gzip compression is enabled for better performance.
Ensure that your OpenMRS application is properly set up in the specified directories, particularly the frontend files in /var/lib/OpenMRS/frontend.
KENYAEMR3.X_FACILITY_WIDE_v1.10.25_WED-24-JUL-2024
KenyaEMR v19.0.0 Release Notes
Overview
This release introduces KenyaEMR v19.0.0 for the 3.x platform running on MySQL 8, marking a significant leap forward in performance and functionality. Key highlights include:
- Feature Enhancements: Several new features and improvements to existing functionalities for a more efficient user experience.
- Bug Fixes: Addressed various issues to improve system stability and reliability.
Important Notes
- Prerequisite Upgrade: You must have upgraded to KENYAEMR3.X_FACILITY_WIDE_v1.10.23_MON-2O-MAY-2024 before proceeding with this upgrade.
- DWAPI Compatibility: This version is compatible with the latest version of DWAPI.
New Features and Enhancements
-
Appointment Form Enhancement
- Now supports retrospective documentation of appointments, providing greater flexibility in managing patient schedules.
-
IIT Risk Scores Optimization
- Significantly reduced processing time for generating Interruption in Treatment (IIT) Risk Scores, improving system performance.
-
Order Basket Expansion
- Added capability to include Radiology and Procedures in the Order Basket, streamlining the ordering process.
-
Contact Listing Feature
- Introduced a new feature for listing and managing patient contacts.
-
Automatic KP Identifier Generation
- Implemented functionality to auto-generate Key Population (KP) identifiers, enhancing data management for this group.
Retired Features
- The Missed Appointment Report has been retired in this version.
Bug Fixes
- Various bug fixes have been implemented to improve system stability and reliability. (Detailed list of fixes are provided,check assets for release notes)
System Requirements
- Platform: KenyaEMR 3.x
- Database: MySQL 8
- Web Server: Nginx (for optimal performance)
Installation and Training Materials
For detailed installation instructions, and training resources, please visit:
https://kenyahmis.org/kenyaemr-3-x-content/
Support
For any questions or assistance, please contact our Helpdesk:
- Toll-free: 0800 722 440
- Email: help@palladiumgroup.on.spiceworks.com
Feedback
We value your feedback! Please report any issues or suggestions to help us improve KenyaEMR in future releases.
Thank you for using KenyaEMR. We're committed to continually improving our system to better serve healthcare providers and patients across Kenya.
KENYAEMR3.X_FACILITY_WIDE_v1.10.23_MON-2O-MAY-2024
This release introduces KenyaEMR v18.8.0 for the 3.x platform It runs on MySQL 8
NB:
-
You need to have upgraded to KENYAEMR3.X_FACILITY_WIDE_v1.10.22_MON-22-APR-2024 before running this upgrade -
This version works with the latest version of DWAPI
Main Features
- Lab Manifest for non-HIV tests
- Enhancements of the forms to include the appointment launcher to manage appointments.
- Bug Fixes
Installation and Training Materials
https://kenyahmis.org/resources/
Call Helpdesk for any questions 0800 722 440 or email [help@palladiumgroup.on.spiceworks.com] (mailto:help@palladiumgroup.on.spiceworks.com)