[Gridsim-commits] SF.net SVN: gridsim:[269] trunk

[<mar...@us...>]

Revision: 269
          http://gridsim.svn.sourceforge.net/gridsim/?rev=269&view=rev
Author:   marcos_dias
Date:     2009-05-22 05:47:14 +0000 (Fri, 22 May 2009)

Log Message:
-----------
* Changes in the build.xml file to include the SimJava2 classes into gridsim.jar. 

* Updated readme.txt file.

Modified Paths:
--------------
    trunk/build.xml

Added Paths:
-----------
    trunk/readme.txt

Modified: trunk/build.xml
===================================================================
--- trunk/build.xml	2009-05-22 05:18:22 UTC (rev 268)
+++ trunk/build.xml	2009-05-22 05:47:14 UTC (rev 269)
@@ -62,8 +62,31 @@
     -->
     <target name="makejar" depends="build">
         <echo>Compiling a new jar file, named: "gridsim.jar".</echo>
+    	
+    	<!--
         <echo>This jar file only contains GridSim classes but not SimJava2.</echo>
-        <jar destfile="${jar.dir}/gridsim.jar" basedir="${class.dir}" /> 
+        -->
+    	
+    	<echo>Unpacking SimJava2 jar file.</echo>
+    	<delete file="${jar.dir}/gridsim.jar"/>
+		<delete dir="tmp"/>
+		<mkdir dir="tmp"/>
+		
+    	<unjar dest="tmp">
+			<fileset dir="jars" includes="simjava2.jar"/>
+		</unjar>
+		
+    	<echo>Creating GridSim jar file including SimJava2 classes.</echo>
+    	<delete dir="tmp/META-INF"/>
+    	<jar jarfile="${jar.dir}/gridsim.jar" basedir="${class.dir}">
+			<fileset dir="tmp"/>
+		</jar>
+    	<delete dir="tmp"/>
+    	
+        <!--
+        <jar destfile="${jar.dir}/gridsim.jar" basedir="${class.dir}"/>
+         -->
+    	
     </target>        
     
     <target name="clean" description="clean up" >

Added: trunk/readme.txt
===================================================================
--- trunk/readme.txt	                        (rev 0)
+++ trunk/readme.txt	2009-05-22 05:47:14 UTC (rev 269)
@@ -0,0 +1,65 @@
+Readme file
+
+Directory Structure of GridSim Toolkit
+--------------------------------------
+
+$GRIDSIM/               -- the current GridSim directory (top level)
+    classes/            -- The GridSim class files
+    doc/                -- GridSim and SimJava API Documentation
+        eduni/
+        gridsim/
+    examples/           -- GridSim examples, see examples/readme.txt for details
+    jars/               -- jar archives
+    source/             -- The GridSim Java source code
+        gridsim/*.java
+        gridsim/auction/*.java      -- framework for the auction model
+        gridsim/datagrid/*.java     -- framework for the Data Grids model
+        gridsim/filter/*.java       -- filters incoming events
+        gridsim/index/*.java        -- framework for the Grid Info Service model
+        gridsim/net/*.java          -- framework for the network model
+        gridsim/resFailure/*.java   -- framework for the resource failure model
+        gridsim/util/*.java         -- includes some statistics classes.
+        gridsim/parallel/*.java     -- includes scheduling of parallel jobs
+
+GridSim APIs and examples are also available on the GridSim website.
+
+Software Requirements : Java version 1.50 or newer
+---------------------
+GridSim has been tested and run on Sun's Java version 1.5.0 or newer. Older 
+versions of Java are not compatible. You also need to install Ant to compile 
+GridSim (explained in more details later).
+
+
+Installation and Running GridSim Toolkit
+----------------------------------------
+There is no special program to install GridSim. You just need to
+unzip the GridSim file to install.
+If you want to remove GridSim, then remove the whole $GRIDSIM directory.
+
+NOTE: You do not need to compile GridSim source code. The JAR file is
+      provided to compile and to run GridSim applications.
+
+Description of the following jar files:
+* gridsim.jar  -- contains both GridSim and SimJava v2.0 class files
+* simjava2.jar -- contains SimJava v2.0 class files only
+
+To compile and run GridSim applications, do the following step:
+1) Go the directory where the GridSim's examples reside
+   In Unix or Linux: cd $GRIDSIM/examples/
+   In Windows:       cd %GRIDSIM%\examples\
+
+2) Compile the Java source file (e.g. example01)
+   In Unix or Linux: javac -cp $GRIDSIM/jars/gridsim.jar:. gridsim/example01/Example1.java
+   In Windows:       javac -cp %GRIDSIM%\jars\gridsim.jar;. gridsim\example01\Example1.java
+
+3) Running the Java class file
+   In Unix or Linux: java -cp $GRIDSIM/jars/gridsim.jar:. gridsim/example01/Example1
+   In Windows:       java -cp %GRIDSIM%\jars\gridsim.jar;. gridsim\example01\Example1
+
+NOTE:
+* $GRIDSIM or %GRIDSIM% is the location of the GridSim Toolkit package.
+* Running GridSim of this version requires a lot of memory since there are many
+  objects to be created. Therefore, it is recommended to have at least 512MB RAM
+  or increase JVM heap size when running Java for large simulation experiments.
+  For example: java -Xmx300m -classpath $GRIDSIM/jars/gridsim.jar:. gridsim/example01/Example1
+  (max. heap size is 300MB).


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.