Upgrading to StreamBase Runtime 10.5

This only covers the required upgrades for the StreamBase runtime. For complete information on upgrading the StreamBase authoring environment see the StreamBase product documentation.

  • The previously deprecated RedHat 6 support was dropped.
  • The webenabled and webport parameters to install node have been removed. These values are now only configurable using the node deploy configuration Administration.webPort and Administration.webEnable configuration properties.
  • Nodes now join a cluster when the node is started. Previous releases would join the cluster when the node was installed. Any reliance on the previous behavior must be updated.
  • The Administration.nodeFilters configuration property was removed from the node deploy configuration. Node filters were never implemented, so the related configuration was removed.
  • The default generated docker file now uses java-1.8.0-openjdk-headless instead of java-1.8.0-openjdk. Any application dependencies on X Windows in Docker images will no longer work by default.
  • The previously deprecated jvmname deploy tool parameter has been removed. Use enginename instead.
  • The previously deprecated com.kabira.platform.property.Status.JVM_NAME system property has been removed. Use com.kabira.platform.property.Status.ENGINE_NAME instead.
  • The previously deprecated StreamBaseEngine.streamBase.containerConnections and StreamBaseEngine.streamBase.modules configuration properties have been removed. These properties were replaced with EventFlowDeployment.containerConnections and EventFlowDeployment.containers configuration properties.
  • The minimum supported Maven version was changed from 3.3.9 to 3.5. Please upgrade the Maven version as required.
  • Invalid null key values were previously detected when KeyFieldValueList.add and KeyFieldValueRangeList.add were called. Invalid key values are now detected when KeyQuery.defineQuery is called. Any code relying on the previous behavior must be updated.
  • The Web Server State and Web Server URLs fields were removed from the display node output. This information is now available from the display web command.
  • Attempting to activate a com.tibco.ep.dtm.configuration.javaengine configuration that contains JavaEngine.jvmArgs on a running engine will now fail audit. Previous releases quietly did nothing. JavaEngine.jvmArgs can only be specified in engine configurations that are activated before an engine is running.

Migrating to epadmin

The legacy sbadmin, sbc, sbfeedsim, sbhealth and sbrecord command line tools have been replaced with epadmin.

epadmin provides full support for service names, multi-node, and multi-engine commands. The legacy commands are not shipped with the StreamBase runtime. Any use of the legacy commands should be migrated to using epadmin

The table below provides a mapping from the legacy sbadmin and sbc commands to the epadmin targets and commands.

The sbfeedsim command line tool has been replaced with the epadmin playback target.

The sbhealth command line tool has been replaced with the epadmin snapshot target.

The sbrecord command line tool has been replaced with the epadmin record target.

Mapping sbadmin to epadmin

sbadmin Command epadmin Command epadmin Target Comments
sbadmin addContainer add container
sbadmin getLeadershipStatus None None Legacy HA is deprecated, use SB 10 HA services.
sbadmin getOperatorProperty get operator
sbadmin killAllConnections close connection
sbadmin killConnection close connection
sbadmin listConnections display connection
sbadmin manageJdbcConnections display connection Display JDBC connections.
sbadmin modifyContainer modify container
sbadmin removeContainer remove container
sbadmin restart stop start adapter Restart adapter.
sbadmin restart restart container Restart container.
sbadmin restart stop start operator Restart operator.
sbadmin restartContainer restart container
sbadmin resume resume adapter Resume adapter.
sbadmin resume resume container Resume container.
sbadmin resume resume operator Resume operator.
sbadmin setLeadershipStatus None None Legacy HA is deprecated, use SB 10 HA services.
sbadmin setOperatorProperty set operator
sbadmin shutdown stop adapter Stop adapter.
sbadmin shutdown stop container Stop container.
sbadmin shutdown stop operator Stop operator.
sbadmin suspend suspend adapter Suspend adapter.
sbadmin suspend suspend container Suspend container.
sbadmin suspend suspend operator Suspend operator.

Mapping sbc to epadmin

sbc Command epadmin Command epadmin Target Comments
sbc checkLicense None None Runtime license checks have been removed.
sbc deq dequeue stream
sbc dequeue dequeue stream
sbc describe display adapter Adapter details.
sbc describe display container Container details.
sbc describe display operator Operator details.
sbc describe display querytable Query table details.
sbc describe display stream Stream details.
sbc enq enqueue stream
sbc enqueue enqueue stream
sbc getDynamicVariable get dynvar
sbc list display adapter Adapter details.
sbc list display container Container details.
sbc list display operator Operator details.
sbc list display querytable Query table details.
sbc list display stream Stream details.
sbc readTable read querytable
sbc setDynamicVariable set dynvar
sbc status display adapter Adapter details.
sbc status display operator Operator details.
sbc status display node Node details.
sbc typecheck None None Use typecheck in Studio.

Mapping sbcipher to epadmin

sbcipher Command epadmin Command epadmin Target Comments
sbcipher encrypt secret