NOTE: If you are a SPARK developer (i.e. using the AIC CVS tree), you should use these instructions instead.
SPARK is released in two separate distributions: a SPARK-only release (the version you get from the SPARK Web site), and integrated CALO Desktop release. SPARK is also integrated with the Eclipse IDE. For instructions on installing SPARK with the Eclipse IDE, please see the separate Spark Plugin For Eclipse documentation.
Installing the SPARK Release
IMPORTANT: please make sure you have Java 1.5 installed.
Windows:
- At a command prompt, type 'java -version' to make sure that your default Java is set to Java 1.5 (or later). If not, you will need to update your Java installation.
- (optional) set the SPARK_MODULES environment variable if you have pre-existing modules you wish to run
- run spark/bin/spark.bat
Mac OS X/Linux/Unix:
- Make sure that the 'java' command is on your command path or the JAVA_HOME environment variable is set to the location of a Java 1.5+ installation directory.
- (optional) set the SPARK_MODULES environment variable if you have pre-existing modules you wish to run
- run spark/bin/spark to start SPARK. You may wish to add spark/bin to your system path in order to start SPARK more easily.
For instructions on how to use this console, proceed to the running SPARK section. Note that the first time you run SPARK, it will display messages of the form:
*sys-package-mgr*: processing new jar, '/System/Library/Frameworks/JavaVM.framework/Versions/1.5.0/Classes/.compatibility/14compatibility.jar'
CALO Desktop Release
SPARK is designed within the Startit environment for the CALO Desktop. All necessary files and configurations are included with the CALO Desktop release and, for most users, should not require any modification. You can start and kill SPARK by opening the Startit window and selecting the appropriate command. You may also choose to enable or disable persistence from this window.
There are several ways in which the CALO Desktop release of SPARK can be modified. You may, for example, wish to change the name of the process model that gets loaded when SPARK starts up. You may also wish to change the version of SPARK that is used when the CALO Desktop loads. Both of these options can be modified by editing text files included with CALO Desktop (Startit.config and Startit.props). Do not use spark.bat to run the SPARK included with CALO Desktop. If you wish to invoke SPARK via a console window, we recommend that you use the Startit "Print start info" command to get the exact command used to run SPARK. The "Print start info" command is accessible in the pulldown menu for starting/killing SPARK.