MAT_Install_Guide_5_5 MAT Install Guide
MAT_Install_Guide
User Manual:
Open the PDF directly: View PDF .
Page Count: 5
Download | ![]() |
Open PDF In Browser | View 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 thetag 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.5EXIF Metadata provided by EXIF.tools