Search/Navigation:
Related:
SLAC/EPP/HPS Public
Jefferson Lab/Hall B/HPS Run Wiki
S30XL-LESA/LDMX
Table of Contents |
---|
Before reading these instructions, you will want to read Installing HPS Java, which explains how to build or get an HPS Java distribution jar file.
...
The distribution jar file contains all of the project's dependencies in a distribution that can be run standalone using the java command. The distribution will have "-bin" in the name.
This The jar file should will be found in your copy of HPS Java once after you have built it locally using Maventhe project locally. You can use a simple ls command to check that it was built correctly.
Code Block | ||
---|---|---|
| ||
cd hps-java; ls distributionls distribution/target/hps-distribution-[VERSION]*-bin.jar |
The version in subsequent commands will be left out for brevity, and because it will change depending on the version of the distribution you are using. Of course, when executing commands you need to use the path to an actual jar!
Any references to hps-distribution-bin.jar in command line syntax used on this page should actually be within these instructions should be replaced by the complete path to the HPS Java the distribution jar which was built.
The distribution jar can be run in two basic ways. You can run a You may run the default main method using the -jar switch, or you can use the -cp to supply a list of jars in the classpath and activate any switch can be used along with the path to a class's main method.
...
Using the -jar switch from the command line will run the main from the class JobManager, which is specified inside a special manifest file in the distribution jar (in case you were wondering how that works) JobManager which processes LCIO files using a steering file configuration.
Code Block | ||
---|---|---|
| ||
java -jar ./distribution/target/hps-distribution-bin.jar [args] |
Without any arguments, it will print the command line options and then exit.
The default main method can be used when you are processing LCIO files using XML steering configurations.
...
You can also run the main method from any class in the jar, for example:
...
Code Block | ||
---|---|---|
| ||
java -cp ./distribution/target/hps-distribution-bin.jar org.hps.evio.Evio2LcioEvioToLcio |
By convention, the -h switch is also usually used to print out a help menu.
Code Block | ||
---|---|---|
| ||
java -cp ./distribution/target/hps-distribution-bin.jar org.hps.evio.Evio2LcioEvioToLcio -h |
The specific command line syntax is unfortunately not standardized across all tools in the project and will depend on what was implemented in that class by the particular author.
...
Code Block | ||
---|---|---|
| ||
export JAVA_OPTS="-DdisableSvtAlignmentConstants=trueDorg.hps.conditions.enableSvtAlignmentConstants" |
The full list of Java system properties to be used should be included in this variable. You should not set the options -Xmx or -Djava.util.logging.config.class, as these are set by each script.
...