Administering DataTurbine

This assumes that DataTurbine has been deployed as described in the FAQ. – The DataTurbine server program is contained in the executable Java Archive (jar),


Invocations of this program take the form:

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

with command-line arguments:

  -a {server address - [host][:port]}
  -A {security file URL}
  -D {mask},{level}
  -H {archive home directory}
  -l [{log period (millis)}][,{log cache frames}][,[{log cache frames}][,[{log archive frames}][,[{log archive mode}]]]]
  -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}


– Select filesystem locations where the DataTurbine server is to maintain its disk archive and log. These locations will be referred to as RBNB_ARCHIVE and RBNB_LOG, respectively, from this point on. The preparation of convenience scripts to control the server is highly recommended. Some examples are at the end of this article. – DataTurbgine ships with an administration utility, ${RBNB_HOME}/bin/admin.jar. When connected to a DataTurbine server, it displays a list of all entities available from that server. This is handy as a very basic verification of the presence of sources and channels. It also provides actions via a right-click menu popup. Some particularly useful features are: – Terminate – removes a source from the servers cache and commits its data to the disk archive (if there is one). – Load Archive – loads the disk archive from an inactive source into the cache. This requires prior knowledge of the archive’s name. EXAMPLES – Linux (make a file called rbnb; this is a proper /etc/init.d script)

# Init script for the RBNB server
# chkconfig: 345 98 98
# description: Start the RBNB server
# Megabytes to use for the JVM running RBNB
RBNB_LOG ='/var/log/rbnb.log'

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

stop() {
 	kill `cat ${RBNB_PIDFILE}`
 	rm -f ${RBNB_PIDFILE}
case "$1" in
       echo "Starting the RBNB server"
       echo "Stopping the RBNB server"
       echo "Restarting the RBNB server"
       echo "Usage: ${0} {start|stop|restart} "

- Windows (make a file called rbnb.bat)

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

java -jar %RBNB_HOME%\\bin\\rbnb.jar -L -H %RBNB_ARCHIVE% -n "dataturbine" &gt&gt %RBNB_LOG% 2&gt&1
Open Source DataTurbine Initiative © 2016 Frontier Theme