@author Fuat Keceli
@exc Java executable Last update: Jul 03, 2008
@exc Java Web Start Version Last update: Jul 03, 2008
@doc Flowcharts and UML Diagrams  Last update: Jul 03, 2008
@src Source files Last update: Jul 03, 2008
@version 
@versionInfo version.txt

Document last updated on: Jul 03, 2008 (document version: )

This software is developed using DESim API.

The minimum requirement for ITSim is Sun Java Runtime Version 1.4. Even though
it should work on higher versions, it is only tested with Java 1.4.

There are three ways of using ITSim:

1. Download and run the Java application in your local machine
2. Run the Java applet directly from this page
3. Run the Java applet on Java Web Start (troubleshooting included)








Download and Run the Java Application

Download the itsim.jar file following this link and use the following terminal
command:

  java -jar itsim.jar

Simulation options are explained in the help section of the software.

  Microsoft Windows Users:
    1. Download the executable to a new directory.
    2. Open a command prompt. To open a command prompt, go to Start Menu, click
       on "Run...", type cmd and press enter.
    3. Change the directory to the new directory that you created. To change
       the directory use the following command.
           cd <directory name>
       For a shortcut of writing the directory name you can drag and drop the
       new directory to the command prompt window.
    4. Run 'java -jar itsom.jar'.


If you run out of memory running the executable try the following command with
the extra options:

  java -Xms300M -Xmx300M -jar itsim.jar

These options will set the minimum and the maximum heap sizes for java
garbage collection. If you are still running out of memory try larger sizes.
If your computer locks up try smaller sizes.
Note: M stands for MB, i.e. -Xms300M sets the minimum heap size to 300 MBytes.









Run the Java Applet Directly From This Page





Simulation options are explained in the help section.

If you don't see the applet above:
  - You might not have java. Please download and install Java version at least
    1.4 from java.sun.com. 
  - Your browser might not be allowing applets to run. Make sure that you
    temporarily allow applets and pop-up windows. 

If you run out of memory try the following settings:

  1. Open the Java Control Panel (In MS Windows you can open the control panel
     by right clicking on the Java icon in the task bar and selecting "Open
     Control Panel")
  2. Select the "Advanced" tab.
  3. In the "Java Runtime Parameters" field enter the following text and press
     "Apply". 
        -Xmx300m -Djavaplugin.maxHeapSize=300m

These options will set the minimum and the maximum heap sizes for java
garbage collection. If you are still running out of memory try larger sizes.
If your computer locks up try smaller sizes.
Note: M stands for MB, i.e. -Xms300M sets the minimum heap size to 300 MBytes.




Run the Java applet on Java Web Start

Java Web Start is a Sun application interface for Java Applets. It makes
applets look like applications (it even places a direct application shortcut on
your desktop). In addition, it constantly checks for the updates online. This
way you always get the latest version of the applet without having to check a
web site.

Java web start comes as a standard with latest Java 1.4 and 1.5 versions
(download java here). If you are a Microsoft Windows user you should have a
Java Web Start shortcut under the Start menu.

How to install ITSim Java Web Start Version

Click on this link and it will start Java web start.
After it starts it will ask if you want to install a certificate (which you
should accept) and then it will ask if you want a desktop shortcut. If you
don't want a desktop shortcut, you should run 'Java Web Start' (under Start
menu for MS Windows users) and double click on ITSim icon everytime you want to
run ITSim.

If the link above doesn't work (means you have a problem with MIME settings),
open Java Web Start (under Start menu for MS Windows users) and type the
following address in the location bar and press enter:

http://www.ece.umd.edu/~keceli/web/software/ITSim/ITSim.jnlp

ITSim should be loaded after the same steps explained above.


What to do if ITSim Java Web Start Version stops working

Follow the steps below in Java Web Start window.

  1. Select 'Downloaded Applications' from 'View' menu,
  2. Make sure that ITSim is selected by single clicking on the ITSim icon,
  3. Select 'Remove Application' from 'Application' menu,
  4. Reinstall ITSim following the instructions above.