Tutorials/CloudSim



Important ===

These tutorials are created for use with CloudSim 2.0.x with Amazon Web Services



Overview ===

CloudSim is an open source web application that launches pre-configured cloud-hosted machines designed to run many of the most common open source robotic tools, especially the open source robotics simulator Gazebo. In these tutorials, we'll explain the basics of using CloudSim.


 * CloudSim 1.7 video overview (1 minutes 44 sec)
 * CloudSim 1.2 video tutorial (3 minutes 21 sec)

CloudSim provides three levels of privileges based on roles: User, Officer, and Administrator, as described below.
 * 1) Roles and Privileges

User Role (Contestant privileges)

CloudSim Users can:
 * start and abort tasks on running constellations
 * monitor constellation latency
 * monitor information about the currently running task
 * task name, world, launch file, and latency parameters
 * real time score for the task
 * obtain the OpenVPN key to connect to the constellation
 * obtain the SSH key to log into the Field machines (not the Simulator, Router, or CloudSim machines)

Officer Role (Simulation configuration privileges)

CloudSim Officers can:
 * perform all tasks allowable by the “User” role
 * add/change/remove access for all non-admin members on a CloudSim instance and change their role
 * obtain SSH keys for the Simulator and Router machines (not the CloudSim machine)
 * terminate a running constellation
 * manage simulation tasks for a constellation:
 * create / delete a simulation task
 * set simulation world, launch file, and traffic shaping parameters

Administrator Role (Full privileges)

CloudSim Administrators can:
 * perform all tasks allowable by the “Officer” and “User” roles
 * configure and launch another CloudSim
 * obtain SSH keys for the CloudSim machine

Administrators can launch cloud instances, set credentials and manage users. Simulation officers can setup simulation campaign and manage tasks. Users can start and stop simulation tasks. While it is OK to allow everyone to be an admin user when using CloudSim for development of robotics systems, roles are useful when evaluating operator performance and to prevent cheating during competitions.

Installation and setup guide (for admin users) ===
 * AWS account and keys: How to get an Amazon AWS account and set it up for CloudSim.
 * CloudSim setup and installation: How to setup a CloudSim instance on AWS, and manage users. Check out our installation video tutorial.
 * CloudSim administration: How to manage users, and set new AWS credentials.

Use CloudSim to manage simulations (for admin users and simulation officers) ===
 * Launch/terminate constellations in the cloud
 * Managing Simulation tasks: How to add, remove and update simulation tasks to a constellation

Use CloudSim to run simulation on exisiting constellations (all users) ===


 * Connect to a cloud simulation with a Virtual Private Network
 * Connect to the machines inside the constellation
 * Running Simulation tasks: How to start and abort simulation tasks
 * Use gzclient on your local machine to connect to a cloud simulation
 * CloudSim tips and tricks

Use web tools ===


 * Introduction to gzweb
 * Introduction to iPython Notebook
 * Notebook: ROS camcorder
 * Notebook: Color blob detection
 * Notebook: tabletop manipulation
 * Other tutorials from DRCSim

Other tutorials ===
 * CloudSim development
 * Troubleshooting CloudSim
 * Alpha OpenStack on Cloudsim

NRI PI Meeting Tutorials (2 Oct 2013) === NRI PI Meeting ROS/Gazebo Tutorials