DISTRIBUTED-FILE-SYSTEM -

An implementation of distributed file system in C with user management which stores files across multiple servers and retrieve the files stored when required. Files are split into multiple chunks (depending on number of servers) and each of those chunks are partitioned across the servers on the basis of hash-value of the file contents. A chunk is stored on more than one servers to account for server failure(s) if any.

Implementation also supports handling multiple (using forking) clients with valid user name and password in parallel.

USAGE -

Compiling:

make dfs : Compiles the server instance in bin/dfs
make dfc : Compiles the client instance in bin/dfc
make client : Compiles the client instance in bin/dfc and starts the client instance (reading configuration file from conf/dfc.conf)
make clear : Clears the content of DFS directories
make kill : Kills the running server instance
make clean : Deletes previously created binary files
make start : Starts four server instances and stores logs corresponding to each instance in logs/ folder
make run : Starts tail -f on logs/ directory
make all : Runs clean dfs dfc start run targets

Starting Server:

To start all the servers at once use make start or to manually start ith server use following command:

bin/dfs /DFS<i> <ith port number>

Server reads its configuration file which has user name and passwords from conf/dfs.conf

Starting Client:

To start client via make file use make client or to manually start the client use following command:

bin/dfc <configuration-file-path>

Configration file is a required arguement, refer to conf/dfs.conf for sample configuration file

COMMANDS -

After successfully compiling and running servers and client, following commands can be sent to servers via clients command line prompt

GET

Used to fetch the remote file from servers into a local directory. This gives an error in case not enough servers are running to get the file properly or in case remote-file-path or local-file-path doesn't exist.

Syntax: GET <local-file-path> <remote-file-path>

PUT

Used to put a local file onto servers. This gives an error in case remote-file-path or local-file-path does not exsts. Please do not execute this command when not all the servers are up and running.

Syntax: PUT <local-file-path> <remote-file-path

LIST

Lists all the files and folders in give directory. Gives an error when requested remote folder does not exists. Along with file name it also shows whether or not file can be successfully downloaded from the servers. If file cannot be downloaded properly the command append INCOMPLETE with the file name.

Syntax: LIST <remote-folder-name>

MKDIR

Makes a directory or sub-directories in the path sent. Gives an error when requested folder already exists. Pleae do not execute this command when not all the servers are up and running.

Syntax: MKDIR <remote-folder-name>

imrajdeepb / distributed-file-system Goto Github PK