Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Warning
titleDEPRECATED; WORK IN PROGRESS

Most of the information on this page is now out of date, as it refers to the old Maven 1 build system. The lcsim projects have been ported to use Maven 2 instead.

Prerequisites

To build the org.lcsim software, you should have the following installed.

  • Java JDK 1.5 or 1.6
  • Maven 2.0 (aka Java 5.0)
  • Maven
  • Netbeans (optional but recommended)
  • CVS client (normally pre-installed on any Linux box)
    Tip
    titleWindows CVS Software
    • cvs, command-line program
    • Tortoise CVS, graphical CVS client with Explorer integration
    Tip
    titleSLAC Unix Tools
    If you are at SLAC the tools above, including netbeans, are all pre-installed on SLAC Unix
  • .9
  • Netbeans 6.5
  • CVS client such as command-line on Linux, Tortoise CVS, or just use the Netbeans cvs client

If you are following the lcsim tutorial instructions, these tools should be setup by now.

Building org.lcsim software

The lcsim software consists of two three primary packages, a geometry package,
and the analysis and reconstruction package. You must obtain and
build the geometry package first, since the analysis package
depends on it: GeomConverter, org.lcsim, and lcsim-contrib.

Most users will be primarily interested in building and running lcsim and/or lcsim-contrib.

Here are condensed instructions, which you can execute from
the Linux or Cygwin bash any bash-like unix shell.

No Format
export CVSROOT=:pserver:anonymous@cvs.freehep.org:/cvs/lcd
cvs login (just hit enter when prompted for password)
cvs co GeomConverter
cvs co lcsim
cd GeomConverterlcsim
maven
cd ../lcsim
maven
mvn

The build procedure for lcsim-contrib is virtually the same. Just replace "lcsim" in the above instructions by "lcsim-contrib".

Keeping the Release Current

...

Installing Custom JARs into JAS3

Developers of org.lcsim may want to use a version in JAS3 that is more up-to-date
than the distributed plugin.

Execute the following from the lcsim checkout directory to install the lcsim target
JAR into the JAS3 extensions directory, overwriting the JAR that was automatically
downloaded.

No Format

maven jas:install

By default, your lcsim and lcsim-contrib builds install their current jar files into ~/.JAS3/extensions.

Edit the pom.xml file to turn off this behaviorThis will copy the lcsim and GeomConverter jars to ~/.JAS3/extensions.

Testing the installation

...