quick install instructions for test/epi-suite

README.md

README for ctsapi

Getting us running on Windows

1. Install Java from the Oracle website.
2. Install Maven (recommended). If you prefer to use Gradle instead, don't install it, as JHipster ships with the Gradle Wrapper.
3. Install Git from git-scm.com. We recommend you also use a tool like SourceTree if you are starting with Git.
4. Install Node.js from the Node.js website. This will also install npm, which is the node package manager we are using in the next commands.
5. Install Yeoman: npm install -g yo
6. Install Bower: npm install -g bower
7. Depending on your preferences, install either Grunt (recommended) with npm install -g grunt-cli or Gulp.js with npm install -g gulp.
8. Install JHipster: npm install -g generator-jhipster

To find more information, tips and help, please have a look at the Yeoman "getting starting" guide and at the NPM documentation before submitting a bug.

Setting up Continuous Integration on Windows

Installing Jenkins

Download Windows Installer from https://wiki.jenkins-ci.org/

The installer configures Jenkins to run as a service using SYSTEM user which can be dangerous, it's safer to change the user's service to a non priviledged one:

http://antagonisticpleiotropy.blogspot.fr/2012/08/running-jenkins-in-windows-with-regular.html

Configuring Jenkins

Installing JDK 8

Through Jenkins administration, add a JDK 8 automatic installer.

Installing Maven 3.2.2

Through Jenkins administration, add a Maven automatic installer from Apache's site.

Installing PhantomJS

Install binaries from http://phantomjs.org/download.html

CHeck that the executable is included in PATH:

phantomjs --version
1.9.8

Installing NodeJS

Jenkins NodeJS plugin does not work on Windows, so we'll do a manual installation.

Download latest stable version (e.g. 0.10.35) from http://nodejs.org/

Don't install to default directory C:\Program Files\nodejs as it requires administration rights, prefer a simpler path like c:\nodejs.

http://blog.majgis.com/npm-nodejs-fails-when-run-from-jenkins-on-windows/

Edit C:\nodejs\node_modules\npm\npmrc to replace

prefix=${APPDATA}\npm

by

prefix=C:\nodejs\node_modules\npm

Add the 'C:\nodejs\node_modules\npm' folder to the PATH environment variable, remove the one that was added by the installer: 'C:\Users<user>\AppData\Roaming\npm'

npm may require git, install it from http://msysgit.github.io/

Add bower and grunt:

npm install -g bower grunt-cli
bower --version
grunt --version

It can be useful to have multiple versions of NodeJS on same machine but 'nvm' equivalents on Windows focus more on development environment than continuous integration. So if a job requires another version of NodeJS, change its PATH.

Installing Ruby and Compass

http://rubyinstaller.org/

Install version 1.9.3 under a simple folder (e.g.'c:\ruby193') rather than default one that may require administrator rights.

ruby -v
ruby 1.9.3p551 (2014-11-13) [i386-mingw32]

Install development kit so that you can install gems requiring compilation, select a simple destination folder (e.g. 'c:\RubyDevKit') and follow instructions.

Install Compass

http://compass-style.org/install/

gem update --system
gem install compass
compass --version

If Ruby and Compass have been installed in a folder that is not included in jenkins user's PATH, you can either update it in environment variables or through Jenkins UI in global properties.