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
(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.
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):
would be easier to fix if you had (HEADINGS ONLY)
It's taken me two hours to get this setup working...dreadful.
I'm currently trying to define a new layout for installation documentation page in order to keep it simple and maintainable but at the same time cover all the combination of support matrix component (2 OS, 2 JEE application server, 4 RDBMS).
Thanks, that will be fun
Sometimes the easy approach is best: separate Install Manuals...
Yes, some duplication, but easier to do/check