README

Contents

• 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).

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

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:

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

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

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:

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

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

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