#4 added troubeshooting section in order to find enironment config problems easily + some refactoring regarding global file system paths