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:
...