Studio Preference Settings

This is where Studio looks for global operators and adapters at startup, and where Studio finds the StreamBase and LiveView Server executables for local launches.

f you modify this setting, restart Studio for the change to take effect. Do not change this setting, except under the direction of StreamBase Technical Support.

A perspective is a collection of Eclipse views that are opened together to perform a task. StreamBase Studio can be set to automatically switch between perspectives on certain triggering events.

The setting for Switch to SB Test/Debug perspective when running an application applies only to Studio's default launch configuration.

The setting for Switch to SB Authoring perspective when stopping an application applies to running all StreamBase applications, whether started with the default launch configuration or a custom one.

When either of the first two options is set, the Ask me next time option is no longer shown in the Preferences page. To make it visible again, click Restore Defaults, then close and reopen StreamBase Studio.

An operator or adapter is marked deprecated with the Java annotation @Deprecated in its primary Java source file. You can mark your custom operators or adapters deprecated as your application evolves and new components replace older ones.

TIBCO StreamBase occasionally marks certain components as deprecated to encourage the use of newer components. If you are working on a legacy application and need to continue using a deprecated component, enable this setting.

With this setting disabled, the display of EventFlow applications that were saved with now-deprecated components is not affected. However, such applications cannot pass typechecking and cannot be run in Studio, because the code that underlies the deprecated components was not loaded. You can continue to work on such applications by enabling this option, or by upgrading the deprecated components with their replacements.

Site-specific Component Exchange URLs can use the HTTPS protocol, in which case Studio prompts you for access credentials on the specified server.

If you supply a URL that begins with HTTPS or FTP, Studio automatically prompts for credentials. If you supply a URL for another protocol, you can force authentication prompting for that protocol by setting the Java property streambase.ide.component-exchange-force-auth to true for the VM that runs Studio.

Specifies that components are automatically typechecked as you build your EventFlow application. Disable this preference to suppress automatic typechecking.

See also the related check box to enable Typecheck EventFlow Editors in background on the Typechecking panel, described below.

This preference has no effect on StreamSQL applications, which are always typechecked automatically. See Typechecking for more on StreamBase typechecking.

This feature adds an extra step to keyboard shortcuts that place new components on the canvas. For example, to add a Map operator, the keyboard shortcut is (at minimum) O M Enter with this option enabled, but is O M with this option disabled. You may prefer to disable this option temporarily when entering a long sequence of keyboard shortcuts to quickly fill a new canvas, then re-enable it. See Studio Keyboard Shortcuts.

When enabled, auto-centers the canvas on components selected when navigating in two ways:

With this checkbox cleared, Studio highlights the selected component on the canvas, but does not center the canvas. If the component is offscreen when selected, Studio moves just enough of the canvas to make the component visible.

When cleared, the check box, radio button, and drop-down menu controls in Java operator and adapter Properties views display a T icon () to the right of their text labels. Clicking the icon or typing Alt+F2 (Option+F2 on Mac) replaces the check box, radio button, or drop-down menu with a text field, in which you can enter:

When this preference is enabled, you can still convert a UI control to a text box with the keyboard shortcut when the control has focus. For additional details, see Parameterizing Java Operator and Adapter Properties.

StreamBase Studio respects the layout status it detects for each EventFlow application individually. That is, if Studio detects an .sblayout file with the same base name as the EventFlow file you are opening, it uses the layout information in the .sblayout file, and stores layout information there when saving the application. If Studio detects no .sblayout file, then it uses the layout information in the .sbapp file, and on save, stores layout information back to the .sbapp file. This Studio behavior is NOT changed by setting this preference.

This setting controls only whether .sblayout files are created automatically when you create and save new EventFlow application files, and does not affect existing .sbapp files in your workspace. For further details, see EventFlow Layout Options.

In previous releases, this single Palette view icon was shown as four separate icons: Input Adapter, Output Adapter, .NET Operator, and Java Operator. Select this check box to restore those four separate icons to the Palette view.

Enable this option (default) to show tiles around component icons, whose left and right edges are where ports attach. Disable to remove the tiles. The selection outline still appears with or without tiles.

When disabled (default) the selection outline is filled with light blue as shown above. When enabled, the selection outline shows as an unfilled dotted line, as follows:

When enabled (default), shows a yellow information box for a component when hovering the mouse over it.

When enabled (default), if a component has the Run this component in a parallel region option selected in its Properties view, the component is shown with a circle inside the bounds of the icon.

When disabled, the circle decoration is not shown, and there is no visual indicator of the component's separate thread state.

Select Remote Server to specify that using Run or Debug launch mode always runs the current StreamBase application against a remote server instance. Specify the default host name and remote user name elsewhere on this Preferences page.

The default is to run against a local server instance on the machine running StreamBase Studio.

If your network administrator gave you a specific port number, enter it after the server name and a colon. The port is for the SSH server running on the specified host, not StreamBase Server. (For example: machine.example.com:22).

Enable SSH tunneling for the connection to the remote host UNIX machine where StreamBase is installed. When you launch an application to run on a remote server, Studio normally detects whether tunneling is required (for example, when the server host has a firewall).

If you do not enable tunneling and StreamBase later detects that it is needed, StreamBase displays a prompt that gives you another chance to enable it. Click Yes in the dialog to enable SSH tunneling for the connection to StreamBase Server's host machine. If you are not certain, contact the administrator of the host machine.

Either Password Authentication or Keyboard-Interactive.

Specify Password Authentication, the default, to connect to a server whose SSH configuration allows it. If the server hosting StreamBase Server has an SSH configuration that allows keyboard-interactive authentication, select Keyboard-Interactive.

Some servers, including Solaris servers, may be configured to only allow keyboard-interactive SSH authentication. In this case, you must select Keyboard-Interactive to connect to StreamBase Server running on such hosts.

If your Linux host runs OpenSSH as its SSH implementation, you specify keyboard-interactive authentication by setting ChallengeResponseAuthentication to yes in the sshd_config file and restarting the SSH daemon. Consult your site's SSH administrator for details on configuring SSH on your server machines.

When you run an application and enqueue data, the number of input tuples can become quite large. It can be helpful to limit the number of tuples in the Application Input view's display buffer. When the limit is reached, newer tuples are kept in the view while older tuples are allowed to scroll off the view.

The specified display buffer size applies to the total number of tuples in the Application Input view, from the total of all input streams.

Same as above, but for output tuples in the Application Output view.

The specified display buffer size applies to the display of each output stream, as well as when (All Output Streams) is selected.

Enabled

"null"

Specifies the default TCP port number used by StreamBase Server when launched from Studio, on which to listen for client connections.

An explicit server port number specified in this application's server configuration file can override this preference setting. See <server> for more on the configuration file.

When attempting to run an application from Studio, if the port specified in the Default Port field is in use:

An explicit server port number specified in this application's server configuration file can override this preference setting. See <server> for more on the configuration file.