Overview

The new OpenMRS Platform (as from 2.0) does not have a user interface. After successfully installing the platform, you will need to install one of the available user interface modules. This wiki will document how to install the legacyUI and the Reference Application on top of the platform.

• Installing LegacyUI module
• Installing the Reference Application module

...

1. Getting the legacyui

...

Why Are You Here?

You are probably seeing this page because you installed the OpenMRS Platform, and saw a nearly-empty screen that linked you here, instead of the EMR you were expecting to see.

Starting with version 2.0 the OpenMRS Platform does not include a built-in user interface. The rationale is that this will enable people to build all sorts of different OpenMRS distributions, using completely different web technologies to build different user interfaces. However, this can be confusing if you installed the raw OpenMRS Platform, but you were looking for a full OpenMRS Distribution (like the Reference Application).

What Can You Do?

If you are a "typical" OpenMRS user and you are looking for a complete OpenMRS application, you probably want to remove this installation, and replace it with one of the out-of-the-box OpenMRS Distributions (like the Reference Application).

If you're sure that you want this version of the OpenMRS Platform, and you want to add a community-supported user interface on top of it, you have a couple of options:

• OpenMRS Reference Application 2.x
• Legacy UI module (the same UI that was included with OpenMRS Platform 1.x)

Anchor
reference reference

Installing the Reference Application

If you are already running the OpenMRS Platform, then you need to add quite a few modules to be running the full Reference Application. You can get these by going to http://openmrs.org/download and looking for a link like "Download Reference Application (version number) Addons". (Make sure to get the version of the reference application that corresponds to the platform version that you are running. Unzip that file, and put all the OMOD files in your modules folder(e.g. ${HOME}/.OpenMRS/modules) or (Windows + R > %appdata%>OpenMRS>Modules), and all the OWA files in your owa folder, and restart the web server.

Anchor
legacyui legacyui

Installing the Legacy UI module

Anchor
legacyui_impl legacyui_impl

For Implementers

1. Get the latest version of the legacyui module from the OpenMRS Module Repository
   Go to https://addons.openmrs.org/#/show/org.openmrs.module.legacy-ui-module and download the latest version. 

2. Install the module
   After the download completes, copy the .omod file (legacyui-{versionNumber}.omod) into the modules directory of your OpenMRS app data folder (e.g. ${HOME}/.OpenMRS/modules) or (Windows + R > %appdata%>OpenMRS>Modules).
3. Restart OpenMRS
   You can do this by either stopping and starting openmrs from tomcat manager page or just restarting tomcat.

Anchor
legacyui_dev legacyui_dev

For Developers

1. Get the latest version of the legacyui module code
   

   Code Block
   git clone https://github.com/openmrs/openmrs-module-legacyui.git

...

1. 
   

2. Build the module

   Code Block

...

1. cd openmrs-module-legacyui

...

1. mvn clean install

       3. Installing into openmrs

...

1. 
   

2. Install the module
   After successfully building the legacyui

...

1. module, you will find it at openmrs-module-legacyui/omod/target

...

1. /legacyui-{version}-SNAPSHOT.omod.
   

...

       4. Verifying the installation

...

1. Take this file and install it, as described in the For Implementers section.
2. Restart OpenMRS
   If you are running jetty in a typical dev environment setup, then kill the already running instance of jetty (

...

1. CTRL + C) and then run

...

           mvn jetty:run

           Now try accessing openmrs from the browser. You should be redirected to the login page. (default username/password is admin/Admin123)

...

1. "mvn jetty:run" again.