Lamport's Clock

Introduction

Implement a distributed file replication system. Assuming no transport failure. More information on the problem here.

Requirements

System requirements:

1. Java 10 or higher
2. JDK 10 or higher
3. JRE 1.8 or higher
4. Maven
5. Windows 10 and/or Ubuntu LTS 18.4 (tested)

Files requirements:

1. Each server's directory that stores the files to be written to by the Clients must be in this format: File#.txt (i.e. File1.txt, File2.txt, etc.) as samples here

How to run

Build

1. Run the following command from the root directory:

mvn clean install -U
mvn package

2. A jar file should be generated under Server/target/ and Client/target directories

Run

Interactively

1. Start multiple instances of Server either from IDE or by running command java -jar Name.jar where Name is the rest of the jar file name in the Server/target/ directory, then populate all necessary fields on them as prompted, but DO NOT choose to start any instance until all server instances are ready to be activated
2. Activate (choose start) all Server instances at the same time
3. Start multiple instances of Client either from IDE or by running command java -jar Name.jar where Name is the rest of the jar file name in the Client/target/ directory, populate all necessary fields on them as prompted, but DO NOT choose to start any instance until all server instances are ready to be activated
4. Activate (choose start) all Client instances at the same time

Statically

1. Create configuration file for each Server instance following this format with: line 1 as the file directory; line 2 as server's IP name, address, and port number; line 3 as list of other servers' names, IP addresses, and ports separated by pipe
2. Create configuration file for each Client instance following this format with: line 1 as the client name; line 2 as list of other servers' names, IP addresses, and ports separated by pipe
3. Run java -jar Name.jar Path where Name is the rest of the jar file name in the Server/target/ directory and Path is the full path to the server's configuration file created above at the same time
4. Run java -jar Name.jar Path where Name is the rest of the jar file name in the Client/target/ directory and Path is the full path to the client's configuration file created above at the same time

Local Simulator

A set of automated PowerShell scripts are provided to automatically run all servers and clients on a local machine to test. Follow these steps to run:

1. Go to Scripts directory using PowerShell
2. Run ./Build-Local.ps1 to build the entire project
3. Run ./Start-Local-Server.ps1 to start all (3) server instances
4. Run ./Start-Local-Client.ps1 to start all (5) client instances

For UNIX-related system, run the corresponding .sh scripts instead. Note that you may need to reformat those files to make them UNIX-compatible using the below command:

sudo apt install dos2unix
dos2unix *.sh