Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This guide walks through the process of setting up a development environment for Fluxtream on Mac OS X.

...

The Fluxtream build process uses node.js to run a less compiler to build .css files from .less sources.  The following is from the MacOS homebrew instructions at https://github.com/joyent/node/wiki/Installing-Node.js-via-package-manager:

  • sudo brew install node 
  • sudo npm install -g less

...

$ cd ${TOMCAT_HOME}/webapps/
$ sudo mkdir ../hold
$ sudo mv ROOT examples docs ../hold
$ sudo ln -s ~/projects/fluxtream-app/fluxtream-web/target/ROOT

...

Modify Tomcat JAVA_OPTS

We need to change the JAVA_OPTS used by Tomcat or else it will give out of memory errors:

cd ${TOMCAT_HOME}
./bin/

Add the following just underneath the long comment at the top of catalina.sh

...

Test

Load :

JAVA_OPTS="-server -Xms2048m -Xmx2048m -XX:PermSize=256m -XX:MaxPermSize=256m"

Start

cd ${TOMCAT_HOME}
./bin/catalina.sh start

Test

Load http://localhost:8080 in your browser to test out Fluxtream. If that doesn't work, check the logs:

...

$ cd ${TOMCAT_HOME}
$ ./bin/catalina-jrebel.sh jpda start

Server Tuning

If you find that Tomcat OOMs frequently, don't despair! This can be fixed by increasing heap size.

cd ${TOMCAT_HOME}/bin

Add the following just underneath the long comment at the top of catalina.sh:

JAVA_OPTS="-server -Xms2048m -Xmx2048m -XX:PermSize=256m -XX:MaxPermSize=256m"

Server Shutdown

To shut down a running Tomcat server:

...