DataTurbine

DataTurbine is a java-based network ring buffer for streaming data via TCP. It is installed on Somniosus at http://somniosus.shore.mbari.org:8081/webTurbine/

Installation Instructions for Somniosus

1. Download RBNB from http://code.google.com/p/dataturbine/
2. From a terminal run:

   sudo java -jar RBNB-3.1B3-install.jar

   • Install into /Applications/RBNB
3. Edit /ApplicationsRBNB/apache-tomcat-5.5.12/catalina.sh
   • After the header add the line:

     CATALINA_HOME=/Applications/RBNB/apache-tomcat-5.5.12

4. Edit /Applications/RBNB/apache-tomcat-5.5.12/conf/server.xml
   • Change

     <Server port="8005" shutdown="SHUTDOWN">

     to

     <Server port="8006" shutdown="SHUTDOWN">

   • Change

     <Connector port="80" maxHttpHeaderSize="8192"

     to

     <Connector port="8081" maxHttpHeaderSize="8192"

   • Change

     <Connector port="8006"

     to

     <Connector port="8008"

5. Create the file /Applications/RBNB/bin/dataturbine-launchd.sh with the following content:

   #!/bin/bash
   
   function shutdown()
   {
       $CATALINA_HOME/bin/catalina.sh stop
   }
   
   export CATALINA_OPTS="-mx256m"
   export CATALINA_HOME=/Applications/RBNB/apache-tomcat-5.5.12
   export DATATURBINE_JVM_PID=$TMPDIR/$$
   
   . $CATALINA_HOME/bin/catalina.sh start
   
   trap shutdown HUP INT QUIT ABRT KILL ALRM TERM TSTP
   
   wait `cat $DATATURBINE_JVM_PID`
   

   • catalina.sh is just a launcher and exits immediately after Tomcat starts. This makes it look like a dead process to launchd.So launchd kills tomcat. The above script is used as a workaround.
6. Create the file /Library/LaunchDaemons/org.mbari.eits.DataTurbine.plist with the following content

   <?xml version="1.0" encoding="UTF-8"?>
   <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
   <plist version="1.0">
   <dict>
           <key>KeepAlive</key>
           <false/>
           <key>Label</key>
           <string>org.mbari.eits.DataTurbine</string>
           <key>ProgramArguments</key>
           <array>
                   <string>/Applications/RBNB/bin/dataturbine-launchd.sh</string>
           </array>
           <key>RunAtLoad</key>
           <true/>
           <key>EnvironmentVariables</key>
           <dict>
                   <key>CATALINA_HOME</key>
                   <string>/Applications/RBNB/apache-tomcat-5.5.12</string>
                   <key>JAVA_HOME</key>
                   <string>/System/Library/Frameworks/JavaVM.framework/Home</string>
           </dict>
   </dict>
   </plist>

   • It's easiest to set this up using Lingon