Tervela Adapter Sample

Contents

Importing This Sample into StreamBase Studio
Sample Location
Running This Sample in StreamBase Studio
Running This Sample in Terminal Windows

This sample demonstrates the use of the StreamBase Tervela adapter.

Importing This Sample into StreamBase Studio

In StreamBase Studio, import this sample with the following steps:

  • From the top menu, click File → Load StreamBase Sample.

  • Select this sample from the Embedded Input Adapters list.

  • Click OK.

StreamBase Studio creates a project for this sample.

Sample Location

By default, the sample files are installed in:

On Windows

C:\Program Files\StreamBase Systems\StreamBase.n.m\sample\adapter\embedded\tervela\

On UNIX

/opt/streambase/sample/adapter/embedded/tervela/

When you load the sample into StreamBase Studio, Studio copies the sample project's files to your Studio workspace. StreamBase Systems recommends that you use the workspace copy of the sample, especially on UNIX, where you may not have write access to /opt/streambase. In the default installation, the path to this sample in your Studio workspace is: 

UNIX:       
   ~/streambase-studio-n.m-workspace/sample_adapter_embedded_tervela
Windows XP:
   C:\Documents and Settings\username\My Documents\
      StreamBase Studio n.m Workspace\sample_embedded_tervela
Windows 7 and Windows Vista:
   C:\Users\username\Documents\StreamBase Studio n.m Workspace\
      sample_embeddedtervela

Running This Sample in StreamBase Studio

  1. In the Package Explorer, double-click tervela.sbapp.

  2. Select the Definitions tab and modify the schema of the PublishSchema named schema to match that of the messages you wish to publish.

  3. Select the Parameters tab and enter your site-values for username, password, and tmxaddress1, and, if appropriate, tmxaddress2.

  4. Select the TervelaInput adapter icon to open the Properties view for the input adapter.

  5. Enter in the Topic(s) property one or more topics, separated by spaces, you would like to subscribe to when the application starts. You can subscribe to additional topics after the application starts by enqueuing tuples to the Subscribe stream.

  6. Select the TervelaOutput adapter icon to open the Properties view for the output adapter.

  7. Enter the topic you want to publish to in the Default Topic property. Note that the default topic can be overriden in each publish tuple.

  8. Click the Run button. This opens the SB Test/Debug perspective and starts the application.

  9. In the Test/Debug Perspective, open the Application Output view. If the adapters are able to connect and log in to the TMX server(s), two Login status tuples with a Succeeded action appear, one from each Tervela adapter instance.

  10. In the Manual Input view, select the Publish input stream, enter values in more or more fields, and click Send Data. A tuple will appear in the Application Output view from the Data streams.

  11. When done, press F9 or click the Stop Running Application button.

Running This Sample in Terminal Windows

This section describes how to run the sample in UNIX terminal windows or Windows command prompt windows. On Windows, be sure to use the StreamBase Command Prompt from the Start menu as described in the Test/Debug Guide, not the default command prompt.

  1. Open three terminal windows on UNIX, or three StreamBase Command Prompts on Windows. In each window, navigate to your workspace copy of the sample, as described above.

  2. In window 1, type:

    sbd tervela.sbapp

  3. In window 2, type:

    sbc dequeue -v

    This window will display the tuples dequeued from the application's output ports.

  4. In window 3, enqueue a tuple to be published (adjusting the number of field to match your Publish schema):

    echo MyTopic,MyBlob,true,1.23,123,1234,MyString,2010-03-24,null | sbc enqueue Publish

  5. Observe in windows 2 the published tuple appears on the Data stream.

  6. In window 3, type the following command to terminate the server and dequeuer:

    sbadmin shutdown