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

Topic: caArray Installation and Upgrade

Release: caArray v2.0 to v2.4.1.1

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 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.

Prerequisites

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

• The Java 2 Standard Edition (J2SE) SDK v1.5 only, available for download at: (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:
• MySQL v5.0.x, available for download at:
• A Subversion client of your choice. The one used in this tutorial is the Collabnet Subversion Client, available for download at:

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

• The PATH and JAVA_HOME Windows environment variables must be set to the the installation path of the JDK binaries. By default, this path is:
• The PATH and ANT_HOME environment variables must be set to the installation path of the Ant binaries. By default, this path is: 
• 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.