Installation Documentation is a mess...

Description

Hi...

After looking at this post http://community.bonitasoft.com/node/24343#node-24349 I decided to have a look and try it myself...Install 7.3.1 with an existing PostgreSQL database.

My goodness, what a mess.

Can you please rewrite ALL of the Installation documentation so it flows in ONE easy step by step procedure.

So far I have seen four (yes four) different pages on what to do and none of it really makes sense, and this is only talking about Tomcat not even JBoss:

1) Installing Tomcat Bundle: http://documentation.bonitasoft.com/bonitabpm/?page=tomcat-bundle

Says: Configure the Tomcat server datasources

(A) Make sure your database is created before you start configuring the Tomcat datasources and make sure you do so before you start the Tomcat server.

(B) If you use the Business Data Model (BDM) feature, we recommend that you configure a dedicated database.

(C) You can also find more details on database configuration in the dedicated page.

(D) Not actuially on this page but part of the problem: http://documentation.bonitasoft.com/bonitabpm/?page=database-configuration-for-business-data

Issues:

(A) It's very confusing. Also there is no link to the necessary page: http://documentation.bonitasoft.com/bonitabpm/?page=BonitaBPM_platform_setup

It could be much clearer:

on your choosen database engine please create TWO databases

bonita_journal for the Bonita Engine, and
bonita_business_data for the Business Data that your processes will be using

or use the setup.bat init to actually create the databases...

Postgresql has the createdb dbname; command and something similar is available with all others.

(B) This is just a waste of time statement. If you use BDM? WHAT? Bonitasoft have made it all but impossible NOT to use BDM. It is a MUST.

Bonitasoft should effect a change that integrates both the normal database and BDM database changes as one.

(C) This page should be merged into the platform specific installation document. Tomcat or JBoss, there is no need for it to be separate.

(D) Same as C but partly covered by B as well.

2) Page: http://documentation.bonitasoft.com/bonitabpm/?page=BonitaBPM_platform_setup

To do so, after you have created the database, modify the tool database.properties file: Set the right db vendor by commenting and uncommenting properties inside this file and change connection url, user credentials, database name and so on.

The first line To do so, after you have created the database, modify the tool database.properties file makes no sense...the setup is supposed to create the database but here you say after you've created the database.

Say something like, Once you have identified and installed your chosen database engine you will need to modify the setup tool database.properties file...etc...

In the database.properties file and in all other files by the way splitting properties is a mistake and causes mistakes

What you have (HEADINGS ONLY):

postgres
sqlserver
oracle
mysql
hs
postgres
mysql
sqlserver
oracle

would be easier to fix if you had (HEADINGS ONLY)

h2
postgres
sqlserver
oracle
mysql

It's taken me two hours to get this setup working...dreadful.

regards

Environment

Windows 10

Steps to reproduce

None

Workaround

None

External Link

None

Status

Assignee

Antoine Mottier

Reporter

Sean McPoland

Reference

None

Components

Affects versions

7.3.1
Configure