27/6/2015

HowtoinstallBonitaBPMforGlassfishapplicationserver|BonitaDocumentation

Search

Bonita BPM 6.2 (/bosversion/bonitabpm62)

+

Application
and Process Design (/productbossp/processandapplicationdesign)

Installation
(/productbossp/installation)
Bonita BPM installation overview (/productbossp/bonitabpminstallationoverview)
Bonita BPM Studio installation (/productbossp/bonitabpmstudioinstallation)

+ Basic
Bonita BPM platform installation (/productbossp/basicbonitabpmplatforminstallation)

+ Advanced
Bonita BPM platform installation (/productbossp/advancedbonitabpmplatform
installation)

Platform
installation examples (/productbossp/platforminstallationexamples)
Red Hat + Oracle JVM + JBoss + PostgreSQL (/productbossp/redhatoraclejvmjbosspostgresql)
Ubuntu + OpenJDK + Tomcat + MySQL (/productbossp/ubuntuopenjdktomcatmysql)
Bonita BPM and a Glassfish application server (/productbossp/bonitabpmandglassfish
applicationserver)
Back up Bonita BPM Platform (/productbossp/backbonitabpmplatform)
Install Tomcat as a service in Windows (/productbossp/installtomcatservicewindows)

+ Migration
(/productbossp/migration)

+ Bonita
BPM Portal Administration (/productbossp/bonitabpmportaladministration)

+ Development
(/productbossp/development)

Ubuntu + OpenJDK + Tomcat + MySQL (/product

bossp/ubuntuopenjdktomcatmysql)

http://documentation.bonitasoft.com/howinstallbonitabpmglassfishapplicationserver

1/6

27/6/2015

HowtoinstallBonitaBPMforGlassfishapplicationserver|BonitaDocumentation

How to install Bonita BPM for Glassfish application

server
Product version:
6.2, 6.1
Product edition:
Community
Teamwork
Efficiency
Performance

(/printpdf/337)

Overview
This document lists the steps to deploy a BonitaBPM Deploy (compatible v6.1 + v6.2) from scratch, on the
following stack, on the same server: Windows Server 2008 R2 + JVM Oracle 1.7 + GlassFish 3.1.2.2 +
PostgreSQL 9.1
Target Audience: Platform Administrator
OS version: Windows

Prerequisite
If you intend deploying different Bonita BPM editions, either Community or SP, the steps are reusable. Only
zip folder names change and no license is needed for the Community edition.
Install your OS using the standard installation
Install Oracle 7u45 using the standard installation

Install Glassfish 3.1.2.2 Application Server

Download Glassfish 3.1.2.2 (http://download.java.net/glassfish/3.1.2.2/release/glassfish3.1.2.2
windows.exe)
1. Open a command window and launch installer:
C:\glassfish3.1.2.2windows.exe j "C:\Program Files\Java\jdk1.6.0_45"
C:\Program Files\Java\jdk1.6.0_45 is the default path of the JVM installation

http://documentation.bonitasoft.com/howinstallbonitabpmglassfishapplicationserver

2/6

27/6/2015

2.
3.
4.
5.
6.
7.
8.
9.
10.
11.

HowtoinstallBonitaBPMforGlassfishapplicationserver|BonitaDocumentation

Click Next
Select typical installation
Leave default installation directory (C:\glassfish3), click Next
Uncheck Install Update Tool checkbox and click Next
Click on the Install button
Keep default settings and set username = admin and password (bonita)
Tick create Operating System service for the domain
Click Next
Check overall status : Complete
Click Exit
<GLASSFISH_HOME>=C:\glassfish3\glassfish

Install PostgreSQL 9.1

standard installation

Create the database schema (e.g. bonita) and a user (e.g. bonita_gf)
Create a user (assuming Postgres has a user named postgres)
1.
2.
3.
4.
5.
6.
7.
8.
9.

Open a command window

Type runas /user:postgres
Type createuser P bonita_gf
Password for new role: bpm
Confirm the paswword: bpm
Superuser?: n (No)
Role is allowed to create a new database? n
Role is allowed to create more new roles? n
Password:postgrespassword

Create the database with a default schema

1. Open a command window
2. Type createdb O bonita_gf bonita_gf_db
3. Password: <postgrespassword>
Install Bonita BPM 6.1.0 platform
1. Download the deploy.zip file from the Bonitasoft site for the Community edition or from the
(http://www.bonitasoft.com/howwedoit#howwedoit_downloads)Customer Portal
(http://www.bonitasoft.com/resources/customerportal/download/request) for Subscription
editions.
2. To use the Efficiency or Performance edition, download the editionspecific bonita_home from the
Customer Portal (http://www.bonitasoft.com/resources/customerportal/download/request).
3. <BONITA_DEPLOY> is the root of the deploy directory
4. Create a folder <BOS_CONF> wherever you want.

http://documentation.bonitasoft.com/howinstallbonitabpmglassfishapplicationserver

3/6

27/6/2015

HowtoinstallBonitaBPMforGlassfishapplicationserver|BonitaDocumentation

5. Copy and rename <BONITA_DEPLOY>\bonita_home6.1.0 to <BOS_CONF>\bonita\

6. For the Efficiency or Teamwork edition, copy the content of the editionspecific bonitahome zip to
<BOS_CONF>\bonita\.
7. If you have a Subscription Pack edition, generate a license and copy into
<BOS_CONF>\bonita\server\licenses
8. Add <BONITA_DEPLOY>\Tomcat6.0.37\lib\slf4japi1.6.1 and slf4jjdk141.6.1 to WEBINF\lib directory
within the bonita.war
9. Create a glassfishweb.xml file (see sample below) and add it to the bonita.war in the WEBINF\
directory
<?xml version="1.0"?>
<!DOCTYPE glassfishwebapp SYSTEM "http://glassfish.org/dtds/glassfishwebapp_3_01.dtd"
PUBLIC "//GlassFish.org//DTD GlassFish Application Server 3.1 Servlet 3.0//EN">
<glassfishwebapp>
<classloader delegate="false"></classloader>
</glassfishwebapp>
10. Download the database driver (http://jdbc.postgresql.org/download.html#current) you are using
11. Copy the db driver into the <GLASSFISH_HOME>\domains\domain1\lib directory
Bonitasoft.com (http://www.bonitasoft.com) Community (http://community.bonitasoft.com/)
12. Open a command
window and run the following
command to define the database vendor:
Register (/user/register?destination=node/337)
Login (/user/login?destination=node/337)
asadmincreatesystempropertyDsysprop.bonita.db.vendor=postgres

13. In your command window, go to <GLASSFISH_HOME>\bin and run the following command to define the
bonita home:
asadmincreatejvmoptionsDbonita.home=<BOS_CONF>\bonita

14. Open up the <BOS_CONF>\bonita\server\platform\conf\bonitaplatform.properties file and update

the following values as described below:
database.journal.datasource.name=jdbc/bonitaDSXA
database.sequence.manager.datasource.name=jdbc/bonitaSequenceManagerDS

hibernate.transaction.manager_lookup_class=org.hibernate.transaction.SunONETransactionManager
transaction.manager=java:appserver/TransactionManager
userTransaction=java:comp/UserTransaction

Create and configuring datasource

1. Open web browser to the glassfish admin console (http://localhost:4848/) log in (admin/bonita) and
go to Resources>JDBC>JDBC Connection Pools and create a new pool with the following settings
(according to your database):
Pool Name : bonitaDSXA

http://documentation.bonitasoft.com/howinstallbonitabpmglassfishapplicationserver

4/6

27/6/2015

HowtoinstallBonitaBPMforGlassfishapplicationserver|BonitaDocumentation

Resource type: javax.sql.XADataSource

Database driver vendor: PostgreSQL
2. Click Next and set the following according to your database settings
Database name: bonita_gf_db
Portnumber: 5432
Server name: localhost
User: bonita_gf
Password: bpm
3.
4.
5.
6.

Delete the url property

Perform a ping to check connectivity
Click Finish.
Do the previous three steps also with the following:
Pool Name: bonitaSequenceManagerDS
Resource type: javax.sql.DataSource
2015
Bonitasoft,
Inc. All rights reserved.
Database driver
vendor:
PostgreSQL
(database name, etc is the same)
Password: bpm

7. Delete the url property

8. Perform a ping to check connectivity
9. Using the admin console, go to: Configurations>serverconfig>Transaction Service and set: On
Restart: Enabled
10. Click Save.
11. Restart the Glassfish server.
12. Go to Resources>JDBC>JDBC Resources and create a new Resource with the following:
Name: jdbc/bonitaDSXA
Pool name: bonitaDSXA
13. Do the same for:
Name: jdbc/bonitaSequenceManagerDS
Pool name: bonitaSequenceManagerDS
14. Click Ok.

Install the web app

In the Glassfish admin console, go to Applications and browse to your bonita.war file to deploy it
Set application name = bonita (default)
Click Ok

http://documentation.bonitasoft.com/howinstallbonitabpmglassfishapplicationserver

5/6

27/6/2015

HowtoinstallBonitaBPMforGlassfishapplicationserver|BonitaDocumentation

Launch the application and create a new user

Note: do not create a user or an administrator with the same login and password as the technical users
(platform and tenant) See more at: http://doc.preprod.bonitasoft.net/firststepsafter
setup#sthash.ko2FjeeZ.dpuf
Open up your browser at http://localhost:8080/bonita
log as technical user to create the first Bonita user
technical user: install
password: install
Create a user
Go to the Configuration menu and select Profiles
Select profiles for the newly created user
Log out then log back in with the new user

(/printpdf/337)
Last update on Apr, 9 2014
Ubuntu + OpenJDK + Tomcat + MySQL (/product
bossp/ubuntuopenjdktomcatmysql)

Log in to post comments (/user/login?destination=howinstallbonitabpmglassfishapplicationserver)

OR

No account yet? Create one. (/user/register?destination=howinstallbonitabpmglassfishapplicationserver

http://documentation.bonitasoft.com/howinstallbonitabpmglassfishapplicationserver

6/6