Quality/QA-tools/QADashboard/Setting up the development environment

Revision as of 10:23, 19 April 2011 (view source) Vesse (Talk | contribs) m (→Install Node Package Manager) ← Older edit		Revision as of 11:01, 19 April 2011 (view source) Vesse (Talk | contribs) m (→Install Node Package Manager) Newer edit →
Line 19:		Line 19:
	#<tt>$ git checkout v1.0.1rc7</tt>		#<tt>$ git checkout v1.0.1rc7</tt>
	#<tt>$ sudo make install</tt>		#<tt>$ sudo make install</tt>
		+
		+	If your environment does not allow git protocol, make install will fail because of fetching the submodules. This can be fixed by changing the submodule URLs:
		+	#<tt>$ git config submodule.node_modules/abbrev.url https://github.com/isaacs/abbrev-js.git</tt>
		+	#<tt>$ git config submodule.node_modules/nopt.url https://github.com/isaacs/nopt.git</tt>
		+	#<tt>$ git config submodule.node_modules/semver.url https://github.com/isaacs/node-semver.git</tt>
	==Install mongodb==		==Install mongodb==

---

Revision as of 11:01, 19 April 2011

Contents 1 Introduction 2 Install Node.js 3 Install Node Package Manager 4 Install mongodb 5 Set up QA Dashboard 6 Run the tests and start the server

Introduction

QA Dashboard is a Node.js application. It is written in coffee-script and uses mongodb database. You need to install some awesome open source tools to get the development environment up and running.

Install Node.js

(uses v0.4.5 stable package)

1. $ wget http://nodejs.org/dist/node-v0.4.5.tar.gz
2. $ gunzip node-v0.4.5.tar.gz
3. $ tar -xf node-v0.4.5.tar
4. $ cd node-v0.4.5
5. $ ./configure
6. $ make
7. $ sudo make install

Install Node Package Manager

(uses v1.0.1rc7 stable branch)

1. $ git clone https://github.com/isaacs/npm.git
2. $ cd npm
3. $ git checkout v1.0.1rc7
4. $ sudo make install

If your environment does not allow git protocol, make install will fail because of fetching the submodules. This can be fixed by changing the submodule URLs:

1. $ git config submodule.node_modules/abbrev.url https://github.com/isaacs/abbrev-js.git
2. $ git config submodule.node_modules/nopt.url https://github.com/isaacs/nopt.git
3. $ git config submodule.node_modules/semver.url https://github.com/isaacs/node-semver.git

Install mongodb

1. $ sudo apt-get install mongodb

Set up QA Dashboard

QA Dashboard repository includes a default mongodb dump which can be used to populate the database.

1. $ cd qa-dashboard
2. $ mongorestore

Run the tests and start the server

1. Run unit tests: $ ./run-nodeunit.sh
2. Start the server: $ ./run-server.sh
3. Browse to http://localhost:3030

The server will start in development mode using node-supervisor, which watches for code changes and restarts the server accordingly.