This documentation is about a version that is out of support, here is the latest documentation version.

How about downloading a newer, supported version?

Migration overview

Learn how to migrate a Bonita Platform from an older version to a newer version.

Migrating your platform to the new version

You can automatically migrate the platform from an earlier version of Bonita. You cannot migrate your platform from a version earlier than 6.0.2. After migration, a process continues to run unchanged. You can modify the process definition later to take advantage of the new features in this version of Bonita.

Migrating your Bonita Studio

To migrate to a newer version of Bonita Studio, install the new version using the Studio installer wizard for your operating system. If you want to keep the artifacts in your workspace, select the option to migrate your workspace.

if you do not migrate your workspace, or if you use the OS-independent archive to install the new Bonita Studio, your workspace is not automatically migrated. In this case, you must manually export each item from the older Bonita Studio and import it into the newer version.

Migrating your process definitions

A process definition created using Bonita 6.x can be run on this version after the platform migration. However, you might choose to update the process definition to take advantage of new features. To update a process definition, export it from the older version of Bonita Studio as a .bos file, then import it into the newer version and update it.

you cannot import a process definition .bos file into a version of Bonita Studio that is older than the version that was used to create it.

You can import a .bos file containing a process definiiton from a Bonita 6.x or Bonita Open Solution 5.x. The guided migration converts the 5.x process definition to use the legacy 6.x tooling so that the process can run on a Bonita 7.x platform. You can modify the process definition later to take advantage of the new features in this version of Bonita.