Chapter 3. Installation guide

Table of Contents

3.1. Installation
3.2. Standard vs Enterprise installation
3.2.1. Standard installation
3.2.2. Enterprise installation

3.1. Installation

Nova Bonita M3 release adds support for both standard and enterprise deployments. After unzipping this release you could easily use Nova Bonita "as a library" inside your web or rich client application or to deploy it into you favorite application server and use it remotely.

So, first of all you should start by unzipping the Bonita distribution package:

>unzip bonita-4.0.M3.zip

A new directory bonita-4.0.M3 will be created with the following structure:

README
build.xml
build.properties
License.txt
release_notes.txt
conf/
doc/
examples/
ear/
lib/

Let's describe those items :

  • README

    This file gives the basic information related to Nova Bonita

  • build.xml

    This file is an ant file that provides tasks to run both unit tests and examples (detailled command are given in following sections).

  • build.properties

    This file contains the J2EE properties required to deploy and leverage Nova Bonita APIs deployed in a remote J2EE server (by default properties are set to deploy in the EasyBeans EJB3 container)

  • License.txt

    The license of Nova Bonita. Bonita is released under the LGPL license.

  • conf/

    This directory contains default configuration files for Nova Bonita. That includes the "Environment" xml file (including services and objects used as default by the engine), login modules (JAAS compliant login modules samples) and hibernate persistence configuration (as a default implementation to handle Nova Bonita persistence). Standard (JSE) and Enterprise (JEE) versions in both in memory and persistence modes are provided

  • doc/

    This directory contains the documentation of Nova Bonita. It contains 2 directories :

    • html/

      For HTML documentation

    • pdf/

      For PDF documentation

  • examples/

    This directory contains an example provided with Nova Bonita package. This sample application illustrates how to leverage Nova Bonita APIs from a client application. That includes the sample source required to leveraged those APIs in both JSE and J2EE environments.

    • Approval Workflow sample

      This is a generic Approval Workflow process. Workflow deployment, definition and execution phases are illustrated in this sample. The sample application is provided in both standard and enterprise environments in which the workflow APIs are leveraged as POJOs or as Session Beans respectively.

  • lib/

    This directory contains the libraries used in Nova Bonita M3. Nova Bonita can be integrated in your applciation/IS in different ways (integrated in a web application, inside a rich client application, remotly deployed in a JEE application server...). Depending on your integration environment only some of those libraries will be required.