Third-Party Software Requirements

ActiveMatrix BPM requires various third-party software.

Apache Ant

Apache Ant is required to run TIBCO Configuration Tool scripts, TIBCO ActiveMatrix runtime objects upgrade, or TIBCO ActiveMatrix Administrator CLI scripts.

Apache Ant is supplied as part of the ActiveMatrix BPM software distribution.

Content Management Systems

If you want to use an external content management system (CMS) for the Business Data Services case folder feature, you can use any CMIS 1.0-compliant CMS. TIBCO has tested the following:

  • Alfresco Community Edition 5.0a (5.0.0 r75118-b23)
  • SharePoint 2013

Eclipse Standard Web Toolkit (SWT) Graphical Tool Kit (GTK) Module

If you are installing ActiveMatrix BPM on a Linux or Solaris platform, the Eclipse SWT GTK module software assemblies are required. (These assemblies are not required if you are installing ActiveMatrix BPM on any other platform.)

You can obtain the Eclipse SWT GTK module in two ways:

  • You can download the assemblies automatically when you run the ActiveMatrix BPM installer, if the machine on which you are running the installer has internet access.
  • You can download the assemblies from the TIBCO Software Product eDelivery Site before you install ActiveMatrix BPM:

    http://edelivery.tibco.com/

    You should do this if the machine on which you are running the ActiveMatrix BPM installer does not have internet access. See Downloading Required Third-Party Software Assemblies for more information.

Hibernate

ActiveMatrix BPM requires Hibernate version 3.2.7. You can obtain this version of Hibernate in two ways:

  • You can download Hibernate automatically when you run the ActiveMatrix BPM installer, if the machine on which you are running the installer has internet access.
  • You can download Hibernate from the TIBCO Software Product eDelivery Site before you install ActiveMatrix BPM:

    http://edelivery.tibco.com/

    You should do this if the machine on which you are running the ActiveMatrix BPM installer does not have internet access. See Downloading Required Third-Party Software Assemblies for more information.

Note: When downloading Hibernate, the number in the package name refers to the assembly number and not the version of Hibernate. This can be misleading as the assembly number is not the same as the Hibernate version number. For example, the package name when downloading Hibernate Version 3.2.7 is:

assembly_tibco_com_tpcl_ord_hibernate_feature_3.2.400.001.zip

Java Virtual Machine (JVM)

ActiveMatrix BPM requires a 64-bit JVM.

Java Runtime Environment (JRE) 1.7 is supplied as part of the ActiveMatrix BPM software distribution.

Note: You must upgrade the JRE used by ActiveMatrix BPM to JRE 1.8. See Upgrade to Java Runtime Environment (JRE) 1.8 for more information.

JDBC Drivers

ActiveMatrix BPM requires JDBC drivers for the databases that will be used to host the ActiveMatrix BPM and ActiveMatrix Administrator databases, as shown in the following table:

Database Required JDBC driver
Microsoft SQL Server 2014 Microsoft SQL Server JDBC Driver 6.0 (sqljdbc42.jar), or 4.2 (sqljdbc42.jar), or 4.0 (sqljdbc4.jar)
Note: Microsoft SQL Server JDBC Driver 6.0 or 4.2 is only supported when using TIBCO ActiveMatrix Platform 3.3.0 Hotfix 17 (or later).
Microsoft SQL Server 2012 or 2008 R2 Microsoft SQL Server JDBC Driver 4.0 (sqljdbc4.jar)
Oracle 12c Version 12.1.0.1.0 (ojdbc7.jar) or Version 11.2.0.4.0 (ojdbc6.jar).
Note: ActiveMatrix 3.3.0 Hotfix-10 and above support the updated ojdbc7.jar JDBC driver for use with Oracle 12.1.0.1.0.

To determine if you have the correct version of ojdbc7.jar, do one of the following:

  • In the BPM log file on system startup, look for the following entry:

    [INFO ] org.hibernate.cfg.SettingsFactory -JDBC driver: Oracle JDBC driver, version: 12.1.0.1.0

  • In the following folder:

    TIBCO_HOME/components/shared/1.0.0/plugins/com.tibco.tpcl.gen.oracle.jdbc_12.1.100.001

    open the ojdbc7.jar file, and examine the META-INF/MANIFEST.MF file for the following entry:

    Implementation-Version: 12.1.0.1.0

To determine if you have the correct version of ojdbc6.jar, do one of the following:

  • In the BPM log file on system startup, look for the following entry:

    [INFO ] org.hibernate.cfg.SettingsFactory -JDBC driver: Oracle JDBC driver, version: 11.2.0.4.0

  • In the following folder:

    TIBCO_HOME/components/shared/1.0.0/plugins/com.tibco.tpcl.gen.oracle.jdbc_11.2.100.001

    open the ojdbc6.jar file, and examine the META-INF/MANIFEST.MF file for the following entry:

    Implementation-Version: 11.2.0.4.0

Oracle 11g R2 Version 11.2.0.4.0 (ojdbc6.jar). To determine if you have the correct version, do one of the following:
  • In the BPM log file on system startup, look for the following entry:

    [INFO ] org.hibernate.cfg.SettingsFactory -JDBC driver: Oracle JDBC driver, version: 11.2.0.4.0

  • In the following folder:

    TIBCO_HOME/components/shared/1.0.0/plugins/com.tibco.tpcl.gen.oracle.jdbc_11.2.100.001

    open the ojdbc6.jar file, and examine the META-INF/MANIFEST.MF file for the following entry:

    Implementation-Version: 11.2.0.4.0

DB2 10.5 or 9.7 db2jcc4.jar

Refer to your database documentation for information on how to obtain these JDBC drivers.

You will need to configure these JDBC drivers for use with ActiveMatrix BPM as part of the installation process.

LDAP Server

All users who may need to log in to ActiveMatrix BPM (using Openspace, Workspace or a custom client application) must exist in one or more LDAP directories that are accessible to ActiveMatrix BPM.

ActiveMatrix BPM requires one or more LDAP servers that use the Lightweight Directory Access Protocol (LDAP) version 3.

If you are installing:

  • a system that is intended for production use (generally a distributed BPM system), you must use an external LDAP directory server.
  • a basic BPM system that is not intended for production use, you can either use an external LDAP directory server, or the internal LDAP directory server that is provided with ActiveMatrix BPM.

Oracle Java 7 Elliptic Curve Cryptography (ECC) Library

If you are installing ActiveMatrix BPM on a Windows, Linux or Solaris platform, the Oracle Java 7 ECC library is required. (This library is not required if you are installing ActiveMatrix BPM on any other platform.)

You can obtain the Oracle Java 7 ECC library in two ways:

  • You can download a software assembly automatically when you run the ActiveMatrix BPM installer, if the machine on which you are running the installer has internet access.
  • You can download the assembly from the TIBCO Software Product eDelivery Site before you install ActiveMatrix BPM:

    http://edelivery.tibco.com/

    You should do this if the machine on which you are running the ActiveMatrix BPM installer does not have internet access. See Downloading Required Third-Party Software Assemblies for more information.

Web Browsers

ActiveMatrix BPM requires a web browser to run Openspace, Workspace, Application Management (and its example myWork application) and the ActiveMatrix Administrator GUI.

The following tables list the web browsers that are supported by the different ActiveMatrix BPM runtime user interfaces.

Openspace and Workspace
Browser Versions Notes
Microsoft Edge 25 Includes support for EdgeHTML 13.
Internet Explorer 11 Enterprise Mode and Native Mode are supported. Compatibility View is not supported.
8, 9, 10 Compatibility View is not supported.
Firefox 53 The Openspace Spotfire gadget is not supported. Openspace (Accessible) is not supported.
Chrome 59 The Openspace Spotfire gadget is not supported. Openspace (Accessible) is not supported.
Openspace (Accessible)
Browser Versions Notes
Internet Explorer 11
8, 9 Compatibility View is not supported.
Application Development
Browser Versions Notes
Microsoft Edge 25
Internet Explorer 11 Enterprise Mode and Native Mode are supported. Compatibility View is not supported.
Firefox 53
Chrome 59
Safari on iOS 10.3.2 on iPad 10

The ActiveMatrix BPM 4.2.0 MyWork application and TIBCO Forms have been tested on an Apple iPad Air 2 running iOS 10.3. TIBCO anticipates that these components will work equally well on an iPad Pro and iPad Mini although the display content will be smaller on the latter.

iPhone and iPod Touch devices are not supported

Note: Application Development itself is not supported on Safari.

Safari on OS X 10.12.x 10

The ActiveMatrix BPM 4.2.0 MyWork application and TIBCO Forms have not been tested with Safari 10 on a Mac running OS X 10.12 or above but it is expected that they will largely run satisfactorily.

Note: Application Development itself is not supported on Safari.
Mobilespace
Device Notes
iOS Mobilespace uses WKWebView (1.1.4) to render the webcontent on iOS devices.

Mobilespace and the Mobile Case Management app have been tested on iPhone and iPad running iOS 10.3.2.

Android Mobilespace uses crosswalk-webview (2.3.0) to render the webcontent on Android devices
TIBCO ActiveMatrix Administrator (GUI)
Browser Versions Notes
Internet Explorer 11 Enterprise Mode and Native Mode are supported. Compatibility View is not supported.
9, 10 Compatibility View is not supported.
8 SP2 is required.
Firefox 26  

The Supported Versions specified are the minimum versions of each browser that are supported by ActiveMatrix BPM. Unless otherwise specified, you can use a more recent version of a browser as long as the vendor claims the recent version to be compatible with the specified version.

Note: In the event of a problem with a more recent browser version, TIBCO will employ reasonable efforts to provide support on that browser version. However, TIBCO may request that you reproduce the problem on a supported version of the browser. This may mean that you potentially change to a different version that does not exhibit the issue; ideally only on a temporary basis.

Support for Microsoft Internet Explorer Versions 8, 9 and 10

In January 2016, Microsoft stopped support for all but the latest version of Internet Explorer on currently supported Microsoft operating systems. This means that version 11 is the only fully supported version of Internet Explorer. TIBCO is aware that some customers may still be using Internet Explorer versions 8, 9 or 10.

TIBCO’s support for these older versions of Internet Explorer in this version of ActiveMatrix BPM is based on previous versions of TIBCO ActiveMatrix BPM (Openspace and Workspace) having been supported and working. If customers using these older versions of Internet Explorer report problems with their use with Openspace, Workspace or TIBCO ActiveMatrix Administrator (GUI) and a workaround is not available, neither TIBCO nor Microsoft will be able to assist further and TIBCO will recommend using a supported browser.