README

GridSim ToolKit

Version 2.2

December 2003

Introduction
GridSim Toolkit Documentation
Compatibility
Installation Procedures for GridSim Toolkit
GridSim 2.2 Toolkit Classes Documentation
Running GridSim Toolkit
GridSim Toolkit Examples
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).

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:

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.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:

Uncompress the Gridsim toolkit
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:

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:

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

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

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:

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:

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

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

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:

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

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:

GridBroker Example1 -- This example shows how to create one Grid user and one Grid resource through GridBroker.
GridSim Example1 -- This example shows how to create one Grid resource with three machines.
GridSim Example2 -- This example shows how to create one or more Grid users. A Grid user contains one or more Gridlets. Therefore, this example also shows how to create Gridlets with and without using GridSimRandom class.
GridSim Example3 -- This example shows how two GridSim entities interact with each other.
GridSim Example4 -- This example shows how a grid user submits its Gridlets or tasks to one grid resource entity.
GridSim Example5 -- This example shows how a grid user submits its Gridlets or task to many grid resource entities.
GridSim Example6 -- This example shows how a grid user submits its Gridlets or task to many grid resource entities.
GridSim Example7 -- This example shows how to do Jobs migration in GridSim.
GridSim Example8 -- This example shows how to make a new and simple Allocation Policy under GridSim.

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: