Home

Awesome

<a id="top"></a>

1. Overview

Consulting Build Status Codacy Badge Codacy Code Coverage Maven Central Documentation Status GPL licensed GitHub Repo stars Twitter Follow

CloudSim Plus is a modern, up-to-date, full-featured and fully documented Java 17 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 reuse 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 started through a partnership between the 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 was partially 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).

Note If you are using CloudSim Plus in your research, please make sure you cite this paper: M. C. Silva Filho, R. L. Oliveira, C. C. Monteiro, P. R. M. Inácio, and M. M. Freire. CloudSim Plus: a Cloud Computing Simulation Framework Pursuing Software Engineering Principles for Improved Modularity, Extensibility and Correctness, in IFIP/IEEE International Symposium on Integrated Network Management, 2017, p. 7.

IMPORTANT


<p align="right"><a href="#top">:arrow_up:</a></p>

<a id="exclusive-features"></a>

2. Main Exclusive Features 🧰

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

  1. It is easier to use. A complete and easy-to-understand simulation scenario can be built in few lines of code.
  2. Multi-cloud simulations with inter-datacenter VM migrations (#361).
  3. Creation of joint power- and network-aware simulations (#45).
  4. Vertical (#7) and Horizontal VM scaling (#41).
  5. Highly accurate power usage computation (#153).
  6. Built-in computation of CPU utilization history and energy consumption for VMs (and Hosts) (#168).
  7. Virtual Memory and Reduced bandwidth allocation when RAM and BW are oversubscribed. (#170).
  8. Automatically power Hosts on and off according to demand (#128) and support defining a startup and shutdown delay/power consumption (#238).
  9. Parallel execution of simulations in multi-core computers, allowing multiple simulations to be run simultaneously in an isolated way (#38).
  10. Delay creation of submitted VMs and Cloudlets, enabling simulation of dynamic arrival of tasks (#11, #23).
  11. Allow dynamic creation of VMs and Cloudlets in runtime, enabling VMs to be created on-demand (#43).
  12. Listeners to enable simulation configuration, monitoring and data collection.
  13. Create simulations from Google Cluster Data trace files. (#149).
  14. Strongly object-oriented, allowing chained calls such as cloudlet.getVm().getHost().getDatacenter() without even worrying about NullPointerException (#10).
  15. Classes and interfaces for implementing heuristics such as Tabu Search, Simulated Annealing, Ant Colony Systems and so on (example here).
  16. Implementation of the Completely Fair Scheduler used in recent versions of the Linux Kernel (example here) (#58).
  17. Host Fault Injection and Recovery Mechanism to enable injection of random failures into Hosts CPU cores and replication of failed VMs (#81).
  18. Creation of Hosts at Simulation Runtime to enable physical expansion of Datacenter capacity (#124).
  19. Enables the simulation to keep running, waiting for dynamic and even random events such as the arrival of Cloudlets and VMs (#130).
  20. TableBuilder objects that are used in all examples and enable printing simulation results in different formats such as Markdown Table, CSV or HTML.
  21. Colors log messages and enables filtering the level of messages to print (#24). If you want to just see messages from warning level, call Log.setLevel(ch.qos.logback.classic.Level.WARN);
  22. Enables running the simulation synchronously, making it easier to interact with it and collect data inside a loop, as the simulation goes on. This brings freedom to implement your simulations (#205).
  23. Allows placing a group of VMs into the same Host. (#90).
  24. Enables Broker to try selecting the closest Datacenter to place VMs, according to their time zone. (#212).
  25. Non-Live VM migration from/to public-cloud datacenters (#437).
  26. Support VM startup/shutdown delay and boot overhead (#435)
  27. It outperforms CloudSim 4, as can be seen here.

<a id="structure"></a>

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 Modules

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.

CloudSim Plus Packages

<p align="right"><a href="#top">:arrow_up:</a></p>

<a id="usage"></a>

4. Project Requirements

CloudSim Plus is a Java 17 project that uses maven for build and dependency management. To build and run the project, you need JDK 17+ installed and an updated version of maven (such as 3.8.6+). Maven is already installed on your IDE. Unless it's out-of-date or you want to build the project from the command line, you need to install maven into your operating system. All project dependencies are download automatically by maven.

5. How to Use CloudSim Plus 👩🏽‍💻

Warning Before trying to use this project, make sure you have JDK 17 installed.

There are 2 ways to use CloudSim Plus:

Check sections below if you want to add CloudSim Plus as a dependency into your own Maven or Gradle project. This way you can start building your simulations from scratch.

5.1 Maven

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

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

5.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:cloudsimplus:LATEST'
}
<p align="right"><a href="#top">:arrow_up:</a></p>

<a id="example"></a>

6. Building CloudSim Plus

CloudSim Plus is a maven project. The previuos section just showed that you don't need to download the project sources to understand how the project works or to create your own experiments or tool on top of CloudSim Plus. You can just download the example's project and start your experiments or a new simulation framewework from there. Anyway, if you want to build CloudSim Plus, you have two ways:

6.1 Using some IDE

Open the project on your favorite IDE and click the build button and that is it.

6.2 Using a terminal

Open a terminal at the project root directory and type one of the following commands:

on Linux/macOS

./mvnw clean install

on Windows

mvnw.cmd clean install

7. A Minimal but Complete Simulation Example ⚙️

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

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 ones available in the cloudsimplus-examples repository.

//Enables just some level of logging.
//Make sure to import org.cloudsimplus.util.Log;
//Log.setLevel(ch.qos.logback.classic.Level.WARN);

//Creates a CloudSimPlus object to initialize the simulation.
var simulation = new CloudSimPlus();

//Creates a Broker that will act on behalf of a cloud user (customer).
var broker0 = new DatacenterBrokerSimple(simulation);

//Host configuration
long ram = 10000; //in Megabytes
long storage = 100000; //in Megabytes
long bw = 100000; //in Megabits/s
        
//Creates one host with a specific list of CPU cores (PEs).
//Uses a PeProvisionerSimple by default to provision PEs for VMs
//Uses ResourceProvisionerSimple by default for RAM and BW provisioning
//Uses VmSchedulerSpaceShared by default for VM scheduling
var host0 = new HostSimple(ram, bw, storage, List.of(new PeSimple(20000)));

//Creates a Datacenter with a list of Hosts.
//Uses a VmAllocationPolicySimple by default to allocate VMs
var dc0 = new DatacenterSimple(simulation, List.of(host0));

//Creates one VM with one CPU core to run applications.
//Uses a CloudletSchedulerTimeShared by default to schedule Cloudlets
var vm0 = new VmSimple(1000, 1);
vm0.setRam(1000).setBw(1000).setSize(1000);

//Creates Cloudlets that represent applications to be run inside a VM.
//It has a length of 1000 Million Instructions (MI) and requires 1 CPU core 
//UtilizationModel defining the Cloudlets use only 50% of any resource all the time
var utilizationModel = new UtilizationModelDynamic(0.5);
var cloudlet0 = new CloudletSimple(10000, 1, utilizationModel);
var cloudlet1 = new CloudletSimple(10000, 1, utilizationModel);
var cloudletList = List.of(cloudlet0, cloudlet1);

broker0.submitVmList(List.of(vm0));
broker0.submitCloudletList(cloudletList);

/*Starts the simulation and waits all cloudlets to be executed, automatically
stopping when there is no more events to process.*/
simulation.start();

/*Prints the 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).

Simulation Results

7.1 Comparison with CloudSim

A complete, side-by-side comparison between CloudSim and CloudSim Plus Java simulation scenarios is available here.

<p align="right"><a href="#top">:arrow_up:</a></p>

<a id="docs-help"></a>

8. 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. Also, check the publications section to access published CloudSim Plus papers.

A Google Group forum is available at https://groups.google.com/group/cloudsimplus and you can also use the Discussions page here.

<p align="right"><a href="#top">:arrow_up:</a></p>

<a id="consulting"></a>

9. Consulting and Professional Support 👨🏽‍🏫

If you are doing research on cloud computing simulation and facing challenging issues, I've started to offer my consulting services.

I can help you with different kinds of issues and provide specific features for your simulations, including resource allocation, task scheduling, VM placement and migration, metrics computation, process automation, debugging, results analysis, validation and more.

If you have a CloudSim project and want to migrate to CloudSim Plus to benefit from its extensive documentation, active development and support, exclusive features, great accuracy and performance, the consulting can be fit for you too.

Get the contact e-mail here.

<a id="general-features"></a>

10. General Features of the Framework 🛠

CloudSim Plus supports modeling and simulation of:

<p align="right"><a href="#top">:arrow_up:</a></p>

<a id="publications"></a>

11. CloudSim Plus Publications 📝

  1. M. C. Silva Filho, R. L. Oliveira, C. C. Monteiro, P. R. M. Inácio, and M. M. Freire. CloudSim Plus: a Cloud Computing Simulation Framework Pursuing Software Engineering Principles for Improved Modularity, Extensibility and Correctness, in IFIP/IEEE International Symposium on Integrated Network Management, 2017, p. 7. If you are using CloudSim Plus in your research, please make sure you cite that paper. You can check the paper presentation here.
  2. White Paper. CloudSim Plus: A Modern Java 17+ Framework for Modeling and Simulation of Cloud Computing Infrastructures and Services. 2016.
  3. R. L. Oliveira. Virtual Machine Allocation in Cloud Computing Environments based on Service Level Agreements (only in Portuguese). Master's Dissertation. University of Beira Interior, 2017 (Supervisor: M. M. Freire).
<p align="right"><a href="#top">:arrow_up:</a></p>

<a id="projects"></a>

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

  1. CloudSim Plus Py4j gateway: building CloudSim Plus simulations in Python
  2. PySDNSim: a Python simulation tool for microservice-based SDN using CloudSim Plus as the underlying framework.
  3. RECAP Discrete Event Simulation Framework: an extension for CloudSimPlus
  4. CloudSim Plus Automation: defining CloudSim Plus simulation scenarios into a YAML file.
  5. LEAF: Simulator for modeling Large Energy-Aware Fog computing environments.
  6. EPCSAC: Extensible Platform for Cloud Scheduling Algorithm Comparison.
  7. SatEdgeSim: A Toolkit for Modeling and Simulation of Performance Evaluation in Satellite Edge Computing Environments.
<p align="right"><a href="#top">:arrow_up:</a></p>

<a id="license"></a>

13. License ⚖️

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

<p align="right"><a href="#top">:arrow_up:</a></p>

<a id="contributing"></a>

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

<p align="right"><a href="#top">:arrow_up:</a></p>