Installing on Ubuntu Trusty 14.04

Installation notes for a clean Ubuntu 14.04 Trusty system.

• sudo apt-get install git maven mongodb openjdk-7-jdk

• git clone [email protected]:CIDARLAB/clotho3.git

• mvn verify

  • Lots of warnings; ~20 errors; no failures

• verify that the server starts:

   mvn -Dexec.args="-Dloglevel=OFF -classpath %classpath org.clothocad.core.util.ClothoTestEnvironment 
       -clientdirectory clotho3-web/dist" \
       -Dexec.executable=java \
       -Dexec.classpathScope=test \
       process-classes \
       org.codehaus.mojo:exec-maven-plugin:1.2.1:exec
  

  • If you are getting a java.lang.UnsupportedClassVersionError: Unsupported major.minor version error, you must compile with JDK 8. sudo apt-get install openjdk-8-jdk

If you are just running Clotho or working on the backend, you can stop here. You only need to continue if you are hacking on the frontend.

Install up-to-date Node.js

• curl -sL https://deb.nodesource.com/setup_4.x | sudo -E bash -
• sudo apt-get install -y nodejs

Install the Node packages 'bower' and 'grunt' globally

• sudo npm install -g bower
• sudo npm install -g grunt
• sudo npm install -g grunt-cli

Install ruby & compass:

• sudo apt-get install ruby ruby-dev
• sudo gem install compass

Install a local version of phantomjs v1.9.8 (because the post-install script fails with an HTTPS/TLS error)

• wget https://bitbucket.org/ariya/phantomjs/downloads/phantomjs-1.9.8-linux-x86_64.tar.bz2
• tar jxfv phantomjs-1.9.8-linux-x86_64.tar.bz2
• sudo cp phantomjs-1.9.8-linux-x86_64/bin/phantomjs /usr/local/bin

Build the front-end

• cd clotho3-web
• bower install (asked whether to install codemirror 3.19 or 5; went with 5.)
• npm install
• grunt concurrent:server autoprefixer

Start the server!

• cd ..

   mvn -Dexec.args="-Dloglevel=DEBUG -classpath %classpath org.clothocad.core.util.ClothoTestEnvironment 
       -clientdirectory clotho3-web/dist" \
       -Dexec.executable=java \
       -Dexec.classpathScope=test \
       process-classes \
       org.codehaus.mojo:exec-maven-plugin:1.2.1:exec
  

Browse to https://localhost:8443