This documentation (Bonita Open Solution V5) is an archive. Please click here for current documentation.
Advanced search

Migrate from 5.10.x to 5.10.2

To migrate from an earlier 5.10.x version to 5.10.2, follow the steps below:

1. Download the deploy.zip or a bundle.zip file from the Bonitasoft website (for BOS) or the Customer Portal (for BOS-SP).

2. Unzip the downloaded file in a temporary folder. You will copy files from this temporary folder to your BOS or BOS-SP installation.

3. Stop your application server.

4. Make a backup of your system XREF.

5. Update your BOS or BOS-SP software.

In your existing BOS or BOS-SP installation, make the following changes:

  • Replace the Bonita library jar files and their dependencies with the new versions from your temporary folder.
  • Replace the Bonita web applications and/or EAR (User Experience, REST, EJB) with the new versions from your temporary folder.
  • Replace the bonita.server.xml file (in /home/bonita/BOS-SP-5.10.1-Tomcat-6.0.35/bonita/server/default/conf for a Tomcat installation) with the new version from your temporary folder. If you previously customized this file, you can re-apply these changes.

6. Add indexes to the journal and history database tables:

H2, PostgreSQL and MySQL:

create index IDX_OEI_VP_ID_ on BN_VAR (OEI_VP_ID_);
create index IDX_FEED_ID on BN_COMMENTS (FEED_ID_);
create index IDX_CHILDREN_UUID_ on BN_PROC_INST_CHILD (CHILDREN_UUID_);

 

SQL Server:

create index IDX_OEI_VP_ID_ on BN_VAR (OEI_VP_ID_)
GO
create index IDX_FEED_ID on BN_COMMENTS (FEED_ID_)
GO
create index IDX_CHILDREN_UUID_ on BN_PROC_INST_CHILD (CHILDREN_UUID_)
GO

 

Oracle:

On Oracle systems, these indexes should already exist but they need to be renamed:

ALTER INDEX FK75177C949C0AB6F9 RENAME TO IDX_OEI_VP_ID_;
ALTER INDEX FKE1798C8763F3679B RENAME TO IDX_FEED_ID;
ALTER INDEX FKC82D2059786844DC RENAME TO IDX_CHILDREN_UUID_;

 

If the indexes do not already exist, you will see the following error message:

ORA-01418: specified index does not exist

 

In that case, create the indexes:

create index IDX_OEI_VP_ID_ on BN_VAR (OEI_VP_ID_);
create index IDX_FEED_ID on BN_COMMENTS (FEED_ID_);
create index IDX_CHILDREN_UUID_ on BN_PROC_INST_CHILD (CHILDREN_UUID_);

 

7. Restart your application server.

The migration is complete.