Eclipse Trace Compass Server

Table of Contents

• Compiling manually
• Running the server
• Run the Server with SSL

Compiling manually

The Maven project build requires version 3.3 or later. It can be downloaded from http://maven.apache.org or from the package management system of your distro.

To build the trace-server manually using Maven, simply run the following command from the git progect top-level directory:

cd org.eclipse.tracecompass.incubator/
mvn clean install

The default command will compile and run the unit tests. Running the tests can take some time, to skip them you can append -DskipTests to the mvn command:

mvn clean install -DskipTests

The resulting executables will be in the trace-server/org.eclipse.tracecompass.incubator.trace.server.product/target/products. There are the archives for linux, macos and Windows. The sub-directories trace-server/org.eclipse.tracecompass.incubator.trace.server.product/target/products/traceserver/<os>/... contain the executable for each OS.

Running the server

$ cd trace-server/org.eclipse.tracecompass.incubator.trace.server.product/target/products/traceserver/linux/gtk/x86_64/trace-compass-server/
$ ./tracecompss-server`

This server is an implementation of the Trace Server Protocol whose API is documented using the OpenAPI REST specification.

OpenAPI REST specification: The REST API is documented using the OpenAPI specification in the API.json file. The file can be opened with an IDE plug-in, or Swagger tools. For more information, see https://swagger.io/docs/.

Run the Server with SSL

The trace server can be run using SSL certificates. Jetty requires the certificate and private key to be in a keystore. Follow the instructions to configure SSL on jetty.

Then, you can edit the tracecompass-server.ini file to pass the keystore data and SSL port as parameters after the -vmargs line. For example, here's a extract of the file:

[...]
-vmargs
[...]
-Dtraceserver.port=8443
-Dtraceserver.keystore=/path/to/keystore

The following properties are supported:

• traceserver.port: Port to use. If not specified, the default http port is 8080 and SSL is 8443
• traceserver.useSSL: Should be true or false. If true, the traceserver.keystore property must be set. If left unset, it will be inferred from the other properties. If false, the traceserver.keystore and traceserver.keystorepass will be ignored.
• traceserver.keystore: Path to the keystore file.
• traceserver.keystorepass: Password to open the keystore file. If left unset, the password will be prompted when running the trace server application.