Bonita Windows Server Installation on Tomcat

14 Feb


Installation Steps

  • Install JRE by clicking on the downloaded file.
  • Install JDK by clicking on the downloaded file.
  • Unzip Apache Tomcat file to a folder, use this path as <TOMCAT_HOME>.
  • Unzip Bonita Open Solution Deployment file to a folder. This folder is referenced as <BOS-5.9-DEPLOY> in the installation guides.
  • Follow this instruction:

    1. Skip “Download Tomcat” section.
    2. Skip “Download server files” section.
    3. Configure JAAS authentication and communication” section is not necessary if you are not using custom authentication. Follow this step if changes to JAAS authentication is required, for example, use LDAP for authentication.
    4. Configure BOS Tomcat for other databases” section is not necessary if you are not planning to use different database.
  • Add environment variable:
    1. Follow this instruction to add environment variables:
    2. Value for “JRE_HOME” and “JAVA_HOME” depend on version of JRE and JDK you downloaded. Make sure the value reflect to folder where the installation is.
    3. Add JRE_HOME
      1. key: JRE_HOME
        value: C:\Program Files (x86)\Java\jre7
    4. Add JAVA_HOME
      1. key: JAVA_HOME
        value: C:\Program Files (x86)\Java\jdk1.7.0_13

Startup / Shutdown Tomcat

It’s necessary to startup / shutdown Tomcat in proper way before replacing / modify any file in <TOMCAT_HOME> folder.

To startup Tomcat

  • On command prompt, browse to <TOMCAT_HOME>\bin folder.
  • Run “startup.bat” file.

To shutdown Tomcat

  • On command prompt, browse to <TOMCAT_HOME>\bin folder.
  • Run “shutdown.bat” file.

Running Bonita User Experience


You can install Bonita REST API with the following step:

  • Copy <BOS-5.9-deploy>\bonita_execution_engine\interfaces\REST\with_execution_engine_without_client\bonita-server-rest.war
  • Paste the file into <TOMCAT_HOME>\webapps

Running Bonita REST API

If you need to use an REST client, you must have acknowledgement of the Bonita HTTP API. All HTTP requests will be done using the POST method.

All requests, except checkUserCredentials, checkUserCredentialsWithPasswordHash and getIdentityKeyFromTemporaryToken, will require authentication using HTTP Basic.

To generate your first REST API call, follow this step under “REST client“:

1 Comment

Posted by on February 14, 2013 in General


Tags: , , ,

One response to “Bonita Windows Server Installation on Tomcat

  1. Bhavuk

    June 19, 2013 at 7:23 pm

    In the step,
    Running Bonita User Experience.. the engine is not logging with admin/bpm as credentials. How should I resolve this??


Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

%d bloggers like this: