StreamBase Studio Eclipse Update Site

Contents

Studio Plug-in Folders
Platforms Supported
Initial Conditions
Eclipse 4.4 Prerequisites
Eclipse 3.8 Prerequisites
Eclipse 3.7 Prerequisites
Installing the Studio Plug-ins in Eclipse
Upgrading Eclipse Studio Plug-Ins
What to Expect
Installing Subversive Yourself

Studio Plug-in Folders

TIBCO Software formally supports and strongly recommends that you install and use the standalone TIBCO StreamBase® Studio included in your StreamBase installation kit. Nevertheless, for advanced Eclipse users, StreamBase also supports a plug-in version of Studio that you can install into your existing installation of Eclipse (versions 3.7, 3.8, 4.3, and 4.4 are supported).

You install the plug-in version of StreamBase Studio from an Eclipse plug-in folder. As downloaded from the TIBCO distribution site, the StreamBase Studio Eclipse plug-in is delivered as an archive file named with the following pattern:

  • TIB_sb-cep_eclipseupdate_<version>_<platform>.zip

If you need assistance, contact TIBCO StreamBase Technical Support to request access to an Eclipse plug-in folder.

The Eclipse plug-in folder adds ONLY the StreamBase Studio authoring environment plug-ins to Eclipse. It does NOT provide:

  • A runtime for StreamBase Server. You can use the Eclipse plug-in version of Studio to connect to StreamBase Server instances running on other machines in your network.

  • Command-line utilities such as sbc and sbadmin for querying and administering your server.

  • Libraries, DLLs, JARs and other files to support using the StreamBase Client Library.

The best use is to install both standalone Studio and the Studio plug-ins in your own Eclipse. That way, the Studio-in-Eclipse edition can locate and use the StreamBase Server runtime and sample files provided only in the standalone version of Studio.

The plug-in folder is static and is designed to provide a snapshot of the Studio plug-ins at the time of each StreamBase release. To update your Studio plug-ins, you can run an install-update of the plug-ins from the eclipse-update-site folder of the next release, as described below in Upgrading Studio Plug-ins.

If you obtain access to an update-site folder, be aware that it does not work the same as Eclipse update sites from the Eclipse Foundation or from other vendors. The update-site folder contains a snapshot of a single release of the plug-ins.

Platforms Supported

The StreamBase Studio 7.5 plug-ins are supported on the following platforms:

  • 32-bit Eclipse 3.7, 3.8, 4.3, or 4.4 running on a supported 32-bit or 64-bit Windows system.

  • 64-bit Eclipse 3.7, 3.8, 4.3, or 4.4 running on a supported 64-bit Windows system.

  • 32-bit Eclipse 3.7, 3.8, 4.3, or 4.4 running on a supported 32-bit Linux system.

  • 64-bit Eclipse 3.7, 3.8, 4.3, or 4.4 running on a supported 64-bit Linux system.

  • 64-bit Eclipse 3.7, 3.8, 4.3, or 4.4 running on a supported 64-bit Mac OS system.

The Studio 7.5 plug-ins are developed on Eclipse 3.8, and the StreamBase 7.5 installation kit delivers Studio with Eclipse 3.8, which is the preferred Eclipse version, but the plug-ins also work with Eclipse 4.3 and 4.4. If you are starting with the recommended Eclipse 3.8, follow the instructions in Eclipse 3.8 Prerequisites.

If you have site standards or third-party tools that require the use of Eclipse 3.7, follow the instructions in Eclipse 3.7 Prerequisites.

Note that the Studio plug-ins for release 7.5 are not supported on Eclipse 3.6 or earlier.

Initial Conditions

To support the Studio plug-ins, your Eclipse installation must meet the following conditions:

  • Eclipse must already be running and working on a supported Windows or Linux machine.

  • You must be running Eclipse with a JDK, not just a JRE.

  • Eclipse must be running under a supported 1.6 or 1.7 version of an Oracle JDK, with both java and javac commands available on the search path of the logged-in username that will run Studio. See the JDK row in the Supported Configurations table for details on the supported JDK versions.

    Important

    When StreamBase Studio installs as a standalone product, it includes an Oracle JDK 1.7 for private use by Studio and StreamBase Server. This private JDK is not available when installing the Studio plug-ins into your own Eclipse, so you MUST make sure you are running Eclipse with a supported 1.7 or 1.6.x JDK. The Studio plug-ins will not load if Eclipse is running with a 1.5 JRE or JDK.

  • JDKs from vendors other than Oracle are not supported, and Oracle 1.5 JDKs are not supported for running Studio. JDK versions 1.6 and 1.7 are now formally supported.

  • Eclipse must have all prerequisite features installed, as described in the next sections.

Note

When installing plug-ins into Eclipse 3.8, TIBCO Software strongly recommends doing so while your machine has open access to the Internet, and with the Contact all update sites check box selected on the Available Software Install dialog.

Under these conditions, Eclipse automatically downloads and installs prerequisite components, which makes the upgrade process proceed smoothly and quickly.

Eclipse 4.4 Prerequisites

The StreamBase Studio 7.5 plug-ins require the following Eclipse 4.4 base kit and optional features:

— An Eclipse 4.4 base installation

The recommended Eclipse 4.4 base kit is the following:

  • Eclipse for RCP and RAP Developers

Download the 32-bit or 64-bit version of this package, as appropriate for your target machine, from: 

http://www.eclipse.org/downloads/packages/eclipse-rcp-and-rap-developers/lunasr1
— Java Development Tools (JDT) Feature

The JDT feature is always included in Eclipse base kits.

— EMF Feature

If you are installing on an Internet-connected PC with the Contact all update sites check box selected as recommended above, the EMF Modeling Framework is automatically installed as a prerequisite of the Eclipse for RCP and RAP Developers base kit. If you started with the RCP and RAP package, skip now to Installing the Studio Plug-ins.

If your existing Eclipse installation started from a different package, such as Eclipse Classic, or you are installing with limited Internet access, then install the EMF Modeling Framework with the following steps:

  1. With the RCP base kit installed, run Help → Install New Software.

  2. Important! Clear the Group items by category check box.

  3. Important! Select the Contact all update sites check box.

  4. In the Available Software dialog, select the following entry from the Work with drop-down list:  Juno - http://download.eclipse.org/releases/luna (or select --All Available Sites--).

  5. In the type filter text box, type EMF

  6. From the resulting list, select EMF - Eclipse Modeling Framework Core Runtime.

  7. Click Next and go through the steps to accept the license, download, and install this feature.

  8. Restart Eclipse when prompted.

— GEF Feature

Like EMF, if you are installing on an Internet-connected PC, the GEF features are automatically installed as prerequisites of the EMF package. Skip now to Installing the Studio Plug-ins.

If your existing Eclipse installation started from a different package such as Eclipse Classic, then install GEF using the same steps for EMF, substituting for 5 and 6:

  • In the type filter text box, type GEF

  • From the resulting list, select Graphical Editing Framework GEF

Eclipse 3.8 Prerequisites

The StreamBase Studio 7.5 plug-ins require the following Eclipse 3.8 base kit and optional features:

— An Eclipse 3.8 base installation

The recommended Eclipse 3.8 base kit is the following:

  • Eclipse for RCP and RAP Developers

Download the 32-bit or 64-bit version of this package, as appropriate for your target machine, from: 

http://www.eclipse.org/downloads/packages/eclipse-rcp-and-rap-developers/junosr2
— Java Development Tools (JDT) Feature

The JDT feature is always included in Eclipse base kits.

— EMF Feature

If you are installing on an Internet-connected PC with the Contact all update sites check box selected as recommended above, the EMF Modeling Framework is automatically installed as a prerequisite of the Eclipse for RCP and RAP Developers base kit. If you started with the RCP and RAP package, skip now to Installing the Studio Plug-ins.

If your existing Eclipse installation started from a different package, such as Eclipse Classic, or you are installing with limited Internet access, then install the EMF Modeling Framework with the following steps:

  1. With the RCP base kit installed, run Help → Install New Software.

  2. Important! Clear the Group items by category check box.

  3. Important! Select the Contact all update sites check box.

  4. In the Available Software dialog, select the following entry from the Work with drop-down list:  Juno - http://download.eclipse.org/releases/juno (or select --All Available Sites--).

  5. In the type filter text box, type EMF

  6. From the resulting list, select EMF - Eclipse Modeling Framework Core Runtime.

  7. Click Next and go through the steps to accept the license, download, and install this feature.

  8. Restart Eclipse when prompted.

— GEF Feature

Like EMF, if you are installing on an Internet-connected PC, the GEF features are automatically installed as prerequisites of the EMF package. Skip now to Installing the Studio Plug-ins.

If your existing Eclipse installation started from a different package such as Eclipse Classic, then install GEF using the same steps for EMF, substituting for 5 and 6:

  • In the type filter text box, type GEF

  • From the resulting list, select Graphical Editing Framework GEF

Eclipse 3.7 Prerequisites

Eclipse 3.8 is the preferred Eclipse version to support the StreamBase Studio 7.5 plug-ins. If you have site standards or third-party tools that require the use of Eclipse 3.7, follow the instructions in this section.

The Studio 7.5 plug-ins require the following Eclipse 3.7 base kit and optional features:

— An Eclipse 3.7 base installation

The recommended Eclipse 3.7 base kit is the following:

  • Eclipse for RCP/Plug-in Developers

Download the 32-bit or 64-bit version of this package, as appropriate for your target machine, from: 

http://www.eclipse.org/downloads/packages/eclipse-rcp-and-rap-developers/indigosr2
— Java Development Tools (JDT) Feature

The JDT feature is always included in Eclipse base kits.

— EMF and GEF Features

Install the EMF and GEF features, using the following instructions:

  1. With the base kit installed, run Help → Install New Software.

  2. Important! Clear the Group items by category check box.

  3. Important! Select the Contact all update sites check box.

  4. In the Available Software dialog, select the following entry from the Work with drop-down list:  Indigo - http://download.eclipse.org/release/indigo (or select --All Available Sites--).

  5. In the type filter text box, type EMF

  6. From the resulting list, select EMF - Eclipse Modeling Framework Core Runtime

  7. Click Next and go through the steps to accept the license, download, and install this feature.

  8. Restart Eclipse when prompted.

  9. Go through the steps above, this time typing EMF in the type filter text box. Select EMF - Eclipse Modeling Framework Core Runtime.

  10. Click Next and go through the steps to accept the license, download, and install this feature.

  11. Restart Eclipse when prompted.

  12. Go through the steps again, this type typing GEF in the type filter text box. Select Graphical Editing Framework GEF.

  13. Click Next and go through the steps to accept the license, download, and install this feature.

  14. Restart Eclipse when prompted.

Installing the Studio Plug-ins in Eclipse

When you have installed and configured Eclipse as described in the previous sections, follow the steps below to install the Studio 7.5 plug-ins.

  1. Start Eclipse.

  2. Invoke Help → Install New Software.

  3. Click Add to add a software download site.

  4. In the Add Site dialog:

    1. In the Name field, enter StreamBase 7.5.x Update Site.

    2. Click Archive to install from the TIBCO distribution site or a private URL provided to you by TIBCO StreamBase Technical Support. Enter the URL for the zip archive in the Location field.

    3. Click OK.

    After reading the local update site directory or after contacting the URL, this creates the following entries in the Available Software grid:

  5. Select the check boxes next to StreamBase Studio and EventFlow Compare .sblayout File Loader for Subversive SVN. (If you have separately installed and use the Subclipse plug-in, select the remaining check box. Subclipse is not formally supported by StreamBase, but we do provide an .sblayout file loader for it.)

  6. Click Next.

  7. After a moment, Eclipse displays the Install Details page with StreamBase Studio selected. Click Next.

  8. Accept the license agreement and click Finish.

  9. If Eclipse prompts for permission to install the unsigned Studio plug-in files, click OK.

  10. Eclipse now installs the Studio plug-ins into Eclipse.

  11. Restart Eclipse when prompted.

  12. When Eclipse restarts, a dialog prompts for permission to set Studio's location in the Eclipse preferences dialog.

    1. If you have a separate installation of StreamBase Studio 7.5 on the same machine, click Yes to open the StreamBase Studio preference page.

    2. Specify the location of your existing StreamBase 7.5 installation by clicking Browse and navigating to the top level folder of your installation.

    3. Click OK.

  13. On the Welcome page, click the arrow-shaped Workbench button or click the X on the Welcome tab to close the Welcome page and open the Eclipse workbench.

  14. Use Window → Open Perspective → Other to open the SB Authoring perspective.

Upgrading Eclipse Studio Plug-Ins

From Eclipse, you can upgrade the StreamBase Studio plug-ins using the standard Eclipse update methods.

As an example, let's say you extracted the eclipse-update-site folder from the 7.5.0 online archive, and saved that folder locally in C:\Users\sbuser\Documents\sb750\eclipse-update-site. You installed the Studio plug-ins into Eclipse as described in the previous section, using the Local option of the Add Site dialog.

Now, release 7.5.1 comes along. Save the update-site folder you request from StreamBase Technical Support locally in C:\Users\sbuser\Documents\sb751\eclipse-update-site.

To trigger Eclipse's update mechanism, do not create a new update site for the new location. Instead, edit the existing Studio update site location in Eclipse to point to the new file system location. Use steps like the following:

  1. In Studio-on-Eclipse, run Help → Install New Software.

  2. Click the Available Software Sites link.

  3. In the resulting dialog, select the line for your StreamBase Eclipse Update Site.

  4. Click Edit.

  5. The path in the Location field was converted by Eclipse into a URL that uses the file:// protocol. Change this URL to reflect the location of your newly extracted eclipse-update-site folder. For example:

    file:/C:/Users/sbuser/Documents/sb751/eclipse-update-site

    Using the examples above, you only need to change one character in the path: change sb750 to sb751.

  6. Click OK twice to return to the Available Software dialog.

  7. Select your StreamBase Eclipse Update Site entry from the Work with drop-down list.

  8. The grid now shows StreamBase Studio. Select this entry and click Next. Accept the license and click Finish.

  9. Eclipse proceeds to upgrade your Studio plug-ins without requiring you to uninstall and reinstall.

What to Expect

Loading Studio into your own Eclipse is not meant to be an alternative to a formal StreamBase Studio installation, but is made available as a convenience for experienced Eclipse developers. The following points describe the Studio-on-Eclipse configuration:

  • No license is required to run and develop applications on either StreamBase Studio or Studio-on-Eclipse. A valid StreamBase license is required to run applications on StreamBase Server.

  • The Studio-on-Eclipse configuration is most useful when installed on a machine that also has a licensed installation of StreamBase. You can run StreamBase applications on the licensed installation's StreamBase Server instance by specifying the location of the licensed installation in Studio-on-Eclipse's preferences.

  • The licensed installation on the same machine should be from the same release series as the Studio plug-ins on Eclipse, with the same major.minor release number.

  • If you do not have a StreamBase installation on the same machine, you can run applications from Studio-on-Eclipse on a remote StreamBase Server running on Linux or Solaris. See Configuring UNIX Servers for Remote Studio Access to configure this option.

  • Ideally, the StreamBase release number of your Studio-on-Eclipse plug-ins will have the same major.minor number as the remote Server. However, StreamBase Server is somewhat forgiving of release numbers, and will try to run your application despite a release number skew.

  • On the other hand, the release number matching of precompiled archive files is very strict. If you generate an .sbar file in Studio-on-Eclipse, you can only run it on a StreamBase Server instance with the same major.minor.maintenance release number.

Installing Subversive Yourself

The Studio 7.5 plug-ins include the Subversive team provider plug-in to provide access to files under the control of the Subversion version control system. If, for any reason, you are installing Subversive on your own, you must also install the Subversive SVN JDT Ignore Extensions plug-in. Although it is marked as optional, this plug-in is essential in giving Eclipse the knowledge of what file and directory names to ignore for certain purposes (such as the .svn directory) and what file extensions to consider source files.

The Subversive version numbers you see may differ from the illustration above.