Running ODEToolkit

Requirements

ODEToolkit requires Java 6 to run. You can download Java at http://java.com/en/download/index.jsp. The recommended amount of heap space memory given to ODEToolkit is at least 256MB. To configure the amount of memory allowed for ODEToolkit, please see the information on running ODEToolkit from Java Archive below.

Running ODEToolkit from Java Web Start (.jnlp file)

In Windows and Macintosh, you can run ODEToolkit from Java Web Start by opening the link on the website, or double-clicking at .jnlp file. If the system asks for permission to run ODEToolkit, simply allow. In Linux, sometimes Java Web Start is not automatically set as a default program to run .jnlp file. If this is the case, please try to run using the command line.

To run using the command line, first navigate to the bin folder of java. (If you have trouble locating this folder, try typing "locate javaws" in the command line. This should give you the path.) Then use the command

    javaws <webstart URL>

where <webstart URL> is the URL of the Java Web Start (.jnlp) file.

If you are still having trouble, please try downloading the .jar file instead.

Running ODEToolkit from Java Archive (.jar file)

In Windows and Macintosh, you can run ODEToolkit from Java Archive file by opening the link on the website, or double-clicking at .jnlp file. If the system asks for permission to run ODEToolkit, simply allow. In Linux, generally Java is not automatically set as a default program to run .jnlp file. If this is the case, please run using command line.

Please note that running Java Archive directly may limit the memory allocated for the program. To fix this problem, you need to make sure that the program is not unblocked by the operating system, by configuring the property of the Java Archive (.jar) file. In Windows, please right-click at the .jar file, then select Properties. If the program is blocked, there will be an "unblock" button - click it then click OK, and double-click at ODEToolkit to run as usual.

Alternative, you can run ODEToolkit using command line. To run using command line, first navigate to the bin folder of java. Then use the command line

    java -jar <memory option> <jar file> <ode file option>

Following is the description of each component of the command line:

<memory option> is the amount of heap memory given for ODEToolkit. For example, substitute <memory option> with -Xmx512m for 512 MB of memory, or -Xmx1G for 1GB or memory. The recommended amount of memory is at least 256 MB.
<jar file> is the path to the Java Archive (.jar) file.
<ode file option> is optional. It can be replaced with -urlpath <ode file URL> so that it automatically open the ode workspace file located at the URL given by <ode file URL>.