|
|
@@ -17,7 +17,7 @@ WARNING:
|
|
|
# Supported tags and respective `Dockerfile` links
|
|
|
|
|
|
- [`7.6.3` (*7.6/Dockerfile*)](https://github.com/Bonitasoft-Community/docker_bonita/blob/267f7f8d47b44a0184ecfbfaa072b47ecef1bc7b/7.6/Dockerfile)
|
|
|
-- [`7.7.0`, `latest` (*7.7/Dockerfile*)](https://github.com/Bonitasoft-Community/docker_bonita/blob/dbfb28976df3f452382a086ab0694983f3af2fc4/7.7/Dockerfile)
|
|
|
+- [`7.7.1`, `latest` (*7.7/Dockerfile*)](https://github.com/Bonitasoft-Community/docker_bonita/blob/3b529d760ea1e65c11c0a831c654f3d395b41d42/7.7/Dockerfile)
|
|
|
|
|
|
# Quick reference
|
|
|
|
|
|
@@ -63,7 +63,7 @@ Bonita (called Bonita BPM till 7.5) is an open-source business process managemen
|
|
|
$ docker run --name bonita -d -p 8080:8080 bonita
|
|
|
```
|
|
|
|
|
|
-This will start a container running the [Tomcat Bundle](https://documentation.bonitasoft.com/bonita/7.6/tomcat-bundle) with Bonita Engine + Bonita Portal. With no environment variables specified, it's as like if you have launched the bundle on your host using startup.{sh|bat} (with security hardening on REST and HTTP APIs, cf Security part). Bonita uses a H2 database here.
|
|
|
+This will start a container running the [Tomcat Bundle](https://documentation.bonitasoft.com/bonita/7.7/tomcat-bundle) with Bonita Engine + Bonita Portal. With no environment variables specified, it's as like if you have launched the bundle on your host using startup.{sh|bat} (with security hardening on REST and HTTP APIs, cf Security part). Bonita uses a H2 database here.
|
|
|
|
|
|
You can access the Bonita Portal on http://localhost:8080/bonita and login using the default credentials: install / install
|
|
|
|
|
|
@@ -73,7 +73,7 @@ You can access the Bonita Portal on http://localhost:8080/bonita and login using
|
|
|
|
|
|
PostgreSQL is the recommanded database.
|
|
|
|
|
|
-[Set max_prepared_transactions to 100](https://documentation.bonitasoft.com/bonita/7.6/database-configuration#toc4):
|
|
|
+[Set max_prepared_transactions to 100](https://documentation.bonitasoft.com/bonita/7.7/database-configuration#toc5):
|
|
|
|
|
|
mkdir -p custom_postgres
|
|
|
echo '#!/bin/bash' > custom_postgres/bonita.sh
|
|
|
@@ -96,7 +96,7 @@ $ docker run --name bonita_postgres --link mydbpostgres:postgres -d -p 8080:8080
|
|
|
|
|
|
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](https://documentation.bonitasoft.com/bonita/7.6/database-configuration#toc4) which is set by default to 1M:
|
|
|
+[Increase the packet size](https://documentation.bonitasoft.com/bonita/7.7/database-configuration#toc5) which is set by default to 1M:
|
|
|
|
|
|
mkdir -p custom_mysql
|
|
|
echo "[mysqld]" > custom_mysql/bonita.cnf
|
|
|
@@ -264,9 +264,9 @@ $ chcon -Rt svirt_sandbox_file_t /my/own/datadir
|
|
|
|
|
|
```console
|
|
|
cd bonita_migration
|
|
|
- wget https://download.forge.ow2.org/bonita/bonita-migration-distrib-2.29.0.zip
|
|
|
+ wget https://release.ow2.org/bonita/bonita-migration-distrib-2.31.1.zip
|
|
|
wget https://download.forge.ow2.org/bonita/BonitaBPMCommunity-7.2.4-Tomcat-7.0.67.zip
|
|
|
- unzip bonita-migration-distrib-2.29.0.zip
|
|
|
+ unzip bonita-migration-distrib-2.31.1.zip
|
|
|
unzip BonitaBPMCommunity-7.2.4-Tomcat-7.0.67.zip
|
|
|
```
|
|
|
|
|
|
@@ -281,13 +281,13 @@ $ chcon -Rt svirt_sandbox_file_t /my/own/datadir
|
|
|
|
|
|
```console
|
|
|
cd bonita_migration
|
|
|
- wget https://download.forge.ow2.org/bonita/bonita-migration-distrib-2.29.0.zip
|
|
|
- unzip bonita-migration-distrib-2.29.0.zip
|
|
|
+ wget https://release.ow2.org/bonita/bonita-migration-distrib-2.31.1.zip
|
|
|
+ unzip bonita-migration-distrib-2.31.1.zip
|
|
|
```
|
|
|
|
|
|
- Configure the migration tool
|
|
|
|
|
|
- cd bonita-migration-distrib-2.29.0
|
|
|
+ cd bonita-migration-distrib-2.31.1
|
|
|
|
|
|
edit the migration tool config to point towards the copy of bonita home and db
|
|
|
|
|
|
@@ -319,17 +319,17 @@ $ chcon -Rt svirt_sandbox_file_t /my/own/datadir
|
|
|
- If >= 7.3.0
|
|
|
|
|
|
```console
|
|
|
- $ docker run --name=bonita_7.5.4_postgres --link mydbpostgres:postgres -e "DB_NAME=newbonitadb" -e "DB_USER=newbonitauser" -e "DB_PASS=newbonitapass" -d -p 8081:8080 bonita:7.5.4
|
|
|
+ $ docker run --name=bonita_7.7.1_postgres --link mydbpostgres:postgres -e "DB_NAME=newbonitadb" -e "DB_USER=newbonitauser" -e "DB_PASS=newbonitapass" -d -p 8081:8080 bonita:7.7.1
|
|
|
```
|
|
|
|
|
|
- Reapply specific configuration if needed, for example with a version >= 7.3.0 :
|
|
|
|
|
|
```console
|
|
|
- $ docker exec -ti bonita_7.5.4_postgres /bin/bash
|
|
|
+ $ docker exec -ti bonita_7.7.1_postgres /bin/bash
|
|
|
```
|
|
|
|
|
|
```console
|
|
|
- $ cd /opt/bonita/BonitaCommunity-7.6.3-Tomcat-8.5.23/setup
|
|
|
+ $ cd /opt/bonita/BonitaCommunity-7.7.1-Tomcat-8.5.31/setup
|
|
|
$ ./setup.sh pull
|
|
|
$ TENANT_LOGIN=tech_user
|
|
|
$ TENANT_PASSWORD=secret
|
|
|
@@ -349,10 +349,10 @@ $ chcon -Rt svirt_sandbox_file_t /my/own/datadir
|
|
|
```
|
|
|
|
|
|
```console
|
|
|
- $ docker restart bonita_7.5.4_postgres
|
|
|
+ $ docker restart bonita_7.7.1_postgres
|
|
|
```
|
|
|
|
|
|
-For more details regarding Bonita migration, see the [documentation](https://documentation.bonitasoft.com/bonita/7.6/migrate-from-an-earlier-version-of-bonita-bpm).
|
|
|
+For more details regarding Bonita migration, see the [documentation](https://documentation.bonitasoft.com/bonita/7.7/migrate-from-an-earlier-version-of-bonita-bpm).
|
|
|
|
|
|
## Security
|
|
|
|
|
|
@@ -360,11 +360,11 @@ This Docker image activates both static and dynamic authorization checks by defa
|
|
|
|
|
|
- REST API authorization
|
|
|
|
|
|
- - [Static authorization checking](https://documentation.bonitasoft.com/bonita/7.6/rest-api-authorization#toc1)
|
|
|
+ - [Static authorization checking](https://documentation.bonitasoft.com/bonita/7.7/rest-api-authorization#toc1)
|
|
|
|
|
|
- - [Dynamic authorization checking](https://documentation.bonitasoft.com/bonita/7.6/rest-api-authorization#toc2)
|
|
|
+ - [Dynamic authorization checking](https://documentation.bonitasoft.com/bonita/7.7/rest-api-authorization#toc2)
|
|
|
|
|
|
-- [HTTP API](https://documentation.bonitasoft.com/bonita/7.6/rest-api-authorization#toc9)
|
|
|
+- [HTTP API](https://documentation.bonitasoft.com/bonita/7.7/rest-api-authorization#toc10)
|
|
|
|
|
|
For specific needs you can override this behavior by setting HTTP_API to true and REST_API_DYN_AUTH_CHECKS to false:
|
|
|
|
|
|
@@ -378,7 +378,7 @@ When you start the `bonita` image, you can adjust the configuration of the Bonit
|
|
|
|
|
|
### `PLATFORM_PASSWORD`
|
|
|
|
|
|
-This environment variable [is recommended](https://documentation.bonitasoft.com/bonita/7.6/tomcat-bundle#toc3) for you to use the Bonita image. It sets the platform administrator password for Bonita. If it is not specified, the default password `platform` will be used.
|
|
|
+This environment variable [is recommended](https://documentation.bonitasoft.com/bonita/7.7/tomcat-bundle#toc3) for you to use the Bonita image. It sets the platform administrator password for Bonita. If it is not specified, the default password `platform` will be used.
|
|
|
|
|
|
### `PLATFORM_LOGIN`
|
|
|
|
|
|
@@ -386,7 +386,7 @@ This optional environment variable is used in conjunction with `PLATFORM_PASSWOR
|
|
|
|
|
|
### `TENANT_PASSWORD`
|
|
|
|
|
|
-This environment variable [is recommended](https://documentation.bonitasoft.com/bonita/7.6/tomcat-bundle#toc3) for you to use the Bonita image. It sets the tenant administrator password for Bonita. If it is not specified, the default password `install` will be used.
|
|
|
+This environment variable [is recommended](https://documentation.bonitasoft.com/bonita/7.7/tomcat-bundle#toc3) for you to use the Bonita image. It sets the tenant administrator password for Bonita. If it is not specified, the default password `install` will be used.
|
|
|
|
|
|
### `TENANT_LOGIN`
|
|
|
|
|
|
@@ -394,7 +394,7 @@ This optional environment variable is used in conjunction with `TENANT_PASSWORD`
|
|
|
|
|
|
### `REST_API_DYN_AUTH_CHECKS`
|
|
|
|
|
|
-This optional environment variable is used to enable/disable [dynamic authorization checking](https://documentation.bonitasoft.com/bonita/7.6/rest-api-authorization#toc2) on Bonita REST API. The default value is `true`, which will activate dynamic authorization checking.
|
|
|
+This optional environment variable is used to enable/disable [dynamic authorization checking](https://documentation.bonitasoft.com/bonita/7.7/rest-api-authorization#toc2) on Bonita REST API. The default value is `true`, which will activate dynamic authorization checking.
|
|
|
|
|
|
### `HTTP_API`
|
|
|
|
|
|
@@ -428,7 +428,7 @@ These variables are used in conjunction to create a new user, set that user's pa
|
|
|
|
|
|
### `BIZ_DB_NAME`, `BIZ_DB_USER`, `BIZ_DB_PASS`
|
|
|
|
|
|
-These variables are used in conjunction to create a new user, set that user's password and create the `bonita` [business database](https://documentation.bonitasoft.com/bonita/7.6/define-and-deploy-the-bdm#toc1).
|
|
|
+These variables are used in conjunction to create a new user, set that user's password and create the `bonita` [business database](https://documentation.bonitasoft.com/bonita/7.7/define-and-deploy-the-bdm#toc1).
|
|
|
|
|
|
`BIZ_DB_NAME` default value is `businessdb`.
|
|
|
|
|
|
@@ -460,7 +460,7 @@ For example, you can increase the log level :
|
|
|
|
|
|
mkdir -p custom_bonita
|
|
|
echo '#!/bin/bash' > custom_bonita/bonita.sh
|
|
|
- echo 'sed -i "s/^org.bonitasoft.level = WARNING$/org.bonitasoft.level = FINEST/" /opt/bonita/BonitaCommunity-7.6.3-Tomcat-8.5.23/server/conf/logging.properties' >> custom_bonita/bonita.sh
|
|
|
+ echo 'sed -i "s/^org.bonitasoft.level = WARNING$/org.bonitasoft.level = FINEST/" /opt/bonita/BonitaCommunity-7.7.1-Tomcat-8.5.31/server/conf/logging.properties' >> custom_bonita/bonita.sh
|
|
|
chmod +x custom_bonita/bonita.sh
|
|
|
|
|
|
docker run --name bonita_custom -v "$PWD"/custom_bonita/:/opt/custom-init.d -d -p 8080:8080 bonita
|
|
|
@@ -469,7 +469,7 @@ Note: There are several ways to check the `bonita` logs. One of them is
|
|
|
|
|
|
```console
|
|
|
$ docker exec -ti bonita_custom /bin/bash
|
|
|
-tail -f /opt/bonita/BonitaCommunity-7.6.3-Tomcat-8.5.23/server/logs/bonita.`date +%Y-%m-%d`.log
|
|
|
+tail -f /opt/bonita/BonitaCommunity-7.7.1-Tomcat-8.5.31/server/logs/bonita.`date +%Y-%m-%d`.log
|
|
|
```
|
|
|
|
|
|
# License
|
Docker Library Bot