Getting Started

Building the Project

To build the project source code you will need Java 1.8 and the build tool Maven. It will compile the code into jar files that can be executed in the Java runtime.

parity-cts

For parity-cts, the client and system applications need to be built. To do this, run:

mvn install

in the root of the repository. This will build and install the packages that need to be resolved in your local Maven repository.

After installing the packages into your local Maven repository, instead of building all the applications with the install maven lifecycle phase, you may build the client and system applications directly using:

mvn clean package

in their respective directories: applications/client and applications/system.

eml-cts

To build eml-cts run:

mvn clean package

in the complete directory.

MySQL Server

There is more than one way to get a MySQL server running for this project. Refer to the MySQL page for more details.

After starting a MySQL server run the following queries:

CREATE database nist_cts_eml;
CREATE USER capstone@'%' IDENTIFIED BY "";
GRANT ALL ON nist_cts_eml.* to capstone@'%';

If the MySQL server is run on a local environment it may be preferred to use the host name localhost. Refer to the MySQL documentation for details.

Running the Project

To run the project a certain startup order is required:

1. parity system
2. parity client
3. eml-cts
   • MySQL server should be running before starting this application

parity system

To start parity system navigate to the applications/system directory and run the jar:

java -jar parity-system.jar etc/example.conf

Java 11 JRE is required to run parity-system.jar

On Windows Operating Systems it may be required to change the multicast-interface IP, in the conf file, from the loop-back address to the IP address of the device the above command is executed from.

See the configuration page for more details on conf files.

parity client

To start the parity client navigate to the applications/client/target directory in parity-cts and run the jar:

java -jar parity-client.jar ../etc/example.conf

eml-cts

Before running eml-cts some configuration may be required. See the eml-cts configuration page for more details.

To start the eml-cts application run the jar in the complete/target directory:

java -jar eml-cts.jar