Skip to content

Latest commit

 

History

History
41 lines (30 loc) · 1.67 KB

README.md

File metadata and controls

41 lines (30 loc) · 1.67 KB
Raw

Sapphire

Organization

This directory contains all of the code for running Sapphire as a Java library with your Android apps. We also include our example applications, performance testing applications and scripts for deploying applications across servers.

  • deployment: scripts for running Sapphire applications on servers. Starts the Sapphire servers for the "cloud side" and the OMS (called the OTS in the paper).

  • example_apps: our to do list application and twitter-like application.

  • generators: scripts for running our compiler for generating Sapphire object stubs and DM stubs.

  • sapphire: the core sapphire library. It is deployed as an Android app.

    • src/sapphire/app: Application specific classes, like the starting point for bootstrapping a Sapphire app.
    • src/sapphire/common: Basic data structures.
    • src/sapphire/compiler: our compiler for generating Sapphire object and DM component stubs.
    • src/sapphire/dms: some example deployment managers
    • src/sapphire/kernel: the Sapphire kernel server that runs as a library on every node that runs a Sapphire app.
    • src/sapphire/oms: the Object Management/Tracking Service. (called the OTS in the paper).
    • src/sapphire/runtime: library functions for creating a Sapphire object (hack because we don't have sapphire keywords in the JVM).

  • tests: performance testing apps. Good example simple example application with one Sapphire object.

Setting up

  1. Place your servers in deployment/servers.json.

  2. Place the config for the app that you want to run in deployment/app.py. This file needs a starting point for the server-side and the client-side of your Sapphire app.

  3. Run deploy.py to run the app