Server for Code Smell Data

Olfaction is a server with storage backend for code smell research data. It exposes GraphQL and REST APIs over stored code smells and the version control information of analyzed repositories.

Build

npm install
npm run build

Start

npm start

Then navigate to http://localhost:4040/graphql to access the interactive query console.

Environment variables

The following environment variables are used to configure the server:

Name	Default	Description
HOST	localhost	Host for the HTTP API server to listen on
PORT	4040	Port for the HTTP API server to listen on
REPO_ROOT	./repos	Root directory where to find and store uploaded git repositories
PGHOST	localhost	Postgres database host
PGPORT	5432	Postgres database host
PGUSER		Postgres database user name
PGPASSWORD		Postgres database password
PGDATABASE		Postgres database name
BASIC_AUTH_USERS		If set, restricts access through HTTP basic auth. JSON object of usernames as keys and passwords as values.

Additionally, the optional OpenTracing support using Jaeger is configured through environment variables documented in the Jaeger client documentation. To disable OpenTracing completely, JAEGER_DISABLED can be set to true.

Requirements

The following tools need to be installed for the server:

• NodeJS 13.6.0
• Git 2.25.0
• PostgreSQL 12.1

Docker image

A docker image is also available for the server (does not include the PostgreSQL database). Example command to run the server on macOS, with a Postgres database running on the Docker host:

docker run --init --rm --name olfaction -p 4040:4040 --env PGHOST=host.docker.internal --env PGUSER=$USER --env PGDATABASE=olfaction felixfbecker/olfaction

The way to run the Docker image varies by platform. Please refer to the Docker documentation for more information. The command above will store repositories inside the container. It is possible to mount a Docker volume instead and set REPO_ROOT to put repositories on that volume.

Set up database

Make sure the above environment variables are set.

Create a database with PostgreSQL:

createdb olfaction

Then initialize the schema:

psql < ./schema/schema.sql

To optimize performance, it is recommended to tweak the settings postgresql.conf depending on the available system resources.