UgandaEMR User Manual
  • Introduction
  • Terminologies
  • System Setup and Configuration
    • UgandaEMR 1.x Installation
    • UgandaEMR 2.x Installation
    • UgandaEMR 3.x Installation
    • Linux Installation
    • Post-installation Configuration
  • Backup and Restoration
    • Linux backup
  • Upgrading UgandaEMR
    • Trouble Shooting
  • Configuring your installation
  • Managing User Accounts
  • Provider Management
    • Creating a New Provider
    • Making an existing user a provider
  • Patient Management
    • Finding Patient
    • Patient Registration
  • Fingerprint
    • Configuration
    • Search by Patient Fingerprint
    • Add Patient Fingerprint
  • Entering Client Information
    • HIV Testing Services Client Card
    • ART Card
    • HIV Exposed Infant Card
    • HIV Counseling and Testing Client Card
    • Maternal and Child Health Cards
    • Safe Male Circumcision
    • Outpatient Form
  • Reporting
    • UgandaEMR Reports
    • Cohort Builder
    • Data Export
    • Sending Report to DHIS2
    • Sending Metrics Report
    • Audit tool Reports
    • Troubleshooting Report Tips
  • Data Quality Checks
  • Patient Provider Notifications
    • Configurations
    • Message Customization
    • Patient Enrollment
    • Patient De-registration
  • Patient Flags
  • Program Workflows
    • Differentiated Service Delivery Models (DSDM)
    • HIV Recency Testing
    • ART Regimen Lines
    • Tuberculosis
    • COVID19
  • Troubleshooting Tips
  • Uninstalling UgandaEMR
    • Unistalling UgandaEMR older versions
  • Point of Care (POC)
    • Installation and Configuration
      • Roles
    • Work Flows
      • Reception
      • Triage
      • Clinician
        • HIV Clinic
      • Laboratory
      • Pharmacy
  • Data Exchange
    • ART Access Integration
    • Viral Load Integration
    • Send Aggregate Reports
    • Patient Data Upload
      • Uploading Viral Load Results
  • UgandaEMR Mobile
    • Introduction
    • Download Patients
  • Release Notes
    • 1.0.14
    • 1.0.16
    • 1.0.17
    • 2.0.0
    • 2.1.0
    • 3.0.0
    • 3.0.4
    • 3.1.0
    • 3.1.3
    • 3.2.0
    • 3.3.0
    • 3.3.7
    • 3.4.1
Powered by GitBook
On this page
  • My installation cannot start
  • UgandaEMR login screen not available yet system starts
  • OpenMRS cannot start - Error creating bean with name "messageSourceServiceTarget"
  • White screen appears when carrying out administrative tasks like module installation, upgrade
  • Cohort Builder does not Allow defining of Columns
  • Root Cause
  • Resolution
  • Client ART Number not Showing
  • Resolution

Was this helpful?

Troubleshooting Tips

PreviousCOVID19NextUninstalling UgandaEMR

Last updated 3 years ago

Was this helpful?

This section contains tips and tricks to help maintain your installation, as well as a general guide to common problems

My installation cannot start

Restart your computer

UgandaEMR login screen not available yet system starts

Error Messages and Screenshots

When you login the screen may display as below:

Resolution

  1. On the Administration page, select the Manage Modules link

  2. Click the Start All button

  3. Restart your computer

OpenMRS cannot start - Error creating bean with name "messageSourceServiceTarget"

Error Messages and Screenshots

Resolution

  1. Delete the folder C:\Application Data\OpenMRS\lucene

  2. Restart your computer

White screen appears when carrying out administrative tasks like module installation, upgrade

Resolution

Restart your computer and repeat the action that caused the error

Cohort Builder does not Allow defining of Columns

Screen Shots Of The Problem

Root Cause

The root cause of this problem is due to the addition of other programs into the UgandaEMR system by an individual( which is prohibited ) that is done by creation of concepts and thereby resulting into concept mismatch with concepts that come with UgandaEMR.

Resolution

  1. Open your command Prompt and login to mysql with the following command without quotes "mysql -u openmrs -p" and provide it with the required password

  2. Run the concept dictionary downloaded on your database in your command prompt

  3. After the concept dictionary is done, run the following script on the same command prompt

    /*!40101 SET @OLD_CHARACTER_SET_CLIENT = @@CHARACTER_SET_CLIENT */;
    /*!40101 SET @OLD_CHARACTER_SET_RESULTS = @@CHARACTER_SET_RESULTS */;
    /*!40101 SET @OLD_COLLATION_CONNECTION = @@COLLATION_CONNECTION */;
    /*!40101 SET NAMES utf8 */;
    /*!40103 SET @OLD_TIME_ZONE = @@TIME_ZONE */;
    /*!40103 SET TIME_ZONE = '+00:00' */;
    /*!40014 SET @OLD_UNIQUE_CHECKS = @@UNIQUE_CHECKS, UNIQUE_CHECKS = 0 */;
    /*!40014 SET @OLD_FOREIGN_KEY_CHECKS = @@FOREIGN_KEY_CHECKS, FOREIGN_KEY_CHECKS = 0 */;
    /*!40101 SET @OLD_SQL_MODE = @@SQL_MODE, SQL_MODE = 'NO_AUTO_VALUE_ON_ZERO' */;
    /*!40111 SET @OLD_SQL_NOTES = @@SQL_NOTES, SQL_NOTES = 0 */;
    
    DELETE from patient_program ;
    DELETE from program;
    
    /*!40101 SET SQL_MODE=@OLD_SQL_MODE */;
    /*!40014 SET FOREIGN_KEY_CHECKS=@OLD_FOREIGN_KEY_CHECKS */;
    /*!40014 SET UNIQUE_CHECKS=@OLD_UNIQUE_CHECKS */;
    /*!40101 SET CHARACTER_SET_CLIENT=@OLD_CHARACTER_SET_CLIENT */;
    /*!40101 SET CHARACTER_SET_RESULTS=@OLD_CHARACTER_SET_RESULTS */;
    /*!40101 SET COLLATION_CONNECTION=@OLD_COLLATION_CONNECTION */;
    /*!40111 SET SQL_NOTES=@OLD_SQL_NOTES */;
  4. Restart your computer

Client ART Number not Showing

Screen Shots Of The Problem

Resolution

  1. Open your command Prompt and login to mysql with the following command without quotes "mysql -u openmrs -p" and provide it with the required password

  2. Run the following script on your database in your command prompt

    REPLACE INTO metadatamapping_metadata_set_member (metadata_set_member_id, metadata_set_id, metadata_class, metadata_uuid, sort_weight, name, description, creator, date_created, changed_by, date_changed, retired, date_retired, retired_by, retire_reason, uuid)
    SELECT 1, 1, 'org.openmrs.PatientIdentifierType', 'e1731641-30ab-102d-86b0-7a5022ba4115',null, null, null, 2, NOW(), null, null, 0, null, null, null,'57c7a9df-193d-4d44-b34a-3156e6204bde';
  3. Refresh your computer browser.

Error messages and Screenshots

Download the concept dictionary from the source

https://sourceforge.net/projects/ugandaemr/files/1.0.13/concept_dictonary_ref_1.0.13.sql/download
Modules not started errors
Modules not started due to cyclic dependencies
OpenMRS cannot start - Error creating bean of name "messageSourceServiceTarget"
Start All Modules
Manage Modules
Login Error no modules started
Error - White Screen during operation