README

Contents

• Introduction
• GridSim Toolkit Documentation
• Compatibility
• Installation Procedures for GridSim Toolkit
• Running GridSim Toolkit
• FAQ, Bug Reports and Feedback
• Redistribution
• Links

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:

• GridBroker:
  It is Grid scheduler built on top of GridSim for application scheduling on Grid based on Deadline and Budget Constrained Scheduling Algorithms.


• GridSim:
  It is built on top of SimJava. SimJava is a process based discrete event simulation package for Java with animation facilities.


• Visual Modeler:
  It enables the user to create experiments on different Grid testbeds and generate the default Grid Broker source codes (in Java).

GridSim Toolkit Documentation

For API documentation, refer to the following sources:

• GridSim API
• GridBroker API
• Visual Modeler API

For user guides, refer to the following sources:

• Visual Modeler User Guide

Compatibility

For compability, install the following software:

• Java 2 SDK version 1.4

Installation Procedures for GridSim Toolkit

Directory Structure of GridSim Toolkit:

gridsimtoolkit-2.1/
    index.html          -- This file
    classes/            -- The .class files
    doc/                -- API Documentation
        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.

Running GridSim Toolkit

Description of the following jar files:

• all.jar -- contains GridBroker, GridSim and SimJava class files
• gridbroker.jar -- contains GridBroker class files only
• gridsim.jar -- contains GridSim and SimJava class files
• simjava.jar -- contains SimJava class files only
• visualmodeler.jar -- contains VisualModeler class files only

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

• In Unix or Linux: javac -classpath $GRIDSIM/jars/all.jar:. $GRIDSIM/examples/gridbroker/Example1.java
  In Windows: javac -classpath %GRIDSIM%\jars\all.jar;. %GRIDSIM%\examples\gridbroker\Example1.java


• In Unix or Linux: java -classpath $GRIDSIM/jars/all.jar:. $GRIDSIM/examples/gridbroker/Example1
  In Windows: java -classpath %GRIDSIM%\jars\all.jar;. %GRIDSIM%\examples\gridbroker\Example1

• Instead of all.jar, you can use gridbroker.jar and gridsim.jar to compile GridBroker applications.
• $GRIDSIM or %GRIDSIM% is the location of the GridSim Toolkit package.

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

• In Unix or Linux: javac -classpath $GRIDSIM/jars/gridsim.jar:. $GRIDSIM/examples/gridsim/Example1.java
  In Windows: javac -classpath %GRIDSIM%\jars\gridsim.jar;. %GRIDSIM%\examples\gridsim\Example1.java


• In Unix or Linux: java -classpath $GRIDSIM/jars/gridsim.jar:. $GRIDSIM/examples/gridsim/Example1
  In Windows: java -classpath %GRIDSIM%\jars\gridsim.jar;. %GRIDSIM%\examples\gridsim\Example1

To run VisualModeler, type:

• In Unix or Linux: java -jar $GRIDSIM/jars/visualmodeler.jar
• In Windows: java -jar %GRIDSIM%\jars\visualmodeler.jar

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:

• GridSim
• SimJava
• Gridbus Project
• The University of Melbourne
• VPAC
• Sun Microsystems
• Borland JBuilder
• Java 2 SDK version 1.4