This guide will take you through setting up OpenMRS instance and working around with some of the key functionality within OpenMRS environment.
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 patients1 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 patients1.5+ GHz, 2 GB of memory, and 150+ GB of disk space with RAID and appropriate backup facilities.
Minimum Requirements - 250,000 patients4.52+ GHz quad processors, 16 GB of memory, and 500 GB of disk space with RAID and appropriate backup facilities.
Software SpecificationsJava JDK 1.6
OpenMRS StandaloneTo 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 SetupIf 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 OpenMRSAfter successfully installing an openmrs instance, login with your assigned username and password and click on the Login button
How To Create A New Patient
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:
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.