Promotion documentation for CloudSim 3.0 added.

documentation/src/main/resources/changelog.txt

+-----------------------------------------
+Changes from CloudSim 2.1 to CloudSim 3.0
+-----------------------------------------
+
+WHAT'S NEW
+----------
+
+- NEW VM SCHEDULER. VmSchedulerTimeSharedOverSubscription models a scheduler that allows unbounded number of
+VMS to be deployed in a single VM, regardless its requirements in terms of number of MIPS. Notice that this
+was the behaviour of VmSchedulerTimeShared in CloudSim 1.0 Beta, but this behaviour had changed in
+CloudSim 2.0 to accommodate requests with specific amount of MIPS.
+
+- NEW DATACENTER NETWORK MODEL. A internal network model has been added to CloudSim 3.0. It supports definition
+of switches connecting hosts in arbitrary network topologies. New Vm classes and Cloudlet classes were added to
+take advantage of this feature without breaking compatibility of older code. This new feature also enables
+modelling of message-passing applications. They are included in the package 'network.datacenter'.
+
+- NEW POWER MODELS. 3 power models of IBM servers using the data from SPECpower were added to the power package.
+They are PowerModelSpecPowerIbmX3250XeonX3480, PowerModelSpecPowerIbmX3550XeonX5670, and
+PowerModelSpecPowerIbmX3550XeonX5675.
+
+- SUPPORT FOR EXTERNAL WORKLOADS. External workloads written in the Standard Workload Format (SWF, from the
+Parallel Workload Archive) can be loaded and read by CloudSim. Relevant classes are WorkloadModel and
+WorkloadFileReader ('util' package).
+
+- SUPPORT FOR USER-DEFINED END OF SIMULATION. Users are now able to specify a given event that causes the simulaton
+to finish. We thanks Gaston Keller for developing this new feature.
+
+
+REMOVED CLASSES
+---------------
+
+- CloudCoordinator
+- Sensor
+- CloudCoordinator
+- PowerPe
+- Power.PeList
+
+
+API CHANGES
+-----------
+
+- CloudSim.terminateSimulation(long time) was changed to CloudSim.terminateSimulation(double time), to comply
+with clock field of CloudSim class.
+- PowerModel was moved from PowerPe to PowerHost
+
+
+BUGFIXES AND IMPROVEMENTS
+-------------------------
+
+- Fixed issue 20: HostDynamicWorkload.updateVmsProcessing() throws NullPointerException.
+- Fixed issue 19: CloudSimTags class should be abstract, not final.
+- Fixed issue 17: "Something is wrong, the VM can's be restored" should be an Exception.
+- Fixed issue 16: cloudletsSubmitted in DatacenterBroker should be protected, not private.
+- Fixed issue 15: Simulation failed by the RAM where it should not fail.
+- Fixed issue 14: Rounding problem in VMSchedulerTimeShared.
+- Fixed issue 13: Output error when setDisableMigrations is set to true.
+- Fixed issue 12: Dynamically created space-shared VMs fail to process cloudlets.
+- Fixed issue 11: Wrong sharing of MIs among VMs by VmSchedulerTimeShared.
+- Fixed issue 10: Access modifier of DatacenterBroker::finishExecution().
+- Fixed issue 9:  Access modifier of DatacenterBroker::cloudletsSubmitted.
+- Fixed issue 7:  Problem in manifests of Maven-generated jar files.
+- Fixed issue 5:  Abrupt termination of the simulation caused by VmAllocationPolicySimple.
+- Fixed issue 4:  Network examples do not load topology file.
+- Fixed issue 2:  Turn the 'future' queue of CloudSim class protected.
+- Fixed issue 1:  VM is created without check on host's storage capacity.
+- The power package and corresponding examples were heavily updated, as well as new PlanetLab workload data were added.
+- Fix in Datacenter: one initial update step was been skipped, what caused malfunctions in the schedulers.
+- Fixed issue affecting all CloudletSchedulers: if updated was less then 1, due to a small timespam, processing was
+  never updated, because it was always rounded to 0.
+- Datacenter: Fixed problem with very short intervals between events.
+
+
 -----------------------------------------
 Changes from CloudSim 2.0 to CloudSim 2.1
 -----------------------------------------
@@ -9,7 +82,7 @@ Changes from CloudSim 2.0 to CloudSim 2.1
 - The VmSchedulerTimeSharedWithPriority has been removed as well as the priority field from the 
   Vm class. Users can have the same functionality by using the VmSchedulerTimeShared class and 
   setting the MIPS requirements for VMs. See examples 2 and 3. 
-- Bug fixes, refactoring and removing obsolete code.
+- Bug fixes, refactoring and removal of obsolete code.
 
 
 ----------------------------------------------

documentation/src/main/resources/readme.txt

@@ -78,3 +78,16 @@ Note:
 
   * You need to set up PATH for ant in Windows and/or Unix.
   
+  
+ 7. Downloading and using external jars
+---------------------------------------
+
+Utilization of the power package (for energy modelling) requires the Michael Thomas
+Flanagan's Java Scientific Library. This library can be downloaded from
+
+http://www.ee.ucl.ac.uk/~mflanaga/java/
+
+Please, make sure that, by using such library, you are respecting the terms of use
+defined by the software's author.
+
+

documentation/src/main/resources/release_notes.txt

 
-            Cloudsim Project to Release CloudSim Toolkit 2.0
-
-The Cloudbus Project at The University of Melbourne, Australia along with collaborators
-from the High Performance Lab (LAD) at Pontifical Catholic University of Rio Grande do Sul
-(PUCRS), Porto Alegre, Brazil is proud to announce the release of the new version of its
-Cloud simulation software, the CloudSim.
-
-One year has passed since CloudSim beta was released. Since then, Cloud computing has gained
-more visibility, and a plenty of new projects, both in academia and in the industry, emerged.
-To help developers of such projects to evaluate new strategies and ideas before actual
-development, CloudSim 2.0 contains support for model and simulation of hot topics in Cloud
-Computing, including green/power-aware Cloud Computing and federated Cloud Computing.
-
-At the same time new features were added, major improvements in simulation core allowed enhanced
-scalability and performance of simulations and insertion and removal of simulation entities
-during simulation execution. It increases considerably scenarios that may be addressed in
-simulations, what we hope will contribute to a wider adoption of the tool by the research
-community.
-
-These improvements were possible due to extensive support from the Cloud Computing research
-community around the world, which used CloudSim, appointed bugs, and provided us feedback on
-new features they would like to have in future versions the toolkit. Community is invited to
-keep contribution to CloudSim.
-
-As in its previous version, all components developed as part of the CloudSim Toolkit are released
-as "open source" under the GPL license to encourage innovation and pass full freedom to our users.
+            Cloudsim Project to Release CloudSim Toolkit 3.0
+
+The Cloudbus Project at The University of Melbourne, Australia  is proud to announce the
+release of the new version of its Cloud simulation software, the CloudSim.
+
+One year has passed since last version of CloudSim was released. Cloud computing now is
+mainstream, and has been heavily adopted by different industries. It is also omnipresent in
+conferences and journals from diverse fields such as high performance computing, grid computing,
+distributed systems, operating systems, software engineering, databases and so on. CloudSim has
+been present in publications in all the above fields.
+
+To help in further developments in the field of Cloud computing regardless the main area of
+application, new features and improvements were added to CloudSim 3.0. Having the project
+hosted in Google code allowed us to have an enhanced feedback from users, via issue tracking
+and group discussion. Based on this feedback, we could identify bugs, concepts that where being
+misinterpreted by users and features of little significance and complexity. In response to this
+feedback, we fixed all the identified bugs, clarified confusing aspects of the tool, and removed
+features that were proven to be unpopular with users and just were making the APIs confusing.
+
+This version of CloudSim brings enhanced modelling of power-aware and energy efficient Cloud
+computing, and also a new package allowing modelling of internal data center topologies and
+message-passing applications.
+
+We encourage community to keep collaborating with us by appointing bugs, providing us feedback on
+new features they would like to have in future versions the toolkit, and also developing their
+own extension packages, which we will be happy in promoting in the project homepage. We will also
+be happy in listing in our homepage scientific peer-reviewed papers whose results were obtained
+with CloudSim. 
+
+As in its previous version, all components developed as part of the CloudSim Toolkit are open
+source released under the LGPL license to encourage innovation and pass full freedom to our users.
+
+We would like to thanks all the support we have received from users all around the world. Your
+contribution in finding and reporting bugs, proposing (and developing) new features, and even in
+using CloudSim has been paramount in the success of the project. 
 
 To download the CloudSim software, please visit the Cloudbus Project web site at
 http://www.cloudbus.org/cloudsim/
 
 The CloudSim Team
-Melbourne, May 2010
\ No newline at end of file
+Melbourne, January 2012
\ No newline at end of file