MAT_Install_Guide_5_5 MAT Install Guide

MAT_Install_Guide

User Manual:

Open the PDF directly: View PDF PDF.
Page Count: 5

DownloadMAT_Install_Guide_5_5 MAT Install Guide
Open PDF In BrowserView PDF
Measure Authoring Tool Installation Guide
The Measure Authoring Tool (MAT) was designed using many open source products including the Google Web
Toolkit (GWT) framework, Java JDK, MySQL and Eclipse. GWT allows a developer to write client-side code in Java
and GWT converts it to JavaScript. The MAT uses MySQL as its backend database server and the IDE is Eclipse for
Java EE Developers.
Due to the use of these open source products, a working knowledge of Java development and some research into
how the products work with each other in your environment may be necessary. Research from discussions on
product forums, help documents, internet searches and knowledge of the local environment where the MAT will
be running may all need to be checked if there are errors during the install.

1. Install Eclipse
Download Eclipse (MAT has been tested for Oxygen) for Java EE Developers. Eclipse IDE is a free, open source IDE
for writing Java applications found on the Eclipse download page at
http://www.eclipse.org/downloads/packages/eclipse-ide-java-ee-developers/oxygen1a
1. Select the version that best fits your operating system.
2. Extract the zip file to a location where you would like Eclipse to be installed.
3. Run the application file.

2. Install Google Web Toolkit (GWT)
1. Install GWT Plugin for Eclipse
1. Open Eclipse IDE, navigate to the workbench, and select [Help] -> [Eclipse Marketplace]
2. Search for http://marketplace.eclipse.org/content/gwt-eclipse-plugin
3. Install the result with the title GWT Eclipse Plugin 3.0.0

3. Configure Java (JDK)
1. The application has not been tested with version above Java 1.8; please ensure this version is in the
environment.
2. Verify that JAVA_HOME and PATH system variables are pointing to the proper folder(s).
3. For example, in a Windows environment, the JAVA_HOME (Environment Variables under Advanced
System Settings (should point to the Java SDK 1.8.x folder and PATH should point to the Java
1.8.x/bin.

4. MAT Code Base Import
1. From the MAT GitHub source code link, extract the code base into the Eclipse workspace folder in the
MAT Environment.
2. Import the code base into an Eclipse project:
[File] -> [Import] -> [General] -> [Existing Project into Workspace] ->
Browse to and Select << workspace >> -> [Finish]

1

5. Compile the MAT Code
1. Right click on the MAT project folder, then go to Properties -> GWT -> General Settings and select
Use GWT. Make sure that the SDK is using GWT 2.8.1.
2. In Eclipse, select GDT Pulldown (Red Google Icon Button) -> [GWT Compile Project].
3. In the GWT Compile Wizard:
1. Browse to find the MAT project.
2. Set the Log level to Debug
3. Add the Login and MAT Entry Point Modules.

6. Create MAT Database
1. Install MySQL (MAT currently uses MySQL Community Version 6.x) available from MySQL.com:
https://dev.mysql.com/downloads/installer/
2. Run the MySQL community server installer for your operating system and the MySQL workbench
(which comes with the download).
3. Create a new MySQL Connection to localhost.
Note: Make sure to keep track of the username and password you used as you will need this later.
4. From the MAT Code base, find the mat_schema.sql file and then execute the script in the database
that was just created.

7. For App Server Use (Optional)
Note: If MAT is to be run on an application server, the developer will need to run the build to create a
.war file.
1. In the Eclipse project explorer, navigate to ‘build.xml’.
2. Right-Click and [Run As] -> [Ant Build].
3. After the build has run, the file is placed into an artifacts folder under MAT as follows:
mat/work/artifacts/MeasureAuthoringTool.war

8. Configure MAT files for Local Development Environment
Note: Changes will need to be made to some of the files in the code base to allow the MAT to connect to
local MySQL Database.
1. Comment out the  tag at the bottom of the web.xml file.
2. mat/war/WEB-INF/mat-persistence.xml
1. In this file, set the ‘dataSource’ bean to provide login credential to the local MySQL database.
The box below is an example of the mat-persistence.xml file. The username and password
values indicated with ‘username’ and ‘password’ (bolded) need to be changed to the
“username” and “password” you used in the previous step to set up your local database.

2

3. mat/war/WEB-INF/applicationContext-security.xml
1. Make the default target url (bolded) changes in the box below in the applicationContextsecurity.xml file.

4. Mat/war/WEB-INF/applicationContext-mail.xml
1. Make the host value property name (bolded) changes in the box below to the ‘mailSender’
bean to point to the proper mail server.

2.

Make the from value property name (bolded) changes in the box below to the
‘templateMessage’ bean to set the correct ‘From’ email address.

9. Run MAT
1.
2.
3.

Make sure your database server is running
In the eclipse IDE Select, [Run] -> [Run Configurations] -> [Web Application] -> [New]
Set Main Class: “com.google.gwt.dev.DevMode”.
3

4.

Select [Apply] and followed by [Run].
Figure 1: Eclipse Run Configuration Window

10. Loggin in to MAT
1. To login to MAT, open MySQL Workbench and run the following queries:
1. SELECT * FROM USER where USER_ID=’Admin’
Look at the LOGIN_ID column, the value there is your UserID. The
password default is ‘gargleBlaster_10’.
2. Navigate to the MAT log in page GUI and use the UserID and password from the previous step and log
in to MAT.
3. Once logged in, navigate to the [Mat Account] tab and enter the Admin user details under the
[Personal Information] tab and the [Security Questions] tab to setup user’s security questions.
4. To change the password to something new, use the [Password] tab.

Setting up VSAC Communication Parameters for use with MAT
Note: MAT uses RESTful web-services to connect to VSAC system to pull in element lookup data. To set
up MAT to connect with the VSAC, specify the following VM arguments in Eclipse by doing the following:
1. [Run] -> [Run Configurations] -> Select your MAT project on the LHS and RHS on the [Arguments] tab
-> add the following information below into the VM arguments box.

4

-Xmx512m
-DVSAC_DRC_URL=https://vsac.nlm.nih.gov/vsac
-DSERVER_TICKET_URL=https://vsac.nlm.nih.gov/vsac/ws/Ticket
-DSERVER_SINGLE_VALUESET_URL=https://vsac.nlm.nih.gov/vsac/ws/RetrieveValueSet?
-DSERVER_MULTIPLE_VALUESET_URL_NEW=https://vsac.nlm.nih.gov/vsac/svs/RetrieveMultipleValueSets?
-DSERVICE_URL=http://umlsks.nlm.nih.gov -DENVIRONMENT=DEV -Dlog4j.ignoreTCL=true
-DPROFILE_SERVICE=https://vsac.nlm.nih.gov/vsac/profiles
-DVERSION_SERVICE=https://vsac.nlm.nih.gov/vsac/oid/
-D2FA_AUTH_CLASS=mat.server.twofactorauth.DefaultOTPValidatorForUser

5



Source Exif Data:
File Type                       : PDF
File Type Extension             : pdf
MIME Type                       : application/pdf
PDF Version                     : 1.7
Linearized                      : No
Page Count                      : 5
Language                        : en-US
Tagged PDF                      : Yes
XMP Toolkit                     : Adobe XMP Core 5.6-c015 84.159810, 2016/09/10-02:41:30
Producer                        : Microsoft® Word 2016
Format                          : application/pdf
Title                           : MAT_Install_Guide_5_5
Creator                         : HCIS
Description                     : Installation guide for the MAT Open Source Code version 5.5
Creator Tool                    : Microsoft® Word 2016
Create Date                     : 2017:12:14 16:45:48-06:00
Modify Date                     : 2017:12:14 16:49:18-06:00
Metadata Date                   : 2017:12:14 16:49:18-06:00
Document ID                     : uuid:8DE6087B-CBE3-49DC-8970-65D278DF1622
Instance ID                     : uuid:872b58bd-7266-4477-888d-6903a7ccd5cd
Author                          : HCIS
Keywords                        : Open Source, Code, MAT, Installation, Install, Guide
Subject                         : Installation guide for the MAT Open Source Code version 5.5
EXIF Metadata provided by EXIF.tools

Navigation menu