https://github.com/ahelwer/paxoscluster

A framework for distributed applications
https://github.com/ahelwer/paxoscluster

Last synced: 2 months ago
JSON representation

A framework for distributed applications

• Host: GitHub
• URL: https://github.com/ahelwer/paxoscluster
• Owner: ahelwer
• License: mit
• Created: 2014-01-18T20:47:24.000Z (almost 11 years ago)
• Default Branch: master
• Last Pushed: 2020-09-28T13:37:22.000Z (over 4 years ago)
• Last Synced: 2024-10-16T08:48:22.805Z (3 months ago)
• Language: Go
• Homepage:
• Size: 13.5 MB
• Stars: 59
• Watchers: 7
• Forks: 13
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
PaxosCluster

============

A framework for distributed applications. Implements the Multi-Paxos protocol. Written in Go 1.2.

Video demo: http://www.youtube.com/watch?v=jyel-iADuUU

Full spec: https://skydrive.live.com/redir?resid=55025043B9B81FAF%215025

Video explaining the protocol: http://www.youtube.com/watch?v=JEpsBg0AO6o

## Build

1. Download & install Go version 1.X from https://golang.org/dl/

2. Clone this repo into $GOPATH/src/github/paxoscluster

3. Open a terminal in the paxoscluster directory and run `go build`

## Run on local machine

This mode of operation spins up five goroutines on your local machine, each acting as an independent process running the Paxos protocol (with replica IDs 1-5) listening on ports 10000-10004.

You can then type arbitrary text into the console, and upon pressing enter the text will be used as a proposed value for the next available multi-paxos slot.

The replicas persist their log to disk in the `coldstorage` directory.

All requests are sent to the proposer with ID 5, and fault injection is not supported.

To run in this mode, execute `go run simplecluster.go runlocal`, or after building execute `PaxosCluster runlocal`.

Exit using ctrl+c.

You can change the ports on which the processes listen by editing the `coldstorage/peers.csv` file.

## Run on cluster of machines

TODO