Running Instructions

Owned by Candide Kemmler
Last updated: Feb 29, 2012
1 min read
  1. The database is going to be generated for you automatically; all you need to do is set the database name, username and password in your environment-specific property file (e.g. local.properties)
  2. We are using MaxMind's GeoLiteCity.dat database to map IP addresses to an approximate geolocation; you need to specify that file's location in your environment-specific property file, too (e.g. local.properties)
  3. Inside TOMCAT_ROOT there is a webapps/ directory; remove tomcat's default `ROOT` application. Either drop the fluxtream-webapp/target/ROOT.war there or, or create a symbolic version there pointing to fluxtream-webapp/target/ROOT
  4. Run tomcat: under TOMCAT_ROOT/bin, do ./startup.sh or ./catalina.sh start

  5. Do the following only once: when the welcome (/login) screen has appeared it means the application is fully initialized and so should the mysql database; it is now time to import the cities1000.sql at the root of the fluxtream-app project. A simple way to do this is using the command-line: mysql -u username -ppassword flx <cities1000.sql

  6. During development, and if you want to use JRebel (you should), create a symbolic link to the target/ROOT directory of the webapp module in Tomcat's or Jetty's webapps/ directory