DataTurbine Frequently Asked Questions

wonderful · Note:

${RBNB_HOME}/bin/rbnb.jar. 

java -jar ${RBNB_HOME}/bin/rbnb.jar 
(in Windows terminal, it's java -jar %RBNB_HOME%\bin\rbnb.jar)

  -a {server address - [host][:port]}
  -A {security file URL}
  -D {mask},{level}
  -F
  -H {archive home directory}
  -l [{log period (millis)}][,{log cache frames}][,[{log cache frames}][,[{log archive frames}][,[{log archive mode}]]]]
  -L
  -m [{metrics period (millis)}][,[{metrics cache frames}][,[{metrics archive frames}][,[{metrics archive mode}]]]]
  -M {maximum activity threads}
  -n {server name}
  -O {options file URL}
  -p {parent server address}
  -P [{userid}][,{password}]
  -s {shortcut name},{remote address},[{cost}]
  -S {maximum open filesets}

#!/bin/bash
#
# Init script for the RBNB server
#
# chkconfig: 345 98 98
# description: Start the RBNB server
#
# Megabytes to use for the JVM running RBNB
RBNB_MEM='512'
RBNB_ARCHIVE='/var/rbnb_archive'
RBNB_LOG ='/var/log/rbnb.log'
RBNB_PIDFILE='/var/run/rbnb.pid'

start() {
	mkdir -p ${RBNB_ARCHIVE}
  	java -Xmx${RBNB_MEM}M -jar ${RBNB_HOME}/bin/rbnb.jar -n dataturbine -L -H ${RBNB_ARCHIVE} > /var/log/rbnb.log 2>&1 &
   echo $! > ${RBNB_PIDFILE}
   }

stop() {
 	kill `cat ${RBNB_PIDFILE}`
 	rm -f ${RBNB_PIDFILE}
}

case "$1" in
   'start')
       echo "Starting the RBNB server"
       start
       ;;
   'stop')
       echo "Stopping the RBNB server"
       stop
       ;;
   'restart')
       echo "Restarting the RBNB server"
       stop
       start
       ;;
   *)
       echo "Usage: ${0} {start|stop|restart} "
       ;;
esac

- Windows (make a file called rbnb.bat)

set RBNB_ARCHIVE=C:\\rbnb_archive
set RBNB_LOG=rbnb.log
mkdir %RBNB_ARCHIVE%

java -jar %RBNB_HOME%\\bin\\rbnb.jar -L -H %RBNB_ARCHIVE% -n "dataturbine" >> %RBNB_LOG% 2>&1

$RBNB_HOME/apache-tomcat-*/conf/server.xml
<Connector className="org.apache.coyote.tomcat4.CoyoteConnector"
               port="80" minProcessors="5" maxProcessors="75"
               enableLookups="true" redirectPort="8443"
               acceptCount="100" debug="0" connectionTimeout="20000"
               useURIValidationHack="false" disableUploadTimeout="true" />
<Connector className="org.apache.coyote.tomcat4.CoyoteConnector"
               port="8080" minProcessors="5" maxProcessors="75"
               enableLookups="true" redirectPort="8443"
               acceptCount="100" debug="0" connectionTimeout="20000"
               useURIValidationHack="false" disableUploadTimeout="true" />
$RBNB_HOME/apache-tomcat-*/webapps/webdav/WEB-INF/web.xml
<!-- Uncomment this to enable read and write access -->
<!--
    <init-param>
      <param-name>readonly</param-name>
      <param-value>false</param-value>
    </init-param>
-->
 -Xmx{value}M

 java -Xmx1024M -jar $RBNB_HOME/bin/rbnb.jar

-d64

Request(channelMap, time, duration, mode)

Where...
    recTime is the time stamp on record,
    lastTime is the greatest time ring buffer for a channel,
    firstTime is the smallest time in the ring buffer for a channel,
    maxLastTime is the greatest lastTime over all channels,
    minFirstTime is the smallest firstTime over all channels
    (for all duration >= 0 is required)

absolute
    return records for which time <= recTime <= time+duration
    duration=0 is a special case, returns the single record with
    recTime <= time

newest
    return records for which lastTime-(time+duration) <= recTime <=
lastTime-time; duration = 0 is a special case, returns the single closest
record to lastTime-time such that recTime <= lastTime-time

oldest
    return records for which firstTime+time <= recTime <=
firstTime+time+duration; duration = 0 is a special case, returns the single
closest record to firstTime+time such that firstTime+time <= recTime

aligned (e.g. newestAlligned)
    return records for which maxLastTime-(time+duration) <= recTime <=
maxLastTime-time

    [did you-all ever consider oldestAlligned that is: minFirstTime+time <=
recTime <= minFirstTime+time+duration???]

after
    given baseTime is the max of lastTime-duration and time
    return records such that baseTime <= recTime <= baseTime+duration

modified
    if time < lastTime, compute baseTime is lastTime-duration
    return records such that baseTime <= recTime <= baseTime+duration
    if time >= lastTime no data is returned

next
    given that baseTime is the least recTime such that time <= baseTime
    return records for which baseTime <= recTime <= bastTime+duration

previous
    given that baseTime is the greatest recTime such that baseTime <= time
    return records for which baseTime-duration <= recTime <= baseTime
'Next' with time < minFirstTime, duration > 0 

and 

'Previous' with maxLastTime < time, duration >0 

both return a list an array of times/data with duplicates in each
position but the first and the last
'Previous' with time <= maxListTime and duration = 0
$ cd /Volumes/RBNB/Server

$ mkdir foo

$ cd foo

$ echo hello > c@t=1

$ cat c

hello

$ echo world > c@t=2

$ cat c@t=1

hello

$ cat c@t=2

world

$ cat "c@t=1&d=2"

hello

world

$
chan@t=1&d=2&r=newest

t: timestamp (seconds)

d: duration (seconds)

r: reference (oldest | newest | absolute)

"t=0&d=0&newest"
$ echo 1 > x

$ cat x

1

$ echo 2 > x

$ cat x

1

$ cat x@i=1

2

$ echo 3 > x

$ cat x@i=2

3

$ cat x@d=99

1

2

3

$ cat myfile.txt

$ cat myfile.txt@r=oldest

http://my-machine:8080/RBNB/Server/VSource/c0@d=1
  mkdir foo@"a=100000&c=1000"

DataTurbine Frequently Asked Questions

Administering DataTurbine

SOFTWARE ADMINISTRATION

SunT2000

Bridging Antelope and DataTurbine

Can I mix and match different dataloggers/cameras/DAQs in a single DataTurbine?

DataTurbine metrics channels

DataTurbine programming gotchas and tips

DataTurbine Security Architecture

Deploying DataTurbine software

Enabling and using the PNG plugin for static display of numeric streams

Simple web interface to DataTurbine?

A quick check to see if everything is working

Now what?

How and where to use Data Turbine

How to enable and use the WebDAV filesystem interface

Configuring Tomcat for WebDAV

Enabling write access

How to increase the amount of memory in the DataTurbine

Notes and limits

LabVIEW support for DataTurbine

Making SAPI calls from Matlab

Open Source DataTurbine on NMI System

put/get units for channels

Starting Mirrors from SAPI

Time selection parameters in the Request SAPI call

Definitions

Anomalies

Comments and more information

Usage of the DataTurbine KML plugin

Using cat5 cable for serial cabling

WebDAV walkthrough from Creare

RBNB V2.0 WebDAV Interface

Getting Started: A Walk Through

March 3, 2003

1) Start WebTurbine

2) Visit the WebTurbine Home Page

3) Start RBNB Server

4) Review RBNB Content with Browser

5) Mount RBNB as WebDAV File System

6) Create RBNB Source and Channel via WebDAV

7) User Other Applications to Create and View Content

8) Mount the RBNB WebDAV as File System on Other Machines

9) Publish Conventional Files via rbnbFolder

10) Route RBNB Servers Together

11) Create Virtual Data Processing Channels

WebDAV: How to set cache and archive values when creating a source directory