|
Initial Installation
To install the browser, download the package for your platform, which should come using the following naming convention:
eXeMeLversion.archive-type
Then unpack the archive into the base directory you wish to place it in. Unpacking the archive will create a directory by default although this can be changed if you wish. The only requirement is that the testdata directory is placed in the same directory as the eXeMeLBrowser.jar file.
|
Running
To run the browser, you will need a Java Virtual Machine, version 1.2 or later for your platform. To find one, please got to http://java.sun.com.
Once you have installed the JVM, the you can run eXeMeL.
To run eXeMeL, you will need the eXeMeLBrowser.jar file in your classpath. We suggest that this file is at the beginning of your classpath, as there can be problems if you have other XML parsers in your classpath. Also, due to a minor bug in the user setup process, you will need to use the full path to this JAR file in your classpath. The main class for running the browser is eXeMeLBrowser, and can be run with no command-line switches.
A sample command-line for running the browser is shown below.
Windows:
java -classpath c:\eXeMeL0.91a\eXeMeLBrowser.jar eXeMeLBrowser
Unix:
java -classpath /export/opt/eXeMeL0.91a/eXeMeLBrowser.jar eXeMeLBrowser
|
Command-Line Options
In the following table are details of the various command-line switches that can be passed to the browser at run-time:
|
Switch
|
Short version
|
Description
|
|
-help
|
-?
|
Prints out a list of command-line otions and exits.
|
|
-install-directory <string>
|
-id <string>
|
Sets the installation directory to that specified.
|
|
-jre-lib
|
-jl
|
Sets the JRE "lib" directory for the user properties file.
|
|
-log <string>
|
-l <string>
|
Logs output to logfile specified.
|
|
-log-error <string>
|
-le <string>
|
Logs error messages to logfile specified.
|
|
-user-properties <string>
|
-up <string>
|
Uses directory specified for finding user properties file.
|
|
-version
|
-v
|
Prints a message with the version number and exits.
|
|
User Setup
The first time the browser is run by a user the dialog below will popup. This will aslo occur if the user properties file has been deleted, or cannot be found for any reason.
Note: This file must be writeable for everyone using the browser
The dialog requests the user selects where to place personal preferences and cached files, this will default to the a subdirectory called eXeMeL in the user's home directory, but may be changed to any that the user can write to.
|
|
|
Installation