This documentation is for a version that is out of support.

You may want to view the same page for the latest version, or for any of the versions available in the drop-down menu in the top-right corner.

Maintenance of the Bonita Platform

Learn how to execute maintenance tasks on your tenants by pausing and resuming services of the Bonita Platform.

For certain maintenance tasks that require a change to database tables or to information used by several processes (for example to update the business data model), it is necessary to pause services of the Bonita Platform temporarily while it is updated. This is done by pausing the tenant. While a tenant is paused, only the technical user has access to Bonita Portal.

When you pause a tenant, this has the following consequences:

  • Only the technical user can log in to the Portal.

  • Users who are currently logged in, including Administrator users, are automatically logged out.

  • Users who are filling in forms when the service is paused will lose any information that has not been submitted.

  • All processes are automatically paused.

The following sections explain how to pause and resume service in a tenant using Bonita Portal. You can also use the Engine API or the Web REST API.

Pause a tenant

To pause a tenant:

  1. Log in to Bonita Portal as the tenant technical user.

  2. Go to Configuration > BPM services

  3. Click the Pause button.

  4. In the popup, click Pause to confirmation that the tenant is to be paused.

  5. The tenant is immediately paused.

Resume a tenant

  1. Log in to Bonita Portal as the tenant technical user.

  2. Go to Configuration > BPM services

  3. Click the Resume button.

  4. In the popup, click Resume to confirm that you want the tenant to resume service.

  5. The tenant resumes activity.

After the service is resumed, inform users that they can now log in to the Portal.