Overview | Exclusive Features | Structure | How to use | Examples | Docs and Help | Why should I care? | Why an independent fork? | Differences from CloudSim | General Features | Publications | Related Projects | License | Contributing

1. CloudSim Plus Overview

CloudSim Plus is a modern, up-to-date, full-featured and fully documented simulation framework. It’s easy to use and extend, enabling modeling, simulation, and experimentation of Cloud computing infrastructures and application services. It allows developers to focus on specific system design issues to be investigated, without concerning the low-level details related to Cloud-based infrastructures and services.

CloudSim Plus is a fork of CloudSim 3, re-engineered primarily to avoid code duplication, provide code reusability and ensure compliance with software engineering principles and recommendations for extensibility improvements and accuracy. It’s currently the state-of-the-art in cloud computing simulation framework.

The efforts dedicated to this project have been recognized by the EU/Brasil Cloud FORUM. A post about CloudSim Plus is available at this page of the Forum, including a White Paper available in the Publications Section.

CloudSim Plus is developed through a partnership between the Systems, Security and Image Communication Lab of Instituto de Telecomunicações (IT, Portugal), the Universidade da Beira Interior (UBI, Portugal) and the Instituto Federal de Educação Ciência e Tecnologia do Tocantins (IFTO, Brazil). It is supported by the Portuguese Fundação para a Ciência e a Tecnologia (FCT) and by the Brazilian foundation Coordenação de Aperfeiçoamento de Pessoal de Nível Superior (CAPES).

2. Main Exclusive Features

CloudSim Plus provides a lot of exclusive features, from the most basic ones to build simple simulations, to advanced features for simulating more realistic cloud scenarios:

VmAllocationPolicy CloudSim 4.0.0 Simulation Time (min) CloudSim Plus 4.3.4 Simulation Time (min) DCs Hosts VMs Cloudlets Simple (WorstFit) 23.9 15.7 1 20000 40000 50000 BestFit** 19.6 15.7 1 20000 40000 50000 FirstFit** 13.6 1.3 1 20000 40000 50000

* More details and results here. ** Only officially available in CloudSim Plus.

3. Project’s Structure

CloudSim Plus has a simpler structure to make it ease to use and understand. It consists of 4 modules, 2 of which are new, as presented below.

cloudsim-plus: the CloudSim Plus cloud simulation framework API, which is used by all other modules. It is the main and only required module you need to write cloud simulations.

cloudsim-plus-examples: includes a series of different examples, since minimal simulation scenarios using basic CloudSim Plus features, to complex scenarios using workloads from trace files or Vm migration examples. This is an excellent starting point for learning how to build cloud simulations using CloudSim Plus.

cloudsim-plus-testbeds: enables implementation of simulation testbeds in a repeatable manner, allowing a researcher to execute several simulation runs for a given experiment and collect statistical data using a scientific approach.

cloudsim-plus-benchmarks: a new module used just internally to implement micro benchmarks to assess framework performance.

It also has a better package organization, improving Separation of Concerns (SoC) and making it easy to know where a desired class is and what is inside each package. The figure below presents the new package organization. The dark yellow packages are new in CloudSim Plus and include its exclusive interfaces and classes. The light yellow ones were introduced just to better organize existing CloudSim classes and interfaces.

4. How to Use CloudSim Plus

There are 4 ways to use CloudSim Plus. It can be downloaded and executed: (i) downloading a zip file using the button at the top of this page; (ii) from the command line; (iii) directly from some IDE; (iv) from Maven Central since you include it as a dependency inside your own project.

You can watch the video below (high quality version here) or follow the instructions in one of the next subsections.

4.1 Via Command Line

Considering that you have git and maven installed on your operating system, download the project source by cloning the repository issuing the command git clone https://github.com/manoelcampos/cloudsim-plus.git at a terminal.

The project has a bash script you can use to build and run CloudSim Plus examples. This is a script for Unix-like systems such as Linux, FreeBSD and macOS.

To run some example, type the following command at a terminal inside the project’s root directory: sh script/bootstrap.sh package.ExampleClassName . For instance, to run the CloudSimExample0 you can type: sh script/bootstrap.sh org.cloudbus.cloudsim.examples.CloudSimExample0 .

The script checks if it is required to build the project, using maven in this case, making sure to download all dependencies. To see which examples are available, just navigate through the examples directory. To check more script options, run it without any parameter.

4.2 By Means of an IDE

The easiest way to use the project is relying on some IDE such as NetBeans, Eclipse or IntelliJ IDEA. Below are the steps to start using the project:

Download the project sources by using: the download button on top of this page; your own IDE for it; or the command line as described above.

Open/import the project in your IDE: For NetBeans, just use the “Open project” menu and select the directory where the project was downloaded/cloned. For Eclipse or IntelliJ IDEA, you have to import the project selecting the folder where the project was cloned. Check an Eclipse tutorial here .

Inside the opened/imported project you will have the cloudsim-plus and cloudsim-plus-examples modules. The cloudsim-plus module is where the simulator source code is, that usually you don’t have to change, unless you want to contribute to the project. The cloudsim-plus-examples is where you can start.

Open the cloudsim-plus-examples module. The most basic examples are in the root of the org.cloudbus.cloudsim.examples package. You can run any one of the classes in this package to get a specific example.

If you want to build your own simulations, the easiest way is to create another class inside this module.

4.3 Adding it as a Maven Dependency into Your Own Project

You can add CloudSim Plus API module (which is the only one required to build simulations) as a dependency inside your own Maven or Gradle project. This way you can start building your simulations from scratch.

4.3.1 Maven

Add the following dependency into the pom.xml file of your own Maven project.

<dependency> <groupId> org.cloudsimplus </groupId> <artifactId> cloudsim-plus </artifactId> <!-- Set a specific version or use the latest one --> <version> LATEST </version> </dependency>

4.3.2 Gradle

Add the following dependency into the build.gradle file of your own Gradle project.

dependencies { //Set a specific version or use the latest one implementation 'org.cloudsimplus:cloudsim-plus:LATEST' }

5. A Minimal and Complete Simulation Example

In order to build a simulation scenario you have to create, at least:

a datacenter with a list of physical machines (Hosts);

a broker that allows submission of VMs and Cloudlets to be executed, on behalf of a given customer, into the cloud infrastructure;

a list of customer’s virtual machines (VMs);

and a list of customer’s cloudlets (objects that model resource requirements of different applications).

Due to the simplicity provided by CloudSim Plus, all the code to create a minimal simulation scenario can be as simple as presented below. A more adequate and reusable example is available here, together with other examples. Specific examples of CloudSim Plus, showing several new exclusive features and advanced scenarios, can be found here.

//Enables just some level of logging. //Make sure to import org.cloudsimplus.util.Log; //Log.setLevel(ch.qos.logback.classic.Level.WARN); //Creates a CloudSim object to initialize the simulation. CloudSim cloudsim = new CloudSim (); /*Creates a Broker that will act on behalf of a cloud user (customer).*/ DatacenterBroker broker0 = new DatacenterBrokerSimple ( cloudsim ); //Creates a list of Hosts, each host with a specific list of CPU cores (PEs). List < Host > hostList = new ArrayList <>( 1 ); List < Pe > hostPes = new ArrayList <>( 1 ); //Uses a PeProvisionerSimple by default to provision PEs for VMs hostPes . add ( new PeSimple ( 20000 )); long ram = 10000 ; //in Megabytes long storage = 100000 ; //in Megabytes long bw = 100000 ; //in Megabits/s //Uses ResourceProvisionerSimple by default for RAM and BW provisioning //Uses VmSchedulerSpaceShared by default for VM scheduling Host host0 = new HostSimple ( ram , bw , storage , hostPes ); hostList . add ( host0 ); //Creates a Datacenter with a list of Hosts. //Uses a VmAllocationPolicySimple by default to allocate VMs Datacenter dc0 = new DatacenterSimple ( cloudsim , hostList ); //Creates VMs to run applications. List < Vm > vmList = new ArrayList <>( 1 ); //Uses a CloudletSchedulerTimeShared by default to schedule Cloudlets Vm vm0 = new VmSimple ( 1000 , 1 ); vm0 . setRam ( 1000 ). setBw ( 1000 ). setSize ( 1000 ); vmList . add ( vm0 ); //Creates Cloudlets that represent applications to be run inside a VM. List < Cloudlet > cloudletList = new ArrayList <>( 1 ); //UtilizationModel defining the Cloudlets use only 50% of any resource all the time UtilizationModelDynamic utilizationModel = new UtilizationModelDynamic ( 0.5 ); Cloudlet cloudlet0 = new CloudletSimple ( 10000 , 1 , utilizationModel ); Cloudlet cloudlet1 = new CloudletSimple ( 10000 , 1 , utilizationModel ); cloudlets . add ( cloudlet0 ); cloudlets . add ( cloudlet1 ); broker0 . submitVmList ( vmList ); broker0 . submitCloudletList ( cloudletList ); /*Starts the simulation and waits all cloudlets to be executed, automatically stopping when there is no more events to process.*/ cloudsim . start (); /*Prints results when the simulation is over (you can use your own code here to print what you want from this cloudlet list).*/ new CloudletsTableBuilder ( broker0 . getCloudletFinishedList ()). build ();

The presented results are structured and clear to allow better understanding. For example, the image below shows the output for a simulation with two cloudlets (applications).

6. Documentation and Help

The project documentation originated from CloudSim was entirely updated and extended. You can see the javadoc documentation for classes and their elements directly on your IDE.

The documentation is available online at ReadTheDocs, which includes a FAQ and guides. CloudSim Plus has extended documentation of classes and interfaces and also includes extremely helpful package documentation that can be viewed directly on your IDE or at the link provided above. Such a package documentation gives a general overview of the classes used to build a cloud simulation.

A Google Group forum is also available at https://groups.google.com/group/cloudsim-plus. See the publications section to access published CloudSim Plus papers.

6.1. Why should I care about this CloudSim fork? I just want to build my simulations.

Well, the design of the tool has a direct impact when you need to extend it to include some feature required for your simulations. The simulator has a set of classes that implement interfaces such as VmScheduler , CloudletScheduler , VmAllocationPolicy , ResourceProvisioner , UtilizationModel , PowerModel and DatacenterBroker and provide basic algorithms for different goals. For instance, the VmAllocationPolicySimple class implements a Worst Fit policy that selects the PM which less processor cores in use to host a VM and, in fact, it is the only policy available.

Usually you have to write your own implementations of these classes, such as a Best Fit VmAllocationPolicy , a resource UtilizationModel with an upper threshold or a DatacenterBroker that selects the best Datacenter to submit a VM.

Several software engineering principles aim to ease the task of creating new classes to implement those features. They also try to avoid forcing you to change core classes of the simulator in order to introduce a feature you need to implement. Changing these core classes just to implement a particular feature which will be used only in your simulations is a bad practice, since you will not be able to automatically update your project to new versions of the simulator, without losing your changes or struggling to fix merge conflicts.

As we have seen in forums that we’ve attended, many times users have to perform these changes in core classes just to implement some specific features they need. We think those problems are enough reasons that show the need of a new re-engineered version of the simulator.

6.2. But why an independent CloudSim fork?

The original CloudSim moved on to a new major release, introducing a completely new set of classes to provide Container as a Service (CaaS) simulations, before the changes proposed here being merged to the official repository. This way, all the work performed here was not incorporated to allow this new CaaS module to be developed using this redesigned version. Unfortunately, there are several months of hard work that would need to be replicated to merge both projects. In reason of that, CloudSim Plus was born as an independent fork, following its own way and philosophies.

It’s much easier to use CloudSim Plus. A complete, side-by-side comparison between CloudSim and CloudSim Plus Java simulation scenarios is available here.

To update your simulations to use the CloudSim Plus you have to change the way that some objects are instantiated, because some new interfaces were introduced to follow the “program to an interface, not an implementation” recommendation and also to increase abstraction. These new interfaces were also crucial to implement the Null Object Pattern to try avoiding NullPointerException s.

The initialization of the simulation is not performed by the static CloudSim.startSimulation method anymore, which required a lot of parameters. Now you have just to instantiate a CloudSim object using the default, no-arguments constructor, as shown below. This instance is used in the constructor of DatacenterBroker and Datacenter objects:

CloudSim cloudsim = new CloudSim ();

The classes Datacenter , DatacenterCharacteristics , Host , Pe , Vm and Cloudlet were renamed due to the introduction of interfaces with these same names. Now all these classes have a suffix Simple (as already defined for some previous classes such as PeProvisionerSimple and VmAllocationPolicySimple ). For instance, to instantiate a Cloudlet you have to execute a code such as:

CloudletSimple cloudlet = new CloudletSimple ( required , parameters , here );

However, since these interfaces were introduced in order to also enable the creation of different cloudlet classes, the recommendation is to declare your object using the interface, not the class:

Cloudlet cloudlet = new CloudletSimple ( required , parameters , here );

The method setBrokerId(int userId) from Vm and Cloudlet were refactored to setBroker(DatacenterBroker broker) , now requiring a DatacenterBroker instead of just an int ID which may be even nonexistent.

You don’t need to explicitly create a DatacenterCharacteristics anymore. Such object is created internally when a Datacenter is created. A VmAllocationPolicy doesn’t require any parameter at all. A Datacenter doesn’t require a name, storage list and scheduling interval too. The name will be automatically defined. It and all the other parameter can be set further using the respective setter methods. Now it is just required a CloudSim , a Host list and a VmAllocationPolicy instance.

Datacenter dc0 = new DatacenterSimple ( cloudsim , hostList , new VmAllocationPolicySimple ());

The way you instantiate a host has changed too. The classes RamProvisionerSimple and BwProvisionerSimple don’t exist anymore. Now you just have the generic class ResourceProvisionerSimple and you can just use its default no-args constructor. RAM and bandwidth capacity of the host now are given in the constructor, as it already was for storage. A VmScheduler constructor doesn’t require any parameter. You don’t need to set an ID for each Host, since if one is not given, when the List of hosts is attached to a Datacenter, it will generate an ID for those hosts. Instantiating a host should be now similar to:

long ram = 20480 ; //in MB long bw = 1000000 ; //in Megabits/s long storage = 1000000 ; //in MB Host host = new HostSimple ( ram , bw , storage , pesList ); host . setRamProvisioner ( new ResourceProvisionerSimple ()) . setBwProvisioner ( new ResourceProvisionerSimple ()) . setVmScheduler ( new VmSchedulerTimeShared ());

Additionally, the interface Storage was renamed to FileStorage and its implementations are SanStorage and HarddriveStorage , that can be used as before. Finally, since the packages were reorganized, you have to adjust them. However, use your IDE to correct the imports for you. A complete and clear example was presented in the Examples section above.

7. General Features of the Framework

CloudSim Plus supports modeling and simulation of:

large scale Cloud computing data centers;

virtualized server hosts, with customizable policies for provisioning host resources to virtual machines;

data center network topologies and message-passing applications;

federated clouds;

user-defined policies for allocation of hosts to virtual machines and policies for allocation of host resources to virtual machines.

8. CloudSim Plus Publications

9. Related Projects

Here, it’s presented a list of some projects based on CloudSim Plus, which trust in its accuracy, performance, maintainability and extensibility. If you want your project to be listed here, send us a Pull Request. Make sure your project has a descriptive README.

10. Contributors

Code Contributors

This project exists thanks to all the people who contribute. [Contribute].

Financial Contributors

Become a financial contributor and help us sustain our community. [Contribute]

Individuals

Organizations

Support this project with your organization. Your logo will show up here with a link to your website. [Contribute]

11. License

This project is licensed under GNU GPLv3, as defined inside CloudSim 3 source files.

12. Contributing

You are welcome to contribute to the project. However, make sure you read the contribution guide before starting. The guide provides information on the different ways you can contribute, such as by requesting a feature, reporting an issue, fixing a bug or providing some new feature.