Starting StreamBase Studio on macOS Sierra

MacOS releases 10.12 Sierra and 10.13 High Sierra have a security model that is stricter than previous releases. As part of their security, these releases automatically block unsigned, downloaded application bundles with .app extension from being able to run. Unfortunately, this affects the application bundles for StreamBase Studio 10.x and StreamBase Manager 10.x.

You can work around these limitations in one of several ways. Choose ONE of the following options.

Remove the Quarantine Attribute


This method is recommended because it only needs to be done once for each StreamBase installation. These steps must be repeated if you install a StreamBase maintenance update or new release.

MacOS automatically flags downloaded application bundles that are unsigned, adding the extended attribute Removing this attribute allows you to double-click to run your application bundles normally. Use commands like the following.

  1. At a Terminal prompt, navigate to your StreamBase installation directory. For example:

    cd ~/Applications/TIBCO StreamBase 10.2.1
  2. Run the xattr command to display the extended attributes of the Studio .app bundle:

    xattr "StreamBase Studio"

    On a new installation, this returns:
  3. Run the following command to remove the quarantine attribute from Studio:

    sudo xattr -r -d "StreamBase Studio"
  4. Re-run the xattr command from step 2 to see the results, which should be:
  5. Next, remove the quarantine attribute from StreamBase Manager's .app bundle as well:

    sudo xattr -r -d "StreamBase Manager"

Start Studio from a Shell Prompt

You can always start Studio from a Terminal shell prompt by typing:

sbstudio &

This command example presumes that you have configured your Terminal shell environment as described in the macOS section of the Configure Shells for StreamBase page.

If you choose this option instead of removing the quarantine attribute, you must start Studio this way every time.

Start Studio from Inside the .app Bundle

You can start Studio by navigating into the application bundle:

  • In a Finder window, navigate to your StreamBase installation folder.

  • Right-click StreamBase Studio, and select Show Package Contents.

  • Navigate to ContentsMacOS.

  • Double-click sbstudio. (Do NOT run _sbstudio.)

If you choose this option instead of removing the quarantine attribute, you must start Studio this way every time.

Restore the Pre-Sierra Security Model


This method is not recommended because it opens your Mac to safety issues from downloaded apps and utilities from other vendors.

You can return your macOS instance to the way applications launched before macOS 10.2 Sierra or 10.13 High Sierra. Doing this restores the Anywhere option for the Allow apps downloaded from section of the Security and Privacy control panel.

To do this, run the following command:

sudo spctl --master-disable

If you have already tried to run Studio by double-clicking its app bundle icon, then you must still remove its quarantine flag as described above in Remove the Quarantine Attribute.

To reverse this setting and return to the as-shipped Sierra or High Sierra security model, run:

sudo spctl --master-enable