jobserv/README.md

JobServ

Remote Procedure Calls over the protobuf API

Requirements

• openssl
• tar

Building

Gradle will manage dependencies, generate code, compile the java, and package the code. Simply run the folllowing command:

$ ./buildwrapper.sh

buildwrapper will ask you for details about the client and server, if you are testing this software both CNs can be set to localhost. buildwrapper will then generate CAs for the Client and Server, and signed certs for the Client and Server. IN addition a seperate, third CA and cert will be generated for testing purposes. Gradle will then generate protobuf source and compile it with the source for the client and server. After gradle is completed buildwrapper will organize the sources with their respective certs in the staging folder. In addition to a server folder and a client folder, there will be a test folder which has a copy of all certs and both server and client functionality. The test CA is not trusted by the server or the client by default. As such, the test cert can be used to induce a mutual tls authentication failure.

Running

After build, the programs can be found in the staging folder. After changing directory to the 'staging/client' folder or the 'staging/server' folder, either program can be run as follows:

$ ./JobServ/bin/jobserv-server (port) server.crt private.pem ca.crt
$ ./JobServ/bin/jobserv-client private.pem client.crt ca.crt (hostname) (port) (command) (arguments)

alternatively, for guidance:

$ ./JobServ/bin/jobserv-server 
$ ./JobServ/bin/jobserv-client help

Testing

(TODO: job control module)