Computer Sicence

Scalable Distributed Systems

Project #1 Single Server, Key-Value Store (TCP and UDP)

Assignment Overview

For this project, you will write a server program that will serve as a key value store. It will be set up to allow a single client to communicate with the server and perform three basic operations:     1) PUT (key, value)

2) GET (key)

3) DELETE (key)

A Hash Map could be used for setting up Key value stores.

For this project you will set up your server to be single-threaded and it only has to respond to a  single request at a time (e.g. it need not be multi-threaded – that will be part of Project #2). You must also use two distinct L4 communication protocols: UDP and TCP. What this means is that your client and server programs must use sockets (no RPC….yet, that’s project #2) and be

configurable such that you can dictate that client and server communicate using UDP for a given test run, but also be able to accomplish the same task using TCP. If you choose, you could have   two completely separate sets of applications, one that uses UDP and one that uses TCP or you      may combine them.

Your implementation may be written in Java. Your source code should be well-factored and well- commented. That means you should comment your code and appropriately split the project into    multiple functions and/or classes; for example, you might have a helper function/class to encode/ decode UDP packets for your protocol, or you might share some logic between this part of the

assignment and the TCP client/server in the next part.

The client must fulfill the following requirements:

• The client must take the following command line arguments, in the order listed:

o The hostname or IP address of the server (it must accept either).

o The port number of the server.

• The client should be robust to server failure by using a timeout mechanism to deal with an

unresponsive server; if it does not receive a response to a particular request, you should note it in a client log and send the remaining requests.

• You will have to design a simple protocol to communicate packet contents for the three request  types along with data passed along as part of the requests (e.g. keys, values, etc.) The client must be robust to malformed or unrequested datagram packets. If it receives such a datagram packet, it should report it in a human-readable way (e.g., “received unsolicited response acknowledging unknown PUT/GET/DELETE with an invalid KEY” - something to that effect to denote an receiving an erroneous request) to your server log.

• Every line the client prints to the client log should be time-stamped with the current system  time. You may format the time any way you like as long as your output maintains millisecond precision.

• You must have two instances of your client (or two separate clients):

o One that communicates with the server over TCP

o One that communicates with the server over UDP

The server must fulfill the following requirements:

• The server must take the following command line arguments, in the order listed:

• The port number it is to listen for datagram packets on.

• The server should run forever (until forcibly killed by an external signal, such as a Control-C, a kill, or pressing the “Stop” button in Eclipse).

• The server must display the requests received, and its responses, both in a human readable

fashion; that is, it must explicitly print to the server log that it received a query from a particular InetAddress and port number for a specific word, and then print to the log its response to     that query.

• The server must be robust to malformed datagram packets. If it receives a malformed datagram packet, it should report it in a human-readable way (e.g., “received malformed request of length  n from