Tutorials/CloudSim/1.4/task

Managing Simulation tasks ==

This tutorial describes how to:


 * Add and remove simulation tasks to a running CloudSim constellation

Prerequisites ==

For this tutorial, you will need to have access to a running constellation (vpc_trio or simulator). You will also need to be logged in as "simulation officer" or "admin" user.

Please familiarize yourself with the following tutorials:
 * AWS account and keys (to get started with AWS)
 * CloudSim setup and installation (to launch your CloudSim machine(s) in the Cloud)
 * CloudSim administration (to setup users inside your CloudSim web app)

Introduction ==

CloudSim's purpose is to allow users to run simulations in the cloud. In that context, running a simulation involves more than starting a simulator process. The simulation run encompasses:


 * Loading simulated virtual world with objects and physics
 * The software
 * Monitoring the execution of the run (scoring, pass/fail)
 * Regulating the access to the simulation (bandwidth, data cap, latency)

Also, a constellation has to be able to handle multiple simulation runs.

CloudSim introduces the concept of simulation task to manage this.

Tasks panel ==

Constellations that support simulators have a "Simulation tasks" panel in their Constellation UI. This panel allows the user to view the current list of tasks for this constellation. CloudSim users with "Officer" privileges will also be able to create and delete additional tasks.



Creating a task ==


 * This operation requires "Simulation Officer" or "Admin" user privileges



View or update a task ==


 * This operation requires "Simulation Officer" or "Admin" user privileges to update a task
 * Everyone can view a task



Deleting a task ==


 * This operation requires "Simulation Officer" or "Admin" user privileges



Each task has an 'X' button that allows the user to delete it from the list.

Running and stopping a task ==


 * This operation can be performed by anyone

Each task can run only once. A task can be started if its status (the circle at the left of the task) is gray.


 * To start a task, simply press the 'Start' button on the task.
 * To stop the currently running task, press the "Stop current task".

Task status:
 * [[file:status gray.png|20px]] Fixed gray. This indicates that the task is ready to start.
 * [[file:status yellow.png|20px]] Blinking yellow. This indicates that the simulator process is launching and that the plugins and ROS node are being setup.
 * [[file:status blue.png|20px]] Blinking blue. This means that the simulator is up and running, and the task is being executed.
 * [[file:status orange.png|20px]] Blinking orange. The task was successful and is in the process of stopping. The simulation is being shutdown.
 * [[file:status red.png|20px]] Blinking red. The task has failed and is in the process of stopping. The simulation is being shutdown.
 * [[file:status blue.png|20px]] Fixed blue. The task has been executed successfully. The task has been terminated by the simulator. The task can not be run again.
 * [[file:status red.png|20px]] Fixed red. The task has failed. The simulator detected a failure or the user stopped the task. The task can not be run again.