Agile JavaScript a codecentric AG workshop

If you are reading this, then you are probably here because one of the trainers has given you this URI. If not, then most of this information may not be of interest to you. Should you be interested in this workshop, please contact our training team (workshop is available in German and English).

Installation of necessary software

Make sure that every team member has a PC/Mac that can be used for development. Unix based operating systems work best in our experience, but Windows can also be used. If you are willing to, then you can install the necessary software on your own machine. Being able to run the software outside of any virtual machine is superb and will result in the best experience for you during the workshop. For those who are unable to install the software or are not willing to, we provide an Ubuntu-based virtual machine that can be run using Oracle VirtualBox.

Native installation

Providing installation instructions for all the tools is out of scope for this document. Most of the necessary tools feature an excellent documentation that you can refer to should you run into any issues. In case of any outstanding issues, please contact us by mail through agilejs@codecentric.de.

Please make sure that the following tools are installed:

• Java version 6 or later (preferably Oracle JDK or Open JDK 7)
• git (the version control system)
• Node.JS version 10 and NPM (node package manager). On OS X and Linux you should use NVM (Node Version Manager) which allows you to install global modules without super user privileges. To install NVM you need to have git and cURL installed.
• Once NPM is installed, you will need to globally install the Grunt command line interface. You can do so by running npm install -g grunt-cli. Depending on your setup, you might need to prepend sudo to get the necessary privileges.
• Neo4j as this is the database that we are using. Installation normally only requires an extraction of the downloaded archive.
• The latest neo4j has basic authorization enabled by default. This will cause the movie-database to throw errors on startup. To disable authorization, change the dbms.security.auth_enabled in NEO4J_HOME/conf/neo4j-server.properties to false. See also Neo4J Documentation - Securing access.
• Some code editor that supports HTML, CSS and JavaScript. We recommend either Sublime Text, Atom Editor or WebStorm.
• At last, you will need a relatively new web browser. Chromium derivatives like Google Chrome, Chrome Canary or Chromium itself would be our choice.

Using the Virtual Machine

Make sure that you have Oracle VirtualBox installed. With VirtualBox Version 4.2.18 you should not run into any issues. Once installed you can start VirtualBox and import the virtual machine using File -> Import Appliance. Follow the wizard till the end and start the virtual machine. You should now be good to go!

The virtual machine is available through CenterDevice (hit the download button in the upper-right corner). The box was built upon a Ubuntu 15.04 64bit image from osboxes.org.

The neo4j installation folder is ~/neo4j-community-2.2.2/. The source code for the workshop is available under ~/movie-database-node. This is only for a first test though. During the workshop you will have to clone your own team repository.

Check installation

To check if your installation is correct and you are ready to join the workshop, just follow the steps described on our Quickstart Guide. If you can complete these steps, everything is fine.