- Index

< Previous |  | Next >

# 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

### Note

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 com.apple.quarantine. 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 10.2.app"

   On a new installation, this returns:

       com.apple.FinderInfo
       com.apple.quarantine

3. Run the following command to remove the quarantine attribute from Studio:

       sudo xattr -r -d com.apple.quarantine "StreamBase Studio 10.2.app"

4. Re-run the xattr command from step 2 to see the results, which should be:

       com.apple.FinderInfo

5. Next, remove the quarantine attribute from StreamBase Manager's `.app` bundle as well:

       sudo xattr -r -d com.apple.quarantine "StreamBase Manager 10.2.app"

## 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 StreamBsae-Configured Shells 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 10.2.app, and select Show Package Contents.

- Navigate to Contents → MacOS.

- 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

### Note

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