Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 6 Next »

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.

Note: A successful installation of Platform 2.0 means you reached up to the point where you see a page telling to install a user interface module.

  1. Getting the legacyui
            git clone https://github.com/openmrs/openmrs-module-legacyui.git

      2. Building the code

           cd openmrs-module-legacyui
           mvn clean install

       3. Installing into openmrs

           After successfully building the legacyui, we now need to install it into our openmrs instance. To do this

  • Look for a .omod file inside  openmrs-module-legacyui/omod/target. It should be something like  legacyui-1.0-SNAPSHOT.omod.
  • Copy the file and paste to ${HOME}/.OpenMRS/modules. Note: if you are on windows,  ${HOME} is usually the my documents folder.

       4. Verifying the installation

           First you need to restart openmrs. To restart here means cancel the already running instance of jetty (using CTRL + C) and then run

           mvn jetty:run

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

Installing LegacyUI Module (for implementers)

  1. Getting the legacyui
    Go to https://modules.openmrs.org/#/search and search for legacyui and download the latest version.
  2. Installing the module
    After the download completes, copy the .omod file (legacyui-{versionNumber}.omod) into the modules directory  of your OpenMRS Installation folder (${HOME}./OpenMRS/modules). Now you have to restart openmrs to load the module.
    You can do this by either stopping and starting openmrs from tomcat manager page or just restart tomcat. The default username/password is admin/Admin123

Installing the Reference Application module

  • No labels