System Administration OWA

More Metadata Management in Admin UI project is one of the GSoC projects which are designed to migrate some of these administrative functionalities to the modern open web app view. In the System Administration OWA project, We focused on the following functionalities,

Manage modules
System Information
Manage Scheduler

Implementation

Used technologies for the developments,

Front End Development : HTML, CSS, Angular JS, jQuery
Back End Development: Java, REST API

Manage Modules

This feature will be used to manage the modules in the OpenMRS reference application. Users can use this implementation for these following functionalities, Features of the Manage Modules

List all the installed Module — New Icons used to indicate the module status
Start the module
Stop the module — Confirmation Popup will be shown with the dependent modules details to alert the user
Delete/Unload the module — Confirmation Popup will be shown with the dependent modules details to alert the user
Check updates — Module updates will be checked with OpenMRS AddOns and listed in the new page for
the user selection.
Check one module update — Check the update with OpenMRS AddOns and indicate the update status
Start All Modules — No Modifications
Add/Upgrade Modules — Implemented Drag and Drop feature
Search Modules — Connected with OpenMRS Add-ons and user can search the module independently
Search Module Information — User can view the detailed information about the searched module
Module Information View — Used to display the module information with required modules, aware of modules,
and depend on module details
View not installed module information — Connected with OpenMRS add-ons and indicate the user about the installation features.

System Information

This feature will be used to display the System information about the OpenMRS server and the system. Users can use this feature to get this following information,

OpenMRS Information
Operating System Information
Java Runtime Information
User Information
Memory Information
Database Information
Module Information

Manage Scheduler

This feature will be used to manage the tasks in the OpenMRS reference application. Users can use this implementation for this following functionalities, Features of the Manage Modules

List all the installed Module — New Icons and UI used to indicate the module status
Schedule Task — No Modifications
Shutdown Task — Confirmation Popup will be shown to alert the user
Reschedule Task — It will reschedule the existing task in the system
Delete Task — Confirmation Popup will be shown to alert the user
Reschedule All Tasks — It will reschedule all the tasks in the system
Shutdown All Tasks — It will shut down all the tasks in the system
Startup Tasks — It will reschedule all the tasks in the system
Refresh Tasks — It will refresh the list of registered tasks
Add New Task Definition — Used to create new Task Definition, Implemented new UI for this functionality
Edit Task Definition — Used to edit existing Task Definition, Implemented new UI for this functionality

How to run the SysAdmin OWA in the Reference Application

You should install these following modules to run the SysAdmin OWA in your reference application,

Requirements for the SysAdmin OWA - Version 1.0.0

Open web app module - version 1.7 or greater
Web Services REST module - version 2.21 or greater

If you do not have those modules, Please follow these commands to install them,

mvn openmrs-sdk:install -DartifactId=owa -Dversion=1.7-SNAPSHOT -DserverId=adminmodule
mvn openmrs-sdk:install -DartifactId=webservices.rest -Dversion=2.21 -DserverId=adminmodule

Please follow this steps to install and run the SysAdmin OWA in your Reference Application.

Go to OpenMRS Add-Ons official website and Search for SysAdmin OWA
Download the latest version of the SysAdmin OWA as the ZIP file
Run your OpenMRS Server and log in as Admin user
Go to Manage Open Web Apps page through the Administrative Page
Upload this downloaded ZIP and install the OWA to the server.
Now you have loaded the OWA and can see the updated list in the Manage Open Web app page
Click on the SysAdmin OWA and start running.

Create OWA Icon in the homepage

If you want to add Icon to the home page, then follow this use full tutorial to add the Icon.

https://openmrs.atlassian.net/wiki/display/docs/Adding+OWA+Icon+to+the+Reference+Application+Homepage

How to Contribute to the Project

You need the following skills to contribute this project,

Better understanding of AngularJs and jQuery development
REST Web Services and OpenMRS APIs
Knowledge of HTML, CSS
If you want to contribute on this backend, you want to work with JAVA.

Please go and download the project source code from the GitHub repository. Then follow the past discussion on the OpenMRS talk forum and understand the development flow.

Production build steps

You will need NodeJS 4+ installed to do this. See the how to install instructions here.

Once you have NodeJS installed, you need to install Gulp and Bower (first time only) as follows:
npm install -g gulp bower

Install the dependencies (first time only):
npm install && bower install

Build the distributable using Gulp as follows:
gulp

This will create a file as SystemAdminstration.zip in the dist directory, which wants to be uploaded to the OpenMRS Open Web Apps module.

Documentation