README

GridSim ToolKit

Version 2.2

December 2003

 

Contents



Introduction

Thank you for downloading this release of the GridSim (Grid Simulation) Toolkit. GridSim is a toolkit for modeling and simulation of parallel and distributed systems such as Clusters and Grids. GridSim is part of the Gridbus Project, jointly sponsored by The University of Melbourne (Australia), Sun Microsystems (USA), and Victorian Partnership for Advanced Computing (VPAC) (Melbourne, Australia).

The GridSim Toolkit includes:

NOTE: changelog for GridSim Toolkit can be found here


GridSim Toolkit Documentation

For API documentation, refer to the following sources:

For user guides, refer to the following sources:



Compatibility

For compability, install the following software:



Installation Procedures for GridSim Toolkit

Directory Structure of GridSim Toolkit:

gridsimtoolkit-2.2/
    index.html          -- This file
    classes/            -- The .class files
    doc/                -- API Documentation
        eduni/
        gridbroker/
        gridsim/
        visualmodeler/

    examples/           -- Examples, see README.txt for details
    jars/               -- jar archives
    source/             -- The Java source code
        gridbroker/*.java
        gridsim/*.java
        visualmodeler/*.java

To install the GridSim toolkit, please perform the following steps:

  1. Uncompress the Gridsim toolkit
  2. Ensure that Java 2 SDK Version 1.4 (or above) is installed.
NOTE: You don't need to install SimJava package since the GridSim Toolkit contains SimJava class files only.




Running GridSim Toolkit

Description of the following jar files:


Example to compile and running GridBroker applications, do the following step:

  1. Go the directory where the GridBroker's Example1 reside
    In Unix or Linux:      cd $GRIDSIM/examples/gridbroker/Example1
    In Windows:      cd %GRIDSIM%\examples\gridbroker\Example1

  2. Compile the Java source file
    In Unix or Linux:      javac -classpath $GRIDSIM/jars/all.jar:. Example1.java
    In Windows:      javac -classpath %GRIDSIM%\jars\all.jar;. Example1.java

  3. Running the Java class file
    In Unix or Linux:      java -classpath $GRIDSIM/jars/all.jar:. Example1
    In Windows:      java -classpath %GRIDSIM%\jars\all.jar;. Example1

NOTE:


Example to compile and running GridSim applications, do the following step:

  1. Go the directory where the GridSim's Example1 reside
    In Unix or Linux:      cd $GRIDSIM/examples/gridsim/Example1
    In Windows:      cd %GRIDSIM%\examples\gridsim\Example1

  2. Compile the Java source file
    In Unix or Linux:      javac -classpath $GRIDSIM/jars/gridsim.jar:. Example1.java
    In Windows:      javac -classpath %GRIDSIM%\jars\gridsim.jar;. Example1.java

  3. Running the Java class file
    In Unix or Linux:      java -classpath $GRIDSIM/jars/gridsim.jar:. Example1
    In Windows:      java -classpath %GRIDSIM%\jars\gridsim.jar;. Example1


To run VisualModeler, type:



GridSim Toolkit Examples

The examples here are simple. If you have any real examples that you want to share with everybody, feel free to contact anthony@cs.mu.oz.au. In addition, if you find mistakes or bugs in this example, feel free to contact the above email. Please read README.txt of each directory on how to compile and run the example. The Java source code contains a detailed explanation of each example.

The summary of the examples provided are:

FAQ, Bug Reports and Feedback

A list of FAQ can be found here
A list of Bugs Fixed can be found here

For SimJava bugs and feedback, please refer to the SimJava website.

For GridSim, GridBroker and Visual Modeler bugs and feedback, please email to raj@cs.mu.oz.au or anthony@cs.mu.oz.au



Redistribution

You can download the GridSim Toolkit for free under the GPL License.
Copyright: The Gridbus Project, GRIDS Lab, The University of Melbourne, 2003.



Links

For additional information, please refer to the following websites: