Distributed Consensus - Raft

Welcome to the Raft implementation of group 5 in the course T-419-CADP at Reykjavik University. Below are instruction on how to run the code, what commands are avaible and more.

Server

# from ./
cd server
go run . <server-host>:<server-port> <filename>

Server Commands

log: The log commands outputs the logs of the server to the stdout

print: The print commands displays useful information about the state of the server to the stdout

resume: Resume a suspended process

suspend: Suspend a process, moves it to a failed state

timeout: Artificially timesout the process, moves it to a candidate state

Client

# from ./
cd client
go run . <server-host>:<server-port>

Client Commands

exit: exits the program

Debug mode

We use a debug value for our timeouts to better see the functionality of the algorithm.

Adjust this scale to fit your purpose, or remove it all together. This function can be found in the util folder.

func GetRandomTimeout() time.Duration {
	debugScale := 1
	return time.Duration(rand.IntN(300*debugScale)+150*debugScale) * time.Millisecond
}

Report

The pdf report is included in the repository here.

Acknowledgements

Converting bytes to string