This guide will take you through setting up OpenMRS instance and working around with some of the key functionality within OpenMRS environment.

Requirements

Hardware Specifications

The hardware required depends on the size of your implementation. For small implementations, OpenMRS can be run on just about any desktop or laptop.

Minimum Requirements - 100 patients

1 GHz processor or better, 256 MB of memory or more, 40 GB hard drive or larger. You can set up the server on a laptop for demonstration or testing purposes.

Minimum Requirements - 10,000 patients

1.5+ GHz, 2 GB of memory, and 150+ GB of disk space with RAID and appropriate backup facilities.

Minimum Requirements - 250,000 patients

4.52+ GHz quad processors, 16 GB of memory, and 500 GB of disk space with RAID and appropriate backup facilities.

Software Specifications

Java JDK 1.6

OpenMRS Standalone

To run the standalone version, download the ZIP file and decompress it, then double-click the openmrs-standalone.jar file to run it. The first time you run this file, it will configure OpenMRS and open your browser to the new OpenMRS instance.

On Windows operating System
From the command line, you can navigate to the decompressed folder and run the following command: java -jar standalone-1.1.jar

On Linux Use a command line shell to navigate to the decompressed folder and run the following command: ./run-on-linux.sh

Logging In By default, the initial username and password are as follows: * Username: admin * Password: Admin123/test

You must immediately change the admin password after installation for security purposes. To change your password, click My Profile in the upper right of OpenMRS, and choose the Change Login Info tab. Update your password, then click Save Options. You can also change your username, and provide your real name, on this screen.

Stopping and Restarting

As long as OpenMRS is running, you can return to the application by opening the following URL in your browser.
http://localhost:8081/openmrs-standalone/

Before you change certain preferences, such as the port on which MySQL or Tomcat runs, you must stop the application.

To stop the application, use the Stop button in the user interface, or choose File > Quit. Alternatively, run the JAR file on the command line with a -stop parameter.

You can restart the GUI by clicking Start, or double-clicking on the JAR file again. Alternatively, you can run the JAR file with a -start parameter.

By default, OpenMRS runs the MySQL database on port 3316, and the Tomcat server on port 8081. To use a different port, stop the application, then change the port number in the openmrs-standalone-runtime.properties file or in the GUI, and restart. To override the port from the command line, run the JAR file with a -tomcatport or -mysqlport parameter.

Changing the port number will change the URL used to access the application. To access the application, you can choose File > Launch Browser, or run the JAR file with a -browser parameter.

Accessing OpenMRS in A Network Setup

If you are accessing an openmrs instance setup in a network, you can access using your preferred browser the Openmrs Instance by using the ip address of the particular server or pc where Openmrs is installed e.g https://192.168.100.50:8081/openmrs-standalone

Getting Started with OpenMRS

After successfully installing an openmrs instance, login with your assigned username and password and click on the Login button

How To Create A New Patient

That's it; you have now successfully created a patient.

How to Create A Cohort

A cohort is a set of patients with specific characteristics *** Locate Cohort Builder on the menu bar and click on it**

*** Click on Patient Attributes Tab**

*** Specify the parameters the cohort should take by filling the cohort builder form appropriately** Example: Gender=Any, Age between 20 and 40, And click on the save button icon as shown below:

A screen will pop up for you to enter the Name and Description of the cohort you created. Enter the fields with the appropriate name and description and click on save button.

Check if the cohort was created by clicking on the Saved link next to the **Search **text

You are now ready to use mUzima platform.

For mUzima to work with openMRS you need to have the following modules running:

  1. mUzima Forms module
  2. mUzima Registration module
  3. mUzima Processor module
  4. Reporting Compatibility
  5. Latest Rest Web Services
  6. Latest xForms module
  7. mUzima Consultation module [optional]

How To Install A module in OpenMRS

A screen will pop up. Choose browse button to locate the directory where yo have stored module from your machine or install the module from openMRS hosted site by using the Install from Module Repository Section and type in the name of the module and click on install.