scorelab/Tracker

Name: Tracker

Owner: Sustainable Computing Research Lab

Description: Tracker project first for trains

Created: 2014-02-20 13:14:06.0

Updated: 2017-11-23 17:25:04.0

Pushed: 2018-01-03 18:33:51.0

Homepage: null

Size: 14116

Language: JavaScript

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

Tracker

Tracker is to help developers to jumpstart developping anykind of mobility tracking applications.

Tracker lets any type or number of GPS devices to post their locations to a nodejs server through a ReST service.

This consists of several main modules

1. HTML5+AngularJS Front-end
2. NodeJS+MongoDB API for collecting and quering tracker data
3. Php+MySQL back-end to manage the trackers & etc.
4. Android app to push data to the API
5. Documentation

Installation Guide

1. Clone the repo using

   clone https://github.com/scorelab/Tracker.git
   

2. Install node and mongodb.

3. cd to the mobility-track-nodejs folder. Do an npm install. It will install all the pakages.

   obility-track-nodejs
   

   
   install
   

4. Run mongodb. Default path is set to /data/db ( On Windows this would be C:\data\db). You can change it when you are running.

5. Install grunt-cli with

   install -g grunt-cli
   

6. Now run grunt, it will start the node server and listen to port 3000.

   t
   

OSX Installation Guide

OSX is also quite a simple installation. Skip the sections if you already have that software installed.

Install Homebrew

1. Run the installer

   /bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
   

2. Then run brew update to make sure Homebrew is up to date

    update
   

3. Add Homebrew to the dollar $PATH so it can be accessed properly

    "export Path=/usr/local/bin:$PATH" >> ~/.bash_profile && source  ~/.bash_profile
   

4. (Optional but suggested) Run brew doctor to make sure that homebrew is ready to work.

    doctor
   

Node.js

Use homebrew to install node.js and npm

 install node

Grunt

1. Install Grunt's CLI with npm (If this did not work something went wrong with the Node installation)

   install -g grunt-cli
   

MongoDB

1. Use homebrew to install MongoDB

    install mongodb
   

2. Setup the default 'data/db' folder for mongoDB (use sudo if you have to)

   r -p /data/db
   

3. Ensure the current user running mongoDB has read and write permissions for the data/db

Running the app

1. Ensure you are in /mobility-track-nodejs/ for the following steps

2. Run mongoDB (use sudo if you need to)

   od
   

3. Run grunt to finish the setup and start the server

   t
   

4. Navigate to localhost:3000 to access the site on your web browser.

Now get started developing!