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.

Put Runtime in maintenance mode

Learn how to execute maintenance tasks on your tenants by pausing and resuming BPM services of a Bonita Runtime.

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 Bonita Runtime temporarily while it is updated. This is done by pausing the tenant.

When a tenant is paused, this has the following consequences:

  • Only the technical user can log into Bonita, and only into the Bonita Super Administrator application.

  • Users who are currently logged in, including regular Administrators, 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.

Those are the reasons why such maintenance procedures must be planned at a time of low usage and must be communicated carefully to the users.

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

Pause a tenant

  1. Log into Bonita Super Administrator application

  2. Go to BPM services

  3. Click the Pause button

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

  5. The tenant is immediately paused.

Resume a tenant

  1. Log into Bonita Super Administrator application

  2. Go to BPM services

  3. Click the Resume button

  4. In the popup, click Resume to confirm that tenant services are to be resumed.

  5. The tenant resumes activity.

After the services are resumed, it is important to inform users that they can now log into all applications.