NIH | National Cancer Institute | NCI Wiki  

Error rendering macro 'rw-search'

null

  • Created by Unknown User (dilmanih), last modified on Mar 22, 2012

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 11 Next »

Question: How can I build caArray from the source code in the NCI repository?

Topic: caArray Installation and Upgrade

Release: caArray v2.4.1.1 and higher

Date entered: 01/17/2012

Answer

Below is a step-by-step illustrated tutorial on how to build the application from source. It covers the following:

  • How to check out the source code from the repository using a Subversion (SVN) client
  • How to manually create the requisite database schema
  • How to configure the various properties files required by Ant
  • How to invoke the build process from the command line
  • How to launch the caArray server once the build has completed successfully
  • How to access the application's login page via your Web browser

The tutorial is designed for use in a Windows environment, but can easily be adapted to work in Linux as well.

(NOTE: Due to recent changes in the NCI caArray source code repository, the process described in this tutorial only applies to v2.4.1.1, which is the latest version as of this writing.)

Prerequisites

Before proceeding to check out the code, ensure that the following are already installed on your machine:

  • The Java 2 SE Development Kit (JDK) v1.5, available for download at:

http://download.oracle.com/otn/java/jdk/1.5.0_22/jdk-1_5_0_22-windows-i586-p.exe

(Note that the build process will not work with JDK versions higher or lower than 1.5.)

  • Apache Ant 1.7.0 or later, available for download at:

http://mirrors.ibiblio.org/apache//ant/binaries/apache-ant-1.8.3-bin.zip

  • MySQL v5.0 or later, available for download at:

http://filehippo.com/download/file/3518c972e6317bff1a5caacae83b83cf1057fceca08180ebd44ad9a0ba01444b/

  • A command-line Subversion (SVN) client of your choice. The one used in this tutorial is the Collabnet Subversion Command-Line Client v1.74, available for download at:

http://www.open.collab.net/servlets/OCNDirector?id=CSVN1.7.4WINC32 (registration required)

Once all the above are installed, ensure they are configured as follows:

  • The PATH and JAVA_HOME Windows environment variables must be set to the the installation path of the JDK binaries. The default path in Windows is:

C:\Program Files\Java\jdk1.5.0_22\bin

  • The PATH and ANT_HOME Windows environment variables must be set to the installation path of the Ant binaries. The default path is:

C:\ant

  • The PATH Windows environment variable must be set to the installation path of the SVN client binaries. The default path in Windows is:

C:\Program Files\CollabNet Subversion Client

  • The ANT_OPTS environment variable must be set to the value "-Xmx256m"
  • The MySQL server must be configured with a secure password for the root user, and this password must be recorded for future reference

Checking Out The Source Code From The NCI Repository

Manually Creating The Requisite Database Schema

Configuring The Various Properties Files Required By Ant

Invoking The Build Process From The Command Line

Launching The caArray Server Upon Build Completion

Accessing The Application's Login Page Via Your Web Browser

Have a comment?

Please leave your comment in the caArray End User Forum.

  • No labels