58 lines
2.2 KiB
TeX
58 lines
2.2 KiB
TeX
\documentclass[11pt,fullpage]{article}
|
|
\usepackage[urlcolor=blue,colorlinks=true]{hyperref}
|
|
|
|
\begin{document}
|
|
|
|
\title{The Sting Build Environment}
|
|
\author{Matt Hanna}
|
|
\date{16 Mar 2009}
|
|
\maketitle
|
|
|
|
\section{Getting the source}
|
|
gsa1 and gsa2 are earmarked for Sting repository development, and the scr1 thumper is used for Sting storage.
|
|
|
|
To download the source:
|
|
\begin{enumerate}
|
|
\item log into gsa1 or gsa2. Create a directory for yourself on the scr1 thumper as follows:
|
|
\begin{verbatim}
|
|
mkdir /wga/scr1/{YOUR USER NAME}
|
|
\end{verbatim}
|
|
\item Download the source as follows:
|
|
\begin{verbatim}
|
|
svn co https://svnrepos/Sting/trunk Sting
|
|
\end{verbatim}
|
|
\item (Optional) mount the thumper locally using share name smb://thumper01/scr1.
|
|
\end{enumerate}
|
|
|
|
\section{Build Prerequisites}
|
|
Sting requires Java SE 6 to compile. The steps below describe preparing your system for JDK 1.6 compilation.
|
|
|
|
\subsection{Mac}
|
|
\begin{enumerate}
|
|
\item Download the latest Mac Java service pack. At the time of writing, the latest service pack is available here: \url{http://support.apple.com/downloads/Java_for_Mac_OS_X_10_5_Update_2}
|
|
\item Set the JAVA\_HOME environment variable to the location of JDK1.6 (/System/Library/Frameworks/JavaVM.framework/Versions/1.6/Home).
|
|
\end{enumerate}
|
|
|
|
\subsection{Linux in the Broad Environment}
|
|
To compile Sting on gsa1 or gsa2, add the following lines to your ~/.my.cshrc:
|
|
\begin{verbatim}
|
|
use -q Java-1.6
|
|
use -q Ant-1.7
|
|
\end{verbatim}
|
|
|
|
\section{Building the Source}
|
|
To build the source, locate all build.xmls for required projects. In each directory containing a build.xml, run the command:
|
|
\begin{verbatim}
|
|
ant
|
|
\end{verbatim}
|
|
|
|
You might also find the following ant targets useful. \input{Ant_Help}
|
|
|
|
\section{Adding Third-party dependencies}
|
|
A large number of popular third-party tools are available via the maven repository (\url{mvnrepository.com}). If your tool is available in the maven repository, add a line to the ivy.xml file similar to the following:
|
|
\begin{verbatim}
|
|
<dependency org="junit" name="junit" rev="4.4" />
|
|
\end{verbatim}
|
|
If your third-party dependency is not available via ivy, talk to Aaron or Matt.
|
|
\end{document}
|