Co Valere

TIBCO BusinessWorks Migration

A TIBCO BusinessWorks migration moves BusinessWorks 5 projects to a supported platform before their support ends. A BusinessWorks 5 owner has 3 options: upgrade to BusinessWorks 5.16.1, move to BusinessWorks 6 or BusinessWorks Container Edition, or migrate to Workato. Co Valere delivers all 3 options and supports TIBCO estates that are not ready to move.

Talk to our architects

What is TIBCO BusinessWorks?

TIBCO BusinessWorks is an integration platform that connects applications, databases and messaging systems through graphical process definitions. TIBCO BusinessWorks is sold by Cloud Software Group. Cloud Software Group formed in 2022 when TIBCO combined with Citrix.

TIBCO BusinessWorks exists in 3 product lines. These are:

  • ActiveMatrix BusinessWorks 5. The original release line, built in TIBCO Designer and run on process engines managed by TIBCO Administrator.
  • ActiveMatrix BusinessWorks 6. The redesigned release line, built in TIBCO Business Studio for BusinessWorks and run on AppNodes.
  • BusinessWorks Container Edition (BWCE). The BusinessWorks 6 model packaged for containers on platforms such as Docker, Kubernetes, OpenShift and Cloud Foundry, according to TIBCO's documentation.

A BusinessWorks process connects systems through activities. Common examples include JDBC queries against Oracle or SQL Server, JMS messages on TIBCO Enterprise Message Service, HTTP and SOAP calls, and file transfers.

Is TIBCO BusinessWorks outdated?

TIBCO BusinessWorks is not outdated as a product. Older BusinessWorks 5 releases are reaching end of support. Cloud Software Group still sells, updates and supports BusinessWorks 5, BusinessWorks 6 and BusinessWorks Container Edition.

BusinessWorks 5 support depends on the release in use. The current position is:

  • Releases 5.13, 5.14 and 5.16.0 are already out of support, according to TIBCO's support policy.
  • Release 5.15 leaves support on 30 November 2026, according to TIBCO's support policy.
  • Release 5.16.1 is a long-term support (LTS) release, with support to 2030, according to TIBCO's LTS policy.

A BusinessWorks 5 owner on 5.15 or earlier therefore chooses between 3 paths. The table below compares them:

OptionWhat changesWhat staysBest fit
Upgrade to BusinessWorks 5.16.1 LTSProduct version, patches and supported operating systemsDesigner, TIBCO Administrator, Hawk, processes and licencesEstates that need to stay on TIBCO to 2030 while a longer plan forms
Move to BusinessWorks 6 or Container EditionDesign tooling, runtime, project structure and deployment modelTIBCO licences, TIBCO skills and BusinessWorks process logicOrganisations committed to TIBCO that want REST-first design and the BusinessWorks 6 tooling
Migrate to WorkatoPlatform, licensing model, tooling and operating modelBusiness logic and system connections, rebuilt as recipesOrganisations that want to retire TIBCO licences and infrastructure

The upgrade to 5.16.1 extends support to 2030 without changing the architecture. The move to BusinessWorks 6 changes the design tool, the runtime and the project model at the same time. In Co Valere's experience, a BusinessWorks 6 move needs the same inventory, retesting and cutover planning as a migration off TIBCO.

What are the differences between BusinessWorks 5 and BusinessWorks 6?

The differences between BusinessWorks 5 and BusinessWorks 6 cover 6 areas: design tooling, runtime, project model, REST support, container support and migration tooling. Each difference adds work to a BusinessWorks 5 to 6 move.

The table below sets out the differences that matter for migration:

AreaBusinessWorks 5BusinessWorks 6 and Container Edition
Design-time toolingTIBCO DesignerTIBCO Business Studio for BusinessWorks, based on Eclipse
RuntimeProcess engines, deployed as EAR files through TIBCO Administrator and monitored with TIBCO Hawk microagentsAppNodes grouped into AppSpaces inside Domains, managed with the bwadmin utility and bwagent; Container Edition runs each application in a container
Project modelProjects of process definitions, starters and shared resourcesApplications made of 1 application module, 0 or more shared modules and optional OSGi bundles such as Java modules
REST supportREST and JSON through the BusinessWorks Plug-in for REST and JSONREST service and reference bindings built from Swagger files and, from release 6.7.0, OpenAPI 3.0 files
Container supportBusinessWorks 5 runs on Kubernetes through TIBCO Platform Control Plane, which replaces TIBCO Administrator, Hawk and TIBCO Runtime Agent, according to TIBCOBusinessWorks Container Edition for Docker, Kubernetes, OpenShift and Cloud Foundry
Migration toolingNot applicableA migration tool in Business Studio and the bwmigrator command-line utility convert BusinessWorks 5 projects

These facts come from TIBCO's BusinessWorks 5 and BusinessWorks 6 documentation. The runtime change has the largest operational impact, because deployment scripts and monitoring rules built around TIBCO Administrator need rework.

How does TIBCO's migration tool move BusinessWorks 5 projects to BusinessWorks 6?

TIBCO's migration tool moves BusinessWorks 5 projects to BusinessWorks 6 by converting each project into a Business Studio project. Developers run the tool from the Business Studio menu or from the bwmigrator command line, which accepts 1 or more BusinessWorks 5 project folders in one run, according to TIBCO's documentation.

The tool has 4 documented limits that affect planning. These are:

  • Migration runs in one direction only, from BusinessWorks 5 to BusinessWorks 6, according to TIBCO.
  • Projects saved as single .dat files must first be opened in TIBCO Designer and saved as multi-file projects, according to TIBCO.
  • Project names with spaces or special characters, such as !, $, % and @, need renaming before migration, according to TIBCO.
  • Adapter activities, such as Publish to Adapter and Adapter Subscriber, need manual rework after migration, according to TIBCO's plug-in documentation.

REST projects carry further limits. TIBCO's Container Edition documentation lists WADL, binary responses and OAuth 1.0 and 2.0 authentication among the unsupported cases for REST migration.

Converted projects need testing before release. Co Valere treats tool output as a starting point and regression-tests every migrated process against BusinessWorks 5 outputs on the same inputs.

How are BusinessWorks processes mapped in a migration?

BusinessWorks processes are mapped in a migration through an inventory, a decision for each process and a target design for each surviving process. The same 3 steps apply whether the target is BusinessWorks 6 or Workato.

The inventory records 5 types of BusinessWorks asset. These are:

  1. Projects, with their owners, environments and deployment configurations.
  2. Process definitions, including subprocesses called from other processes.
  3. Process starters, such as Timer, File Poller, JMS Queue Receiver and HTTP Receiver.
  4. Shared resources, such as JDBC connections, JMS connections, HTTP connections and XML schemas.
  5. Global variables and custom Java code, which hold environment settings and hidden logic.

Each process then receives 1 of 3 decisions: rebuild, consolidate or retire. Processes with no executions in 6 to 12 months are retirement candidates. Processes that move the same data between the same systems are consolidation candidates.

For the Workato option, Co Valere maps each BusinessWorks construct to a Workato equivalent. The table below shows the process-level mappings:

BusinessWorks constructWorkato equivalent
Timer starterScheduler trigger
File Poller starterFile trigger through the on-prem agent or a cloud storage connector
JMS Queue Receiver starterJMS connector through the on-prem agent, or an Event Streams trigger
HTTP Receiver and SOAP service startersAPI Platform endpoint that calls a recipe
Call Process (subprocess)Callable recipe or recipe function
Shared resource connectionWorkato connection
Global variablesEnvironment properties and lookup tables
Group, loop and catch blocksRepeat, conditional and error-handling blocks
Java Code activityFormula, or a custom action built with the Connector SDK

The mapped inventory sets the wave plan. Large estates move in waves of 20 to 50 integrations.

How long does a TIBCO BusinessWorks migration take?

A TIBCO BusinessWorks migration takes 8 weeks to 18 months, depending on the number of integrations in scope. Process count, custom Java and adapter use drive the rest of the variation.

The table below shows typical durations for a migration to Workato by estate size:

BusinessWorks estateIntegrationsDurationDelivery pattern
SmallFewer than 508 to 16 weeks1 or 2 cutover waves
Medium50 to 2003 to 9 monthsWaves of 20 to 50 integrations
LargeMore than 2009 to 18 monthsWaves of 20 to 50 integrations, planned back from the TIBCO renewal date

Every option starts with a fixed-scope assessment of 2 to 4 weeks. Migration services cost £60,000 to £1.5 million (about $75,000 to $1.9 million). Retired TIBCO licences pay this back in 6 to 24 months.

How does Co Valere support each BusinessWorks option?

Co Valere supports each BusinessWorks option with the same assessment, followed by delivery on the chosen path. Co Valere is Workato's EMEA Delivery Partner of the Year 2025 and also runs TIBCO estates for clients.

The 3 delivery paths work as follows:

  • Upgrade to 5.16.1 LTS. Co Valere upgrades engines, plug-ins and adapters, retests processes and keeps the estate under managed support to 2030.
  • Move to BusinessWorks 6 or Container Edition. Co Valere runs the migration tool, reworks adapters and REST services, and replaces Administrator and Hawk monitoring with AppSpace or container monitoring.
  • Migrate to Workato. Co Valere rebuilds processes as recipes in waves, runs both platforms in parallel and decommissions TIBCO at the end.

One Co Valere client shows the scale of rationalisation. A FTSE 250 packaging manufacturer had over 400 undocumented point-to-point integrations across 12 countries. Co Valere reduced the active estate by 60%, and the manufacturer now delivers new integrations 3 times faster.

In Co Valere's view, the upgrade to 5.16.1 is the right first step for estates that cannot fund a migration before their next TIBCO renewal. The LTS window then gives the integration team time to rationalise processes and plan a single move.

Plan your integration migration

Talk to Co Valere's architects about your estate, your timeline and whether to migrate now or keep your current platform under support first.

Contact us