Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The software is currently compatible with Java versions 1.7 8 and greater.  It will not currently build with Java 1.6 7 or other earlier versions.  You need to download the "Java Platform (JDK)" and not just the JRE.  It should work with Java 1.8 releases.

The bundle for your system should be downloaded from the Java SE downloads site.  Then you need to follow the setup instructions listed there.

...

No Format
export JAVA_HOME=/path/to/java/jdk
export PATH=$JAVA_HOME/bin:$PATH

#for example on rhel6-64 machine @ slac:
export JAVA_HOME=/afs/slac/package/java/amd64_linux/jdk1.8.0_101/
export PATH=$JAVA_HOME/bin:$PATH

This will make sure that the shell can find the Java commands such as java and javac that will be needed for the installation.

...

No Format
[$] javac -version
javac 1.78.0_17101

If this command prints "command not found", the current PATH variable probably does not contain the Java bin directory or the location was set incorrectly.

Info
titleJava on OSX - DEPRECATED

On OSX, the Java configuration found by Maven can sometimes conflict with what is shown by the 'java -version' from the command line.  In particular, the Java version that comes bundled with the operating system might be 1.6 when a 1.7 JDK is required to build HPS software.

In order to fix this, setup the JAVA_HOME variable as follows:

export JAVA_HOME=$(/usr/libexec/java_home -v 1.7)

Of course, a valid Java 1.7 JDK installation must be present for this to work. You can get the latest version from here.

Simply install the DMG file as normal, and then setting up your environment as above should configure your machine successfully for Maven usage.

...

If this command does not work, then you should check that the PATH variable is set correctly.

Git

Info
titleSubversion Git on your system

Git is a common tool on Unix systems, and it is likely already installed for you to use.  If not, then check with your system administrator about installing it.

...

When introducing local changes to the trunk, you may get error messages like "You have 2 Checkstyle violations." and the build will fail.

...

Firstly, tabs are disallowed completely in all modules but usersJava code.  

An error message like this will show if you have tabs in one of your files.

...

As an alternative to the above instructions for building the software locally, you may also download and run a distribution jar from the Nexus repository.

This search URL will show the most recent release list of releases of the distribution jar that can be downloaded.  You can   Select the version that you are interested in and simply click on the "bin jar" link for the distribution version you want to download, save it to your machine, and run it using the previous instructions.

You may also directly download a jar using (rather ugly) URLs like this which should work in tools like wget.

...

Code Block
languagebash
wget "http://srs.slac.stanford.edu/nexus/service/local/artifact/maven/redirect?r=repository/lcsim-maven2-releases&g=org.hps&a=hps-distribution&v=3.6&e=jar&c=binsnapshot/org/hps/hps-distribution/4.4-SNAPSHOT/hps-distribution-4.4-20190612.032534-24-bin.jar" -O hps-distribution-34.64-bin.jar

The above example command will save the 3latest 4.6 4 distribution jar as the file hps-distribution-34.64-bin.jar in the current directory.