Skip to content

Developer Hints

Alexander Krause edited this page Apr 15, 2019 · 5 revisions

Development Process

Github

Currently, we are working on two branches for the backend and frontend repository.

  • master: contains the latest stable, but proably not released yet version (Release Candidate)
  • dev-1: contains the latest development version

Additionally, we work with feature-based issues and related feature-branches, which are merged into the dev-1 branch via a pull request.

Ember.js and Node.js

Introduction

During development, you will probably encounter different issues with Ember.js or Node.js. These will ultimately suspend your development.

Therefore, this wiki entry is supposed to gather common problems and workarounds. We encourage you to add unknown problems to the list.

File watch limit is exhausted

If you encounter an error such as

Build Error (WatchedDir)
watch /home/akr/git/explorviz/explorviz-frontend/public ENOSPC 

or something similar, try to increase the monitoring limit for all files inside a directory with

echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf
sudo sysctl -p

More details can be seen here.

Git

Create a branch in Git from another branch and merge back

  1. Create "newBranch" branch off "sourceBranch"
  • $ git checkout -b newBranch sourceBranch
  1. Make changes in your branch "newBranch"
  2. Commit changes to branch "newBranch"
  • $ git commit -am "Your message"
  1. Merge your changes in "newBranch" to "sourceBranch" without a fast-forward
  • $ git checkout sourceBranch
  • $ git merge --no-ff newBranch
  1. Push changes to the server
  • $ git push origin sourceBranch
  • $ git push origin newBranch

Docker

Remove all containers, images, and volumes

#!/bin/bash
# Show all (exited / running) ExplorViz containers
docker ps -a -f name=explorviz*

# Delete all (ATTENTION) containers
docker rm $(docker ps -a -q)

# Delete all ExplorViz images
docker rmi -f $(docker images "explorviz/*" -q)

# Delete all (ATTENTION) images
docker rmi $(docker images -q)

# Delete all (ATTENTION) volumes
docker volume prune -f

MongoDB Compass

  1. Download and install the MongoDB GUI Interface for macOS, Windows, or Linux
  2. Start the tool
  3. Change host settings if necessary, e.g., port 27018 for landscape DB
  4. Hit Connect and inspect the MongoDB instance and its saved documents
You can’t perform that action at this time.