System Requirements

To run the Union Server you will need Java 1.6. To check your system's current Java version, issue the following command-line command:

java -version

Getting Java

Windows and Unix/Linux users can download Java here.

Mac users note:

  • As of April 2009, Java 1.6 requires the 64-bit version of Mac OSX
  • To download Java, use Software Update, under the Apple menu. However, note that Software Update may not change the system default version of Java to latest version of Java. To ensure that Union runs under Java 1.6 or higher, edit Union's startup and shutdown scripts to point directly to the desired version of Java. For example, to run Union under Java 1.6, change java to /System/Library/Frameworks/JavaVM.framework/Versions/1.6/Commands/java in both startserver.sh and stopserver.sh. Alternatively, change system's symbolic link for java as follows:
rm /usr/bin/java
sudo ln -s /System/Library/Frameworks/JavaVM.framework/Versions/1.6/Commands/java /usr/bin/java

Evaluated Attributes

To use the evaluated attribute feature you will need a distribution of Java that supports Javascript scripting. The Sun distribution, obtained through the link above, supports Javascript scripting. If your distribution of Java does not come with Javascript scripting support you will need to do the following after installing Union:

  1. Download jsr223-engines.tar.gz (or jsr223-engines.zip) from the Scripting Home Page
  2. gunzip/untar (or unzip) it to a directory outside of your Union install
  3. From that directory copy javascript/build/js-engine.jar to UNION_HOME/lib
  4. Download Rhino Javascript from the Rhino download page
  5. unzip the Rhino distribution to a directory outside of your Union install
  6. From that directory copy js.jar to UNION_HOME/lib
  7. Add js-engine.jar and js.jar to the CLASSPATH in the startserver script (startserver.sh for Mac, Unix, startserver.bat for windows) found in UNION_HOME. See below for examples.

Windows

java -cp lib\js-engine.jar;lib\js.jar;lib\union.jar;lib\stax-api-1.0.1.jar;lib\wstx-asl-3.2.6.jar net.user1.union.core.UnionMain start

Mac, Unix

java -cp lib/js-engine.jar:lib/js.jar:lib/union.jar:lib/stax-api-1.0.1.jar:lib/wstx-asl-3.2.6.jar net.user1.union.core.UnionMain start &