Professional Documents
Culture Documents
BOS 5.4.1 Bundle Installation Guide
BOS 5.4.1 Bundle Installation Guide
BOS 5.4.1 Bundle Installation Guide
Version 5.4.1
Contents
Overview ..................................................................................................................................... 3
Part 1. Requirements for installing BOS ........................................................................................ 3
Part 2. Install BOS-Tomcat bundle and configure if needed for external database .......................... 3
2.1 Install the BOS-Tomcat bundle ............................................................................................... 3
2.2 Configure the BOS-Tomcat bundle for use with MySQL ......................................................... 5
Part 3. Install BOS-JBoss bundle and configure if needed for external database .......................... 11
3.1 Install the BOS-JBoss bundle ................................................................................................. 11
3.2 Configure the BOS-JBoss bundle for use with MySQL. ......................................................... 12
BOS 5.4 – HowTo Install BOS with or without an external database www.bonitasoft.com | © BonitaSoft S.A. page 2
“How to” install a BOS bundle with or without an external database
Overview
This “How to” guide contains instructions for installing a BOS-bundle and covers the
configuration of your bundled application server for MySQL. (You can however, adapt this
process to any database with an existing Hibernate dialect
(http://docs.jboss.org/hibernate/core/3.6/reference/en-US/html/session-
configuration.html#configuration-optional-dialects).
The simplest, fastest installation of BOS for a server environment, can be made using the
BOS-bundle, with the default H2 database provided.
Note: We do not recommend the use of a simple bundle installation using the default H2
database for production. This document describes how to change the connection from the
default H2 database to an external database (MySQL), which is a production-friendly option.
Part 2 Install BOS-Tomcat bundle and configure. The simple bundle installation with the
default H2 database is fully described in Part 2.1. Follow Part 2.2 to configure the bundle to
use a different, external database.
Part 3 Install BOS-JBoss bundle and configure. The simple bundle installation with the
default H2 database is fully described in Part 3.1. Follow Part 3.2 to configure the bundle to
use a different, external database.
Part 2. Install BOS-Tomcat bundle and configure if needed for external database
This location path will be referenced as <tomcat_home> in the following sections of this
document.
BOS 5.4 – HowTo Install BOS with or without an external database www.bonitasoft.com | © BonitaSoft S.A. page 3
“How to” install a BOS bundle with or without an external database
Note: If you will be using only the default H2 database, validate your installation now.
If you will be using an external database, such as MySQL, skip this step and continue to 2.2,
Configure the BOS-Tomcat bundle for use with MySQL.
Note: Be sure to replace <serveraddress> with a fully qualified domain name (FQDN) or the
IP address of the server. Avoid using localhost for <serveraddress> .
You should be able to access the Bonita User Experience login page:
You can log in with one of the following usernames and a single password:
Note: If you are unable to reach the log-in page shown above, please consult the log files.
(see 2.2.7, Log errors).
BOS 5.4 – HowTo Install BOS with or without an external database www.bonitasoft.com | © BonitaSoft S.A. page 4
“How to” install a BOS bundle with or without an external database
bonita_journal
bonita_history
Grant this user all privileges to access the bonita_journal and bonita_history databases.
2.2.3 Modify the BOS configuration files for use with MySQL
In order to configure BOS for use with a database other than H2, you will need to edit 2
properties configuration files and 1 data source configuration file.
by adding a hash (#) at the beginning of the original line to de-activate H2:
BOS 5.4 – HowTo Install BOS with or without an external database www.bonitasoft.com | © BonitaSoft S.A. page 5
“How to” install a BOS bundle with or without an external database
original line:
hibernate.dialect [] org.hibernate.dialect.H2Dialect
original line:
hibernate.connection.shutdown [] true
original line:
bonita.hibernate.interceptor []
org.ow2.bonita.env.interceptor.H2DescNullFirstInterceptor
by deleting the hash (#) at the beginning of the original line, to activate MySQL.
original line:
#hibernate.dialect []
org.hibernate.dialect.MySQL5InnoDBDialect
BOS 5.4 – HowTo Install BOS with or without an external database www.bonitasoft.com | © BonitaSoft S.A. page 6
“How to” install a BOS bundle with or without an external database
original line:
#hibernate.connection.shutdown [] true
original line:
#bonita.hibernate.interceptor []
org.ow2.bonita.env.interceptor.MySQLDescNullFirstInterceptor
Modify the BOS-Tomcat data source configuration file called ‘context.xml’, to change the
data base configuration from H2 (by default) to MySQL.
To do this, change the driverClass and jdbcUrl parameters for your configuration in the
Resources named bonita/default/journal and bonita/default/history.
Locate the Resource tag for bonita/default/journal and as shown below, replace the
default H2 driverClass and jdbcUrl parameters with MySQL parameters:
original H2 lines:
<Resource
name="bonita/default/journal"
auth="Container"
type="com.mchange.v2.c3p0.ComboPooledDataSource"
factory="org.apache.naming.factory.BeanFactory"
description="DB Connection"
driverClass="org.h2.Driver"
jdbcUrl="jdbc:h2:file:
${BONITA_HOME}/server/default/work/databases/bonita_jour
nal.db;FILE_LOCK=NO;MVCC=TRUE;DB_CLOSE_ON_EXIT=TRUE"
BOS 5.4 – HowTo Install BOS with or without an external database www.bonitasoft.com | © BonitaSoft S.A. page 7
“How to” install a BOS bundle with or without an external database
Locate the Resource tag for bonita/default/history and as shown below, replace the
default H2 driverClass and jdbcUrl parameters with the MySQL parameters:
original H2 line:
<Resource
name="bonita/default/history"
auth="Container"
type="com.mchange.v2.c3p0.ComboPooledDataSource"
factory="org.apache.naming.factory.BeanFactory"
description="DB Connection"
driverClass="org.h2.Driver"
jbcUrl="jdbc:h2:file:${BONITA_HOME}/server/default/work/d
atabases/bonita_history.db;FILE_LOCK=NO;MVCC=TRUE;DB_CLOS
E_ON_EXIT=TRUE"
Note: Remember to set the user and password in your data source configuration in order to
match the “user and “password” you set (with full access rights) during 2.2.2 Configure the
access privileges for MySQL.
BOS 5.4 – HowTo Install BOS with or without an external database www.bonitasoft.com | © BonitaSoft S.A. page 8
“How to” install a BOS bundle with or without an external database
Extract the mysql-connector-java-5.1.15-bin.jar file from the downloaded .zip file and install
into: <tomcat_home>\lib\bonita
Start Tomcat
Connect to BOS
Note: Be sure to replace <serveraddress> with a fully qualified domain name (FQDN) or the
IP address of the server. Avoid using localhost for <serveraddress> .
You should be able to access the Bonita User Experience login page:
You can log in with one of the following usernames and a single password:
BOS 5.4 – HowTo Install BOS with or without an external database www.bonitasoft.com | © BonitaSoft S.A. page 9
“How to” install a BOS bundle with or without an external database
Note: If you are unable to reach the log-in page shown above, please consult the log files.
(see 2.2.7, Log errors).
With your database server and web container running, point your web browser to
http://<serveraddress:port>/bonita/.
2.2.8 Troubleshooting
BOS 5.4 – HowTo Install BOS with or without an external database www.bonitasoft.com | © BonitaSoft S.A. page 10
“How to” install a BOS bundle with or without an external database
Part 3. Install BOS-JBoss bundle and configure if needed for external database
This location path will be referenced as <jboss_home> in the following sections of this
document.
3.1.1 Launch and verify your BOS-JBoss bundle installation with H2 database
Note: If you will be using only the default H2 database, validate your installation now.
If you will be using an external database, such as MySQL, skip this step and continue to 3.2,
Configure the BOS-JBoss bundle for use with MySQL.
Note: Be sure to replace <serveraddress> with a fully qualified domain name (FQDN) or the
IP address of the server. Avoid using localhost for <serveraddress> .
You should be able to access the Bonita User Experience login page:
You can log in with one of the following usernames and a single password:
BOS 5.4 – HowTo Install BOS with or without an external database www.bonitasoft.com | © BonitaSoft S.A. page 11
“How to” install a BOS bundle with or without an external database
Note: If you are unable to reach the log-in page shown above, please consult the log files.
(see 3.2.7, Log errors).
bonita_journal
bonita_history
Grant this user all privileges to access the bonita_journal and bonita_history databases.
3.2.3 Modify the BOS configuration files for use with MySQL
In order to configure BOS for use with a database other than H2, you will need to
Edit 2 properties configuration files and 1 data source configuration file.
by adding a hash (#) at the beginning of the original line to de-activate H2:
BOS 5.4 – HowTo Install BOS with or without an external database www.bonitasoft.com | © BonitaSoft S.A. page 12
“How to” install a BOS bundle with or without an external database
original line in:
hibernate.dialect [] org.hibernate.dialect.H2Dialect
original line:
hibernate.connection.shutdown [] true
original line:
bonita.hibernate.interceptor
org.ow2.bonita.env.interceptor.H2DescNullFirstInterceptor
by deleting the hash (#) at the beginning of the original line, to activate MySQL.
original line:
#hibernate.dialect []
org.hibernate.dialect.MySQL5InnoDBDialect
original line:
#hibernate.connection.shutdown [] true
BOS 5.4 – HowTo Install BOS with or without an external database www.bonitasoft.com | © BonitaSoft S.A. page 13
“How to” install a BOS bundle with or without an external database
original line:
#bonita.hibernate.interceptor
org.ow2.bonita.env.interceptor.MySQLDescNullFirstInterceptor
Modify the BOS-JBoss data source configuration file called ‘mysql-ds.xml’, in order to
change the data base configuration from H2 to MySQL.
To do this, change the driverClass and jdbcUrl parameters for your configuration in the
Resources named bonita/default/journal and bonita/default/history.
Locate the Resource tag for bonita/default/journal and as shown below, replace the
default H2 driverClass and jdbcUrl parameters with MySQL parameters:
original H2 lines:
<Resource
name="bonita/default/journal"
auth="Container"
type="com.mchange.v2.c3p0.ComboPooledDataSource"
factory="org.apache.naming.factory.BeanFactory"
description="DB Connection"
driverClass="org.h2.Driver"
jdbcUrl="jdbc:h2:file:
${BONITA_HOME}/server/default/work/databases/bonita_jour
nal.db;FILE_LOCK=NO;MVCC=TRUE;DB_CLOSE_ON_EXIT=TRUE"
BOS 5.4 – HowTo Install BOS with or without an external database www.bonitasoft.com | © BonitaSoft S.A. page 14
“How to” install a BOS bundle with or without an external database
Locate the Resource tag for bonita/default/history and as shown below, replace the
default H2 driverClass and jdbcUrl parameters with MySQL parameters:
original H2 lines:
<Resource
name="bonita/default/history"
auth="Container"
type="com.mchange.v2.c3p0.ComboPooledDataSource"
factory="org.apache.naming.factory.BeanFactory"
description="DB Connection"
driverClass="org.h2.Driver"
jbcUrl="jdbc:h2:file:${BONITA_HOME}/server/default/work/d
atabases/bonita_history.db;FILE_LOCK=NO;MVCC=TRUE;DB_CLOS
E_ON_EXIT=TRUE"
Note: Remember to set the user and password in your data source configuration in order to
match the “user and “password” you set (with full access rights) during 3.2.2 Configure the
access privileges for MySQL.
Extract the mysql-connector-java-5.1.15-bin.jar file from the downloaded .zip file and install
into: <jboss_home>\lib\bonita
Start JBoss
BOS 5.4 – HowTo Install BOS with or without an external database www.bonitasoft.com | © BonitaSoft S.A. page 15
“How to” install a BOS bundle with or without an external database
Connect to BOS
Note: Be sure to replace <serveraddress> with a fully qualified domain name (FQDN) or the
IP address of the server. Avoid using localhost for <serveraddress> .
You should be able to access the Bonita User Experience login page:
You can log in with one of the following usernames and a single password:
Note: If you are unable to reach the log-in page shown above, please consult the log files.
(see 3.2.7, log errors).
With your database server and web container running, point your web browser to
http://<serveraddress:port>/bonita/.
3.2.8 Troubleshooting
BOS 5.4 – HowTo Install BOS with or without an external database www.bonitasoft.com | © BonitaSoft S.A. page 16