Developer Troubleshooting Guide

This document can help you to fix the common problems encountered while contributing to TEAMMATES.

Common setup errors and solutions

The back-end server fails with java.io.FileNotFoundException

The back-end server is "stuck" at 85% EXECUTING or alike

The front-end dev server fails with Cannot find module '../api-output' or similar

After pulling changes from the master branch, the previously working front-end dev server fails to start

Common test errors and solutions

A handful of failed E2E test cases (< 10)

Tests fail due to accented characters

java.net.ConnectException: Connection refused when running E2E tests

org.openqa.selenium.WebDriverException: Unable to bind to locking port 7054 within 45000 ms when running tests with Browser

When running E2E tests: Selenium cannot find Firefox binary in PATH

On Linux: java.io.IOException: Directory "/tmpfiles" could not be created

Submitting help request

If none of the items in this guide helps with the problem you face, you can post in the discussion forum to request for help. Remember to supply as much relevant information as possible when requesting for help.