DataServices:QTViIni

Berger Algorithm Parameter (QTViIni) Data Service is used to manage "ini" files used by the Berger Algorithm. The Berger Algorithm takes HL7aECG files (which are managed in the HL7aECG Data Service along with additional metadata) and "ini" files which describe manual Q and T point identification. In an analysis workflow, a CVRG client can query an HL7aECG Data Service instance to retrieve the ECG data of interest and an instance of the QTViIni service for an "ini" file and pass this information to an instance of the qtviAnalysisService, which implements a Grid service interface to the Berger Algorithm, for analysis purposes.

System Requirements

Below you will find a list of technologies used by the QTViIni Data Service.

Below you will find a list of ports used by QTViIni Data Service.

Source Repository

With $CVRG_LOCATION being the SVN checkout from https://scm.cci.emory.edu/svn/cvrg/trunk, the following are key locations for QTViIni Data Service:

• QTViIni Data Service
  • $CVRG_LOCATION/dev/services/QTViIniDataService
• Test Data for Systems Tests
  • $CVRG_LOCATION/dev/integrationtest/xml/testqtvi_ini.xml

Installing QTViIni Data Service

The following software must be installed in order to compile, deploy, and use QTViIni Data Service

Step 1: Install Prerequisite Software

1. Ant 1.7.0
2. Tomcat 5.0.28
3. Media:Ws-core-4.0.3.zip
4. Oracle Berkeley DB XML 2.4.13

Step 2: Check out source codes

1. Check out the CVRG source code distribution from the CVRG code repository: https://project.bmi.ohio-state.edu/svn/cvrg/trunk
2. Check out the incubator project from https://project.bmi.ohio-state.edu/svn/incubator/branches/submit/incubator

Step 3: Set environment variables

1. Set GLOBUS_LOCATION to point to your installation of Globus.
2. Set JAVA_HOME to point to the directory where Java is installed.
3. Set ANT_HOME to point to the directory where ant is installed.
4. Set CAGRID_LOCATION to point to the directory where caGrid 1.2 is installed.
5. Set CVRG_LOCATION to point to the directory where the CVRG source code is checked out
6. Set INCUBATOR_LOCATION to the directory where the incubator project is located.

Step 4: Build Incubator Project

1. Run "ant clean all" in $INCUBATOR_LOCATION

Step 5: Build CVRG Libraries and Services

1. Run "ant clean all" in $CVRG_LOCATION

Step 6: Configure Tomcat Container

1. Since all of the data services are deployed to a secure tomcat container, a user account and host credentials will be needed for the CVRG grid. Please follow the instructions at http://www.cagrid.org/wiki/Introduce:1.2:Tutorial:Phase6 and at http://www.cagrid.org/wiki/CaGrid:ConfigureTomcat.
2. Modify the tomcat container for ports and security.
   1. Modify the /conf/server.xml file for service port (9447) and shutdown port (9007).
   2. Edit the /conf/server.xml and /webapps/wsrf/WEB-INF/etc/globus_wsrf_core/global_security_descriptor.xml for the key and cert locations.
3. Edit the environment variable CATALINA_HOME to point to the location of the tomcat container currently being configured. That is the Tomcat container to which the service is being deployed.

Step 7: Deploy Transfer Service Libraries

1. Go to $CAGRID_LOCATION/projects/transfer and run “ant deployTomcat”.

Step 8: Configure Locations for XML DB to Store Data and Attachments

1. Modify $CVRG_LOCATION/dev/services/QTViIniDataService/service.properties file so that it specifies the correct location for the cqlQueryProcessorConfig_xmldbPath and the cqlQueryProcessorConfig_xmldbAttachmentPath properties.

Step 9: Deploy Service to Tomcat Container

1. Run “ant deployTomcat” in $CVRG_LOCATION/dev/services/QTViIniDataService