Eureka! Clinical User Webapp

Georgia Clinical and Translational Science Alliance (Georgia CTSA), Emory University, Atlanta, GA

What does it do?

It provides web pages for users to manage their user profiles and change their password. It also implements a proxy servlet and router for web clients to access the web services provided by eurekaclinical-user-service.

Latest release:

Version 2.0

Version 2.0 removes all of the servlets and turns this project into an API gateway for the Eureka! Clinical User Web Client.

Version 1.0

Initial release.

Build requirements

• Oracle Java JDK 8
• Maven 3.2.5 or greater

Runtime requirements

• Oracle Java JRE 8
• Tomcat 7
• Also running
  • The eurekaclinical-user-service war
  • The cas-server war

Proxied REST APIs

You can call all of eurekaclinical-user-service's REST APIs through the proxy. Replace /protected/api with /proxy-resource. The point of doing this is for web clients -- you can deploy the webapp on the same server as web client, and deploy the service on a separate server.

Building it

The project uses the maven build tool. Typically, you build it by invoking mvn clean install at the command line. For simple file changes, not additions or deletions, you can usually use mvn install. See https://github.com/eurekaclinical/dev-wiki/wiki/Building-Eureka!-Clinical-projects for more details.

Performing system tests

You can run this project in an embedded tomcat by executing mvn process-resources cargo:run -Ptomcat after you have built it. You can use it in conjunction with running eurekaclinical-user-webclient. It will be accessible in your web browser at https://localhost:4200/eurekaclinical-user-webapp/. Your username will be superuser.

Installation

Configuration

This webapp is configured using a properties file located at /etc/ec-user/application.properties. It supports the following properties:

• eurekaclinical.userwebapp.callbackserver: https://hostname:port
• eurekaclinical.userwebapp.url: https://hostname:port/eurekaclinical-user-webapp
• eurekaclinical.userservice.url: https://hostname.of.userservice:port/eurekaclinical-user-service
• cas.url: https://hostname.of.casserver:port/cas-server
• eurekaclinical.userwebapp.demomode: true or false depending on whether to act like a demonstration; default is false.
• eurekaclinical.userwebapp.ephiprohibited: true or false depending on whether to display that managing ePHI is prohibited; default is true.

A Tomcat restart is required to detect any changes to the configuration file.

WAR installation

1. Stop Tomcat.
2. Remove any old copies of the unpacked war from Tomcat's webapps directory.
3. Copy the warfile into the Tomcat webapps directory, renaming it to remove the version. For example, rename eurekaclinical-user-webapp-1.0.war to eurekaclinical-user-webapp.war.
4. Start Tomcat.

Maven dependency

<dependency>
    <groupId>org.eurekaclinical</groupId>
    <artifactId>eurekaclinical-user-webapp</artifactId>
    <version>version</version>
</dependency>

Developer documentation

• Javadoc for latest development release

Getting help

Feel free to contact us at help@eurekaclinical.org.