skip to navigation
skip to content

Not Logged In

cloudlet 0.8

Cloudlet library for cloud computing at the edge

Latest Version: 0.8.2

Elijah: Cloudlet Infrastructure for Mobile Computing
========================================================
A cloudlet is a new architectural element that arises from the convergence of
mobile computing and cloud computing. It represents the middle tier of a
3-tier hierarchy: mobile device - cloudlet - cloud. A cloudlet can be
viewed as a "data center in a box" whose goal is to "bring the cloud closer".
A cloudlet has four key attributes:

Copyright (C) 2011-2012 Carnegie Mellon University
This is a developing project and some features might not be stable yet.
Please visit our website at [Elijah page]http://elijah.cs.cmu.edu/)


License
----------

All source code, documentation, and related artifacts associated with the
cloudlet open source project are licensed under the [Apache License, Version
2.0]http://www.apache.org/licenses/LICENSE-2.0.html)


Installing
----------

You will need:

* qemu-kvm
* libvirt-bin
* gvncviewer
* python-libvirt
* python-xdelta3
* python-dev (for message pack)
* liblzma-dev (for pyliblzma)
* Java JRE (for UPnP server)
* apparmor-utils (for disable apparmor for libvirt)
* libc6-i386 (for extracting free memory of 32 bit vm)
* python library
- bson
- pyliblzma
- psutil
- SQLAlchemy
- fabric

To run install script:

> $ sudo apt-get install fabric openssh-server
> $ fab localhost install

To install manually:

1. install required package
> $ sudo apt-get install qemu-kvm libvirt-bin gvncviewer python-libvirt python-xdelta3 python-dev openjdk-6-jre liblzma-dev apparmor-utils libc6-i386 python-pip
> $ sudo pip install bson pyliblzma psutil sqlalchemy

2. Disable security module. This is for allowing custom KVM.
Example at Ubuntu 12

> $ sudo aa-complain /usr/sbin/libvirtd

3. add current user to kvm, libvirtd group.

> $ sudo adduser [your_account_name] kvm
> $ sudo adduser [your_account_name] libvirtd

4. change permission of the fuse access (The qemu-kvm library changes fuse
access permission while it's being installed, and the permission is
recovered if you reboot the host. We believe this is a bug in qemu-kvm
installation script, so you can either reboot the machine to have valid
permission of just revert the permission manually as bellow).

> $ sudo chmod 1666 /dev/fuse



Recommended platform
---------------------

We have tested at __Ubuntu 12.04 LTS 64-bit__

This version of Cloudlet has several dependencies on other projects for
further optimization, and currently we include this dependency as a binary.
Therefore, we recommend you to use __Ubuntu 12.04 LTS 64-bit__



How to use
--------------

1. Creating ``base vm``.
You will first create ``base vm`` from a regular VM disk image. This ``base
vm`` will be a template VM for overlay VMs. To create ``base vm``, you need
regular VM disk image in a raw format.

> $ cd ./bin
> $ ./cloudlet base /path/to/base_disk.img
> (__Use raw file format__)

This will launch remote connection(VNC) to guest OS and cloudlet module
will automatically start creating ``base vm`` when you close VNC window.
After finishing all the processing, you can check generated ``base vm``
using below command.

> $ cd ./bin
> $ ./cloudlet list_base


2. Creating ``overlay vm`` on top of ``base vm``.
Now you can create your customized VM based on top of ``base vm``

> $ cd ./bin
> $ ./cloudlet overlay /path/to/base_disk.img

This will launch VNC again. On top of this ``base vm``, you can install(and
execute) your custom server. For example, if you're a developer of ``face
recognition`` backend server, we will install required libraries and start
your server. Cloudlet will automatically extracts this customized part from
the ``base vm`` when you close VNC, and it will be your overlay.

``overlay VM`` is composed of 2 files; 1) ``overlay-meta file`` ends with
.overlay-meta, 2) compressed ``overlay blob files`` ends with .xz


Note: if your application need specific port and you want to make a port
forwarding host to VM, you can use -redir parameter as below.

> $ ./cloudlet overlay /path/to/base_disk.img -- -redir tcp:2222::22 -redir tcp:8080::80

This will forward client connection at host port 2222 to VM's 22 and 8080
to 80, respectively.


### Note

If you have experience kernel panic error like
[this]https://github.com/cmusatyalab/elijah-cloudlet/issues/1) You should
follow workaround of this link. It happens at a machine that does not have
enough memory with EPT support, and you can avoid this problem by disabling
EPT support. We're current suspicious about kernel bug, and we'll report
this soon.


3. Synthesizing ``overlay vm``

Here, we'll show 3 different ways to perform VM synthesis using ``overlay
vm`` that you just generated; 1) verifying synthesis using command line
interface, 2) synthesize over network using desktop client, and 3)
synthesize over network using Android client.

1) Command line interface: You can resume your ``overlay vm`` using

> $ cd ./bin
> $ ./cloudlet synthesis /path/to/base_disk.img /path/to/overlay-meta

2) Network client (python version)

We have a synthesis server that received ``VM synthesis`` request from
mobile client and you can start the server as below.

> $ cd ./bin
> $ ./server

You can test this server using the client. You also need to copy the
overlay that you like to reconstruct to the other machine when you execute
this client.

> $ ./rapid_client.py -s [cloudlet ip address] -o [/path/to/overlay-meta]


3) Network client (Android version)

We have source codes for android client at ./src/client/andoid and you can
import it to ``Eclipse`` as an Android porject. This client program will
automatically find nearby Cloudlet using UPnP if both client and Cloudlet
are located in same broadcasting domain (ex. share WiFi access point)

Once installing application at your mobile device, you should copy your
overlay VM (both overlay-meta and xz file) to Android phone. You can copy
it to /sdcard/Cloudlet/overlay/ directory creating your overlay directory
name. For example, you can copy your ``face recognition overlay vm`` to
/sdcard/Cloudlet/overlay/face/ directory. This directory name will be
appeared to your Android application when you're asked to select ``overlay
vm``. Right directory name is important since the directory name will be
saved as appName in internal data structure and being used to launch
associated mobile application after finishing ``VM synthesis``. See more
details at handleSucessSynthesis() method at CloudletConnector.java file.



Compiling external library that Cloudlet uses
----------------------------------------------

You will need:

* qemu-kvm 1.1.1 (for Free memory and TRIM support)
* libc6-dev-i386 (for Free memory support)


Research works
--------------------------

* [The Case for VM-based Cloudlets in Mobile Computing]http://www.cs.cmu.edu/~satya/docdir/satya-ieeepvc-cloudlets-2009.pdf
* The Impact of Mobile Multimedia Applications on Data Center Consolidation (To be appeared)
* [Just-in-Time Provisioning for Cyber Foraging]http://reports-archive.adm.cs.cmu.edu/anon/2012/CMU-CS-12-148.pdf
* [Scalable Crowd-Sourcing of Video from Mobile Devices]http://reports-archive.adm.cs.cmu.edu/anon/2012/CMU-CS-12-147.pdf  
File Type Py Version Uploaded on Size
cloudlet-0.8.tar.gz (md5) Source 2013-08-16 5MB
  • Downloads (All Versions):
  • 7 downloads in the last day
  • 50 downloads in the last week
  • 115 downloads in the last month