Home

Welcome to the webofneeds wiki!

Installation

1. Building with Maven
2. Setting up the Crypto
3. Installation Instruction for setting up the node web application
4. Setting up the owner web application
5. Matching service

If you are having problems have a look at Troubleshooting.

Setting up Frontend Development Environment for Windows (AngularJS)

1. Goto http://nodejs.org/download/ and download the NodeJS version you need.
   
2. install NodeJS
   
3. make sure that NodeJS is correctly installed by opening a Windows Command Console and typing node -v then enter. If it didn't work, check whether or not your node-directory are in your system-path-variable
   
4. Windows users need to install msygit(http://msysgit.github.io/) with the right option. see the bower installation instruction for the right option.
   
5. the maven install task will download and install bower and jspm for you that in turn will be used to install the owner-apps dependencies. However maven isn't yet configured to run jspm install as there's no easy integration via maven-frontend as with npm.

Tip: if you get the error "err Registry bower not found", you need to execute the following two commands:

npm install -g jspm-bower-endpoint
jspm registry create bower jspm-bower-endpoint

Tip: if the owner webapp is missing a lot of js files (look into the browser's js console and network tools), jspm didn't download the js dependencies. Go to webofneeds/webofneeds/won-owner-webapp/src/main/webapp and run node_modules/jspm/jspm.js install

Setting up Build Environment in Jenkins

Install the following programs:

1. jenkins (with plugins: git)
   
2. maven 3.3.3
   
3. jdk 8
   
4. git
   

For frontend build install:
5) npm
6) nodejs

Execute the following commands:
7) sudo npm install jspm -g
8) sudo npm install -g bower
9) sudo npm install -g jspm-bower-endpoint
10) run the following command as a prebuild jenkins step: jspm registry create bower jspm-bower-endpoint

Development Guidelines

• Building with maven
• Logging