The Full DataTurbine installer comes with a graphical interface for the instillataion process. It contains rbnb.jar, webTurbine (a web interface to the DataTubrine server), as well as various sources, utilities, and their accompanying documentation. Once you have gone through the first time install guide we recommend you download and install this full distribution and go through the quick tutorial.
- Verify Java is installed on your system.
- Kill any DT server that you may already have running prior to going through this tutorial.
- Install JAR file for DataTurbine
- Most Systems:
- Double-click on the downloaded file (RBNB-V3.#-install.jar) to start the install process.
- Windows 7/Vista (with UAC enabled):
- Click the start menu and search for cmd.exe
- Right click on the icon and click Run as Administrator
This will open a terminal with administrative privilages
- Run the installer
java -jar C:\PATH_To_FILE\RBNB-V3.4B3-install.jar
- After the install, you will have a shortcut named “RBNB-V3.#”.
Double-click on this shortcut to start the WebTurbine interface.
- Open a web browser on this same computer and go to http://localhost;
You will see the main WebTurbine interface displayed in the browser.
- From the main WebTurbine page you can click on the “Documentation Folder” link to get a folder view of documentation for applications delivered with the DT distribution. From this folder view documentation page you can click on the “Server” link and then on the “rbnbServer.html” link to pop up a page of documentation for the server.
- Go back to the main WebTurbine page (http://localhost) and then click on the “rbnbServer” link near the top of the page. This will allow you to launch a server right from within WebTurbine. Near the bottom of the page that comes up you will notice a “Help” link; this also opens the DT server documentation (as you did in step 6 above). Click on the “Start Server” button to launch a DT server.
- To get a view of the sources connected to your server, go to http://localhost/RBNB; when you initially launch the server you will only see the default “_Log” and “_Metrics” sources. Click on these sources to see their list of channels. Under the “_Log” source, click on the “Server” channel; you will see the most recent messages posted by the server, which at this point will be something like:
<02-Feb-2012 EST 09:06:46.731> <Server>
RBNB (Ring Buffered Network Bus) V3.2B6 build 2953 (built Fri Aug 05 16:58:45 EDT 2011)
Copyright 2006 Creare Inc.
Started at address tcp://192.168.2.56:3333
Archive home directory: “.”
- As we saw in step 8 above, if the content of the DT channel is text (it can also help if the MIME type for the channel also indicates it is text) then the web browser will display the content of this channel right in the browser window. WebTurbine also has built-in options for displaying binary data. If you go to the “_Metrics” source and click on the “TotalMemory” channel (http://localhost/RBNB/_Metrics/TotalMemory), a Windows “Open with/Save File” dialog will probably pop up; this is because the browser doesn’t know how to display this binary data. However, we can add some URL “munges” to help display this data right in the browser:
- the “dt=s” string means “display type is string”; this tells the WebTurbine interface to fetch the data from the _Metrics/TotalMemory source, convert it to string, and then send the content back to the browser
- we have now added the “d=100” URL munge, which means fetch the most recent 100 seconds worth of data; without this additional munge, only the most recent data point is fetched.
- You will recall that each channel contains data as well as the timestamps associated with this data. If you want to fetch the timestamps associated with the most recent 100-seconds worth of data, you would add the “f=t” (means “fetch time”) URL munge to the above request:http://localhost/RBNB/_Metrics/TotalMemory?dt=s&d=100&f=t
- Documentation for the supported URL munges is available at http://localhost/documentation/WebDAVOptions.html
- If you had other sources connected to the DT server, then you would see these listed in the WebTurbine directory listing (http://localhost/RBNB/), and you could also access data from their channels just as we have from the “_Log” and “_Metrics” channels. As a “homework assignment”, I would encourage you to launch the “rbnbSource” application from the main WebTubrine page and view its data using some of these URL munges.