trace-server

Eclipse Trace Compass Server

Table of Contents

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

Compiling manually

mvn clean install

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.