reorder the databases section and warn about known issues with MySQL

bonita/content.md

@@ -18,8 +18,29 @@ You can access the Bonita BPM Portal on http://localhost:8080/bonita and login u
 
 ## Link Bonita BPM to a database
 
+### PostgreSQL
+
+PostgreSQL is the recommanded database.
+
+[Set max_prepared_transactions to 100](http://documentation.bonitasoft.com/database-configuration-business-data-1):
+
+	mkdir -p custom_postgres
+	echo '#!/bin/bash' > custom_postgres/bonita.sh
+	echo 'sed -i "s/^.*max_prepared_transactions\s*=\s*\(.*\)$/max_prepared_transactions = 100/" "$PGDATA"/postgresql.conf' >> custom_postgres/bonita.sh
+	chmod +x custom_postgres/bonita.sh
+
+Mount that directory location as /docker-entrypoint-initdb.d inside the PostgreSQL container:
+
+	docker run --name mydbpostgres -v "$PWD"/custom_postgres/:/docker-entrypoint-initdb.d -e POSTGRES_PASSWORD=mysecretpassword -d postgres:9.3
+
+See the [official PostgreSQL documentation](https://registry.hub.docker.com/_/postgres/) for more details.
+
+	docker run --name bonita_postgres --link mydbpostgres:postgres -d -p 8080:8080 bonita
+
 ### MySQL
 
+There are known issues with the management of XA transactions by MySQL engine and driver: see MySQL bugs [17343](http://bugs.mysql.com/bug.php?id=17343) and [12161](http://bugs.mysql.com/bug.php?id=12161) for more details. Thus, using MySQL database in a production environment is not recommended.
+
 [Increase the packet size](http://documentation.bonitasoft.com/database-configuration-2#mysqlspec) which is set by default to 1M:
 
 	mkdir -p custom_mysql
@@ -36,23 +57,6 @@ Start your application container to link it to the MySQL container:
 
 	docker run --name bonita_mysql --link mydbmysql:mysql -d -p 8080:8080 bonita
 
-### PostgreSQL
-
-[Set max_prepared_transactions to 100](http://documentation.bonitasoft.com/database-configuration-business-data-1):
-
-	mkdir -p custom_postgres
-	echo '#!/bin/bash' > custom_postgres/bonita.sh
-	echo 'sed -i "s/^.*max_prepared_transactions\s*=\s*\(.*\)$/max_prepared_transactions = 100/" "$PGDATA"/postgresql.conf' >> custom_postgres/bonita.sh
-	chmod +x custom_postgres/bonita.sh
-
-Mount that directory location as /docker-entrypoint-initdb.d inside the PostgreSQL container:
-
-	docker run --name mydbpostgres -v "$PWD"/custom_postgres/:/docker-entrypoint-initdb.d -e POSTGRES_PASSWORD=mysecretpassword -d postgres:9.3
-
-See the [official PostgreSQL documentation](https://registry.hub.docker.com/_/postgres/) for more details.
-
-	docker run --name bonita_postgres --link mydbpostgres:postgres -d -p 8080:8080 bonita
-
 ## Modify default credentials
 
 	docker run --name=bonita -e "TENANT_LOGIN=tech_user" -e "TENANT_PASSWORD=secret" -e "PLATFORM_LOGIN=pfadmin" -e "PLATFORM_PASSWORD=pfsecret" -d -p 8080:8080 bonita