|
|
@@ -47,13 +47,13 @@ WARNING:
|
|
|
- **Supported Docker versions**:
|
|
|
[the latest release](https://github.com/docker/docker-ce/releases/latest) (down to 1.6 on a best-effort basis)
|
|
|
|
|
|
-# What is Bonita BPM?
|
|
|
+# What is Bonita?
|
|
|
|
|
|
-Bonita BPM is an open-source business process management and workflow suite created in 2001. It was started in France National Institute for Research in Computer Science, and then had incubated several years inside of the French computer science company Groupe Bull. Since 2009, the development of Bonita is supported by a company dedicated to this activity: Bonitasoft.
|
|
|
+Bonita (called Bonita BPM till 7.5) is an open-source business process management and workflow suite created in 2001. It was started in France National Institute for Research in Computer Science, and then had incubated several years inside of the French computer science company Groupe Bull. Since 2009, the development of Bonita is supported by a company dedicated to this activity: Bonitasoft.
|
|
|
|
|
|
> [wikipedia.org/wiki/Bonita_BPM](http://en.wikipedia.org/wiki/Bonita_BPM)
|
|
|
|
|
|
-
|
|
|
+
|
|
|
|
|
|
# How to use this image
|
|
|
|
|
|
@@ -63,17 +63,17 @@ Bonita BPM is an open-source business process management and workflow suite crea
|
|
|
$ docker run --name bonita -d -p 8080:8080 bonita
|
|
|
```
|
|
|
|
|
|
-This will start a container running the [Tomcat Bundle](http://documentation.bonitasoft.com/?page=tomcat-bundle) with Bonita BPM Engine + Bonita BPM 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 BPM uses a H2 database here.
|
|
|
+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.
|
|
|
|
|
|
-You can access the Bonita BPM Portal on http://localhost:8080/bonita and login using the default credentials: install / install
|
|
|
+You can access the Bonita Portal on http://localhost:8080/bonita and login using the default credentials: install / install
|
|
|
|
|
|
-## Link Bonita BPM to a database
|
|
|
+## Link Bonita to a database
|
|
|
|
|
|
### PostgreSQL
|
|
|
|
|
|
PostgreSQL is the recommanded database.
|
|
|
|
|
|
-[Set max_prepared_transactions to 100](http://documentation.bonitasoft.com/?page=database-configuration#toc4):
|
|
|
+[Set max_prepared_transactions to 100](https://documentation.bonitasoft.com/bonita/7.6/database-configuration#toc4):
|
|
|
|
|
|
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](http://documentation.bonitasoft.com/?page=database-configuration#toc4) which is set by default to 1M:
|
|
|
+[Increase the packet size](https://documentation.bonitasoft.com/bonita/7.6/database-configuration#toc4) which is set by default to 1M:
|
|
|
|
|
|
mkdir -p custom_mysql
|
|
|
echo "[mysqld]" > custom_mysql/bonita.cnf
|
|
|
@@ -122,7 +122,7 @@ $ docker run --name bonita_mysql --link mydbmysql:mysql -d -p 8080:8080 bonita
|
|
|
$ 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
|
|
|
```
|
|
|
|
|
|
-Now you can access the Bonita BPM Portal on localhost:8080/bonita and login using: tech_user / secret
|
|
|
+Now you can access the Bonita Portal on localhost:8080/bonita and login using: tech_user / secret
|
|
|
|
|
|
## ... via [`docker stack deploy`](https://docs.docker.com/engine/reference/commandline/stack_deploy/) or [`docker-compose`](https://github.com/docker/compose)
|
|
|
|
|
|
@@ -203,7 +203,7 @@ Note that users on host systems with SELinux enabled may see issues with this. T
|
|
|
$ chcon -Rt svirt_sandbox_file_t /my/own/datadir
|
|
|
```
|
|
|
|
|
|
-## Migrate from an earlier version of Bonita BPM
|
|
|
+## Migrate from an earlier version of Bonita
|
|
|
|
|
|
- Stop the container to perform a backup
|
|
|
|
|
|
@@ -263,9 +263,9 @@ $ chcon -Rt svirt_sandbox_file_t /my/own/datadir
|
|
|
|
|
|
```console
|
|
|
cd bonita_migration
|
|
|
- wget http://download.forge.ow2.org/bonita/bonita-migration-distrib-2.25.0.zip
|
|
|
- wget http://download.forge.ow2.org/bonita/BonitaBPMCommunity-7.2.4-Tomcat-7.0.67.zip
|
|
|
- unzip bonita-migration-distrib-2.25.0.zip
|
|
|
+ wget https://download.forge.ow2.org/bonita/bonita-migration-distrib-2.26.0.zip
|
|
|
+ wget https://download.forge.ow2.org/bonita/BonitaBPMCommunity-7.2.4-Tomcat-7.0.67.zip
|
|
|
+ unzip bonita-migration-distrib-2.26.0.zip
|
|
|
unzip BonitaBPMCommunity-7.2.4-Tomcat-7.0.67.zip
|
|
|
```
|
|
|
|
|
|
@@ -280,13 +280,13 @@ $ chcon -Rt svirt_sandbox_file_t /my/own/datadir
|
|
|
|
|
|
```console
|
|
|
cd bonita_migration
|
|
|
- wget http://download.forge.ow2.org/bonita/bonita-migration-distrib-2.25.0.zip
|
|
|
- unzip bonita-migration-distrib-2.25.0.zip
|
|
|
+ wget https://download.forge.ow2.org/bonita/bonita-migration-distrib-2.26.0.zip
|
|
|
+ unzip bonita-migration-distrib-2.26.0.zip
|
|
|
```
|
|
|
|
|
|
- Configure the migration tool
|
|
|
|
|
|
- cd bonita-migration-distrib-2.25.0
|
|
|
+ cd bonita-migration-distrib-2.26.0
|
|
|
|
|
|
edit the migration tool config to point towards the copy of bonita home and db
|
|
|
|
|
|
@@ -328,7 +328,7 @@ $ chcon -Rt svirt_sandbox_file_t /my/own/datadir
|
|
|
```
|
|
|
|
|
|
```console
|
|
|
- $ cd /opt/bonita/BonitaBPMCommunity-7.5.4-Tomcat-7.0.76/setup
|
|
|
+ $ cd /opt/bonita/BonitaCommunity-7.6.0-Tomcat-8.5.23/setup
|
|
|
$ ./setup.sh pull
|
|
|
$ TENANT_LOGIN=tech_user
|
|
|
$ TENANT_PASSWORD=secret
|
|
|
@@ -351,7 +351,7 @@ $ chcon -Rt svirt_sandbox_file_t /my/own/datadir
|
|
|
$ docker restart bonita_7.5.4_postgres
|
|
|
```
|
|
|
|
|
|
-For more details regarding Bonita migration, see the [documentation](http://documentation.bonitasoft.com/?page=migrate-from-an-earlier-version-of-bonita-bpm).
|
|
|
+For more details regarding Bonita migration, see the [documentation](https://documentation.bonitasoft.com/bonita/7.6/migrate-from-an-earlier-version-of-bonita-bpm).
|
|
|
|
|
|
## Security
|
|
|
|
|
|
@@ -359,11 +359,11 @@ This Docker image activates both static and dynamic authorization checks by defa
|
|
|
|
|
|
- REST API authorization
|
|
|
|
|
|
- - [Static authorization checking](http://documentation.bonitasoft.com/?page=rest-api-authorization#toc1)
|
|
|
+ - [Static authorization checking](https://documentation.bonitasoft.com/bonita/7.6/rest-api-authorization#toc1)
|
|
|
|
|
|
- - [Dynamic authorization checking](http://documentation.bonitasoft.com/?page=rest-api-authorization#toc2)
|
|
|
+ - [Dynamic authorization checking](https://documentation.bonitasoft.com/bonita/7.6/rest-api-authorization#toc2)
|
|
|
|
|
|
-- [HTTP API](http://documentation.bonitasoft.com/?page=rest-api-authorization#toc9)
|
|
|
+- [HTTP API](https://documentation.bonitasoft.com/bonita/7.6/rest-api-authorization#toc9)
|
|
|
|
|
|
For specific needs you can override this behavior by setting HTTP_API to true and REST_API_DYN_AUTH_CHECKS to false:
|
|
|
|
|
|
@@ -377,7 +377,7 @@ When you start the `bonita` image, you can adjust the configuration of the Bonit
|
|
|
|
|
|
### `PLATFORM_PASSWORD`
|
|
|
|
|
|
-This environment variable [is recommended](http://documentation.bonitasoft.com/?page=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.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.
|
|
|
|
|
|
### `PLATFORM_LOGIN`
|
|
|
|
|
|
@@ -385,7 +385,7 @@ This optional environment variable is used in conjunction with `PLATFORM_PASSWOR
|
|
|
|
|
|
### `TENANT_PASSWORD`
|
|
|
|
|
|
-This environment variable [is recommended](http://documentation.bonitasoft.com/?page=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.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.
|
|
|
|
|
|
### `TENANT_LOGIN`
|
|
|
|
|
|
@@ -393,7 +393,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](http://documentation.bonitasoft.com/?page=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.6/rest-api-authorization#toc2) on Bonita REST API. The default value is `true`, which will activate dynamic authorization checking.
|
|
|
|
|
|
### `HTTP_API`
|
|
|
|
|
|
@@ -427,7 +427,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](http://documentation.bonitasoft.com/?page=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.6/define-and-deploy-the-bdm#toc1).
|
|
|
|
|
|
`BIZ_DB_NAME` default value is `businessdb`.
|
|
|
|
|
|
@@ -459,7 +459,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/BonitaBPMCommunity-7.5.4-Tomcat-7.0.76/server/conf/logging.properties' >> custom_bonita/bonita.sh
|
|
|
+ echo 'sed -i "s/^org.bonitasoft.level = WARNING$/org.bonitasoft.level = FINEST/" /opt/bonita/BonitaCommunity-7.6.0-Tomcat-8.5.23/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
|
|
|
@@ -468,16 +468,16 @@ 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/BonitaBPMCommunity-7.5.4-Tomcat-7.0.76/server/logs/bonita.`date +%Y-%m-%d`.log
|
|
|
+tail -f /opt/bonita/BonitaCommunity-7.6.0-Tomcat-8.5.23/server/logs/bonita.`date +%Y-%m-%d`.log
|
|
|
```
|
|
|
|
|
|
# License
|
|
|
|
|
|
-Bonita BPM image includes two parts :
|
|
|
+Bonita image includes two parts :
|
|
|
|
|
|
-- Bonita BPM Engine under [LGPL v2.1](https://www.gnu.org/licenses/old-licenses/lgpl-2.1.html)
|
|
|
+- Bonita Engine under [LGPL v2.1](https://www.gnu.org/licenses/old-licenses/lgpl-2.1.html)
|
|
|
|
|
|
-- Bonita BPM Portal under [GPL v2.0](http://www.gnu.org/licenses/old-licenses/gpl-2.0.html)
|
|
|
+- Bonita Portal under [GPL v2.0](http://www.gnu.org/licenses/old-licenses/gpl-2.0.html)
|
|
|
|
|
|
As with all Docker images, these likely also contain other software which may be under other licenses (such as Bash, etc from the base distribution, along with any direct or indirect dependencies of the primary software being contained).
|
|
|
|
Docker Library Bot