hid:Calm quickstart

From NITRC Wiki

Prerequisites

• JDK 1.5+ is necessary for CALM which uses Java generics is a major Java language enhancement only available Java 5 (JDK 1.5) or later. The latest JDK available is recommended. (http://java.sun.com/j2se/downloads/)
• Apache Ant for build (1.6.x or later) (http://ant.apache.org/)
• Make sure your database is setup for CALM

Preliminary Database Setup

Postgres Support

Postgres is the recommended and supported version starting with CALM and HID web app. Use the latest Postgres db generation scripts available via;

   svn checkout https://www.nitrc.org/svn/hid/schema/trunk/schema

The instructions are in schema/Postgres/README file.

Quick Start Guide

Getting the source code from stratch You can get the latest CALM from BIRN CVS server via

   svn checkout https://www.nitrc.org/svn/hid/calm/trunk/calm

Build and Configuration

In $CALM_HOME, build CALM by running

$ ant

When you are running ant for the first time you will be asked about database connection parameters. Ant uses that information to create configuration files $CALM_HOME/conf/caslayout.properties and $CALM_HOME/conf/log4.properties. Running CALM cd to $CALM_HOME/bin and add execution permission to the script calm.sh and run it like

calm.sh -help

to see the usage information. Without parameters calm.sh starts the GUI.

Usage: ${JAVA} caslayout.ui.ClinicalAssessmentLayoutManager [-schema  \
             -xml ] [-help] [-version]
or  ${JAVA} caslayout.ui.ClinicalAssessmentLayoutManager -add -xml 
where
	-help - displays this information
	-schema   -xml  are the CALM XML Schema and the CALM document
	 to be validated against the schema
	-add to add the provided assessment  to the HID database

To validate a CALM document via the provided XML schema (for example)

calm.sh -schema $CALM_HOME/conf/calm_document.xsd -xml $CALM_HOME/examples/sars.xml

To register an assessment with HID database without starting up GUI

calm.sh -add -xml $CALM_HOME/examples/sars.xml