Installation: MDR Domain Model Generator

Step 1. System Requirements

Java 1.5 JDK and JAVA_HOME env defined
Ant 1.7.0 and ANT_HOME env defined
Access to mdrQuery Service (Service Host and Service Port)

Step 2. Obtain a Software Release

Skip this step if you have already checked out the code and built openMDR at the root level as per mdrCore installation instructions

Download openMDR 1.0 Source Bundle

Download the source release: Source Code zip

Build Instructions: openMDR1.0

Obtain openMDR 1.0 from the Repository

You can connect to the openMDR repository and download the source code. This option is similar to downloading the source release, but has the benefit of getting you all the latest updates to the code since it was released. That is, the source code checkout always has the latest patches applied to fix bugs found since the openMDR release.

Source Code: Subversion Checkout on Linux

On Linux systems, use the commands shown below to check out from the SVN repository.

Source Code: Subversion Checkout on Windows

On Windows systems, we recommend the following 3rd party tool as a GUI front-end to subversion to check out a caGrid release: http://tortoisesvn.tigris.org The command line version of subversion can be obtained from http://subversion.tigris.org

openMDR 1.0 Release Stream

openMDR 1.0 Latest

 svn checkout https://gforge.nci.nih.gov/svnroot/grid-incubation/branches/openMDR_1.0

openMDR 1.0

 svn checkout https://gforge.nci.nih.gov/svnroot/grid-incubation/tags/openMDR_1.0

Development Stream

 svn checkout hhttps://gforge.nci.nih.gov/svnroot/grid-incubation/trunk/grid-incubation/incubator/projects/mdr/

Note
You might have to setup proxy variables in your svn profile if you are behind a firewall.

Setup environment variable "OPENMDR_HOME" for your source code checkout:
```
export OPENMDR_HOME=/home/mdrcore/projects/openMDR_1.0
```
Step 3. Build MDR Domain Model Generator (Optional)

If you have built the project from root($OPENMDR_HOME), you do not need to rebuild it.
a) Goto the the root mdr project directory($OPENMDR_HOME):

$ cd $OPENMDR_HOME

b) Run the target

$ ant all

Step 4. Configure Domain Model Generator to new mdrQuery Service (Optional)

You will need information about the mdrQuery Service Host and Port as inputs for the configuration

$ cd $OPENMDR_HOME/projects/mdrDomainModelGenerator
$ ant configMDRQuery
Buildfile: build.xml

configMDRQuery:
     [echo] Enter the values where mdrQuery Service is deployed
    [input] Query Service Host
    [input]
mdr.triadcommunity.org
    [input] Query Service Port
    [input]
9090
     [echo] Previous Query Service Host : 172.16.1.11
     [echo] Previous Query Service Port : 9090
     [echo] Entered Query Service Host : mdr.triadcommunity.org
     [echo] Entered Query Service Port : 9090
     [echo] MDR Query URL has been updated

BUILD SUCCESSFUL

Step 5. Run Domain Model Generator

In order to run the Domain Model Generator, you should have an annotated XMI file using mdr EA Plugin.
The task requires 4 different inputs in order to generate the Domain Model file:
a) Information Model (XMI) file to be Parsed
b) Domain model File Name to be generated
c) Project Name
d) Project Version

$ cd mdr/projects/mdrDomainModelGenerator
$ ant run
Buildfile: build.xml

getXMIFile:
    [input] Information Model (XMI) file to be Parsed
    [input]
Test.xmi

getDomainFile:
    [input] Domain model File Name to be generated
    [input]
Test.xml

getProjectName:
    [input] Project Name
    [input]
TestProject

getProjectVersion:
    [input] Project Version
    [input]
1

run:
     [echo] XMI file to be Parsed: Test.xmi
     [echo] Domain model File to be generated: Test.xml
     [echo] Project Name: TestProject
     [echo] Project Version: 1
     [java] Starting the Domain Model Creation Process
     [java] XMI Model File: Test.xmi; Domain Model File: Test.xml; Project Name: TestProject; Project Version: 1
     [java] log4j:WARN No appenders could be found for logger (gov.nih.nci.cagrid.metadata.xmi.MDREaXMIHandler).
     [java] log4j:WARN Please initialize the log4j system properly.
     [java] Processing PublicId: cabio.nci.nih.gov_2513739_1.0
     [java] Processing PublicId: cabio.nci.nih.gov_2783929_1.0
     [java] Processing PublicId: cabio.nci.nih.gov_2553315_1.0
     [java] Processing PublicId: cabio.nci.nih.gov_2493321_1.0
     [java] Processing PublicId: cabio.nci.nih.gov_2493328_1.0
     [java] Processing PublicId: cabio.nci.nih.gov_2513739_1.0
     [java] Processing PublicId: cabio.nci.nih.gov_2555580_1.0
     [java] Processing PublicId: cabio.nci.nih.gov_2493329_1.0
     [java] Processing PublicId: cabio.nci.nih.gov_2405475_1.0
     [java] Processing PublicId: cabio.nci.nih.gov_2551756_1.0
     [java] Processing PublicId: cabio.nci.nih.gov_2182451_1.0
     [java] Processing PublicId: cabio.nci.nih.gov_2405459_1.0
     [java] Processing PublicId: cabio.nci.nih.gov_2223860_3.0
     [java] Processing PublicId: cabio.nci.nih.gov_2183084_1.0
     [java] Processing PublicId: cabio.nci.nih.gov_2715714_1.0

BUILD SUCCESSFUL

* After the task completes successfully, you should have the newly generated domain model file - Example: Test.xml
This file can now be consumed by introduce to create a caGRID data service.

MDR