DataServices:WFDB

From CVRG Wiki

Jump to: navigation, search

Contents

System Requirements

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

Software Type Vendor/Name Minimum Required Version
IDE Eclipse Europa
Development Language Java 5.0
Build Mechanism Ant 1.7.0
Dependency Management IVY 2.0.0-beta2
Application Server Tomcat 5.0.28
Virtualization (opt) vmware Workstation 6
Database Oracle Berkeley XML DB 2.4.13
Grid Framework Globus ws-core-4.0.3
Grid Middleware caGrid 1.2
Grid Service Generator Introduce 1.2


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

Software Component Port Note
Data Service Port 9452 This port needs to be open to the internet.
Data Service Shutdown Port 9012 This port should be closed.


Source Repository

With $CVRG_LOCATION being the SVN checkout from https://scm.cci.emory.edu/svn/cvrg/branches/cvrg_1_2-ivy, the following are key locations for WFDB Data Service:

  • WFDB Data Service
    • $CVRG_LOCATION/dev/services/WFDBDataService
  • Test Data for Systems Tests
    • $CVRG_LOCATION/dev/integrationtest/wfdb/



Installing WFDB Data Service 

Installing WFDB Data Service

The following software must be installed in order to compile and deploy WFDB 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 (9452) and shutdown port (9012).
    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/WFDBDataService/service.properties file so that it specifies the correct location for the cqlQueryProcessorConfig_xmldbPath and the cqlQueryProcessorConfig_xmldbAttachmentPath properties. Also modify the property: wfdbBinaryRepositoryPath, which points to the directory where the binary files will be stored.

Step 9: Deploy Service to Tomcat Container

  1. Run “ant deployTomcat” in $CVRG_LOCATION/dev/services/WFDBDataService
Retrieved from "http://wiki.cvrgrid.org/index.php/DataServices:WFDB"
Project Infrastructures