Skip to content

Commit b1d90db

Browse files
Run update.sh
1 parent 54b0f40 commit b1d90db

File tree

1 file changed

+30
-30
lines changed

1 file changed

+30
-30
lines changed

bonita/README.md

+30-30
Original file line numberDiff line numberDiff line change
@@ -60,17 +60,17 @@ Bonita (called Bonita BPM till 7.5) is an open-source business process managemen
6060
$ docker run --name bonita -d -p 8080:8080 bonita
6161
```
6262

63-
This will start a container running the [Tomcat Bundle](https://documentation.bonitasoft.com/bonita/7.9/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.
63+
This will start a container running [Bonita runtime](https://documentation.bonitasoft.com/bonita/7.10/tomcat-bundle): a 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.
6464

6565
You can access the Bonita Portal on http://localhost:8080/bonita and login using the default credentials: install / install
6666

6767
## Link Bonita to a database
6868

6969
### PostgreSQL
7070

71-
PostgreSQL is the recommanded database.
71+
PostgreSQL is the recommended database.
7272

73-
[Set max_prepared_transactions to 100](https://documentation.bonitasoft.com/bonita/7.9/database-configuration#toc5):
73+
[Set max_prepared_transactions to 100](https://documentation.bonitasoft.com/bonita/7.10/database-configuration#toc5):
7474

7575
```console
7676
$ mkdir -p custom_postgres
@@ -82,7 +82,7 @@ $ chmod +x custom_postgres/bonita.sh
8282
Mount that directory location as /docker-entrypoint-initdb.d inside the PostgreSQL container:
8383

8484
```console
85-
$ docker run --name mydbpostgres -v "$PWD"/custom_postgres/:/docker-entrypoint-initdb.d -e POSTGRES_PASSWORD=mysecretpassword -d postgres:9.3
85+
$ docker run --name mydbpostgres -v "$PWD"/custom_postgres/:/docker-entrypoint-initdb.d -e POSTGRES_PASSWORD=mysecretpassword -d postgres:11
8686
```
8787

8888
See the [official PostgreSQL documentation](https://hub.docker.com/_/postgres/) for more details.
@@ -95,7 +95,7 @@ $ docker run --name bonita_postgres --link mydbpostgres:postgres -d -p 8080:8080
9595

9696
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.
9797

98-
[Increase the packet size](https://documentation.bonitasoft.com/bonita/7.9/database-configuration#toc5) which is set by default to 1M:
98+
[Increase the packet size](https://documentation.bonitasoft.com/bonita/7.10/database-configuration#toc5) which is set by default to 1M:
9999

100100
```console
101101
$ mkdir -p custom_mysql
@@ -106,7 +106,7 @@ $ echo "max_allowed_packet=16M" >> custom_mysql/bonita.cnf
106106
Mount that directory location as /etc/mysql/conf.d inside the MySQL container:
107107

108108
```console
109-
$ docker run --name mydbmysql -v "$PWD"/custom_mysql/:/etc/mysql/conf.d -e MYSQL_ROOT_PASSWORD=mysecretpassword -d mysql:5.5
109+
$ docker run --name mydbmysql -v "$PWD"/custom_mysql/:/etc/mysql/conf.d -e MYSQL_ROOT_PASSWORD=mysecretpassword -d mysql:8.0
110110
```
111111

112112
See the [official MySQL documentation](https://hub.docker.com/_/mysql/) for more details.
@@ -123,7 +123,7 @@ $ docker run --name bonita_mysql --link mydbmysql:mysql -d -p 8080:8080 bonita
123123
$ 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
124124
```
125125

126-
Now you can access the Bonita Portal on localhost:8080/bonita and login using: tech_user / secret
126+
Now you can access the Bonita Portal on localhost:8080/bonita and login using: `tech_user` / `secret`
127127

128128
## ... via [`docker stack deploy`](https://docs.docker.com/engine/reference/commandline/stack_deploy/) or [`docker-compose`](https://github.com/docker/compose)
129129

@@ -204,7 +204,7 @@ The `-v /my/own/datadir:/opt/bonita` part of the command mounts the `/my/own/dat
204204
- Stop the container to perform a backup
205205

206206
```console
207-
$ docker stop bonita_7.2.3_postgres
207+
$ docker stop bonita_7.9.4_postgres
208208
```
209209

210210
- For containers < 7.3.0 :
@@ -265,9 +265,9 @@ The `-v /my/own/datadir:/opt/bonita` part of the command mounts the `/my/own/dat
265265

266266
```console
267267
cd bonita_migration
268-
wget https://release.ow2.org/bonita/bonita-migration-distrib-2.45.0.zip
268+
wget https://release.ow2.org/bonita/bonita-migration-distrib-2.46.1.zip
269269
wget https://download.forge.ow2.org/bonita/BonitaBPMCommunity-7.2.4-Tomcat-7.0.67.zip
270-
unzip bonita-migration-distrib-2.45.0.zip
270+
unzip bonita-migration-distrib-2.46.1.zip
271271
unzip BonitaBPMCommunity-7.2.4-Tomcat-7.0.67.zip
272272
```
273273

@@ -282,14 +282,14 @@ The `-v /my/own/datadir:/opt/bonita` part of the command mounts the `/my/own/dat
282282

283283
```console
284284
cd bonita_migration
285-
wget https://release.ow2.org/bonita/bonita-migration-distrib-2.45.0.zip
286-
unzip bonita-migration-distrib-2.45.0.zip
285+
wget https://release.ow2.org/bonita/bonita-migration-distrib-2.46.1.zip
286+
unzip bonita-migration-distrib-2.46.1.zip
287287
```
288288

289289
- Configure the migration tool
290290

291291
```console
292-
$ cd bonita-migration-distrib-2.45.0
292+
$ cd bonita-migration-distrib-2.46.1
293293
```
294294

295295
edit the migration tool config to point towards the copy of bonita home and db
@@ -326,17 +326,17 @@ The `-v /my/own/datadir:/opt/bonita` part of the command mounts the `/my/own/dat
326326
- If >= 7.3.0
327327

328328
```console
329-
$ docker run --name=bonita_7.9.4_postgres --link mydbpostgres:postgres -e "DB_NAME=newbonitadb" -e "DB_USER=newbonitauser" -e "DB_PASS=newbonitapass" -d -p 8081:8080 bonita:7.9.4
329+
$ docker run --name=bonita_7.10.0_postgres --link mydbpostgres:postgres -e "DB_NAME=newbonitadb" -e "DB_USER=newbonitauser" -e "DB_PASS=newbonitapass" -d -p 8081:8080 bonita:7.10.0
330330
```
331331

332332
- Reapply specific configuration if needed, for example with a version >= 7.3.0 :
333333

334334
```console
335-
$ docker exec -ti bonita_7.9.4_postgres /bin/bash
335+
$ docker exec -ti bonita_7.10.0_postgres /bin/bash
336336
```
337337

338338
```console
339-
$ cd /opt/bonita/BonitaCommunity-7.9.4-tomcat/setup
339+
$ cd /opt/bonita/BonitaCommunity-7.10.0/setup
340340
$ ./setup.sh pull
341341
$ TENANT_LOGIN=tech_user
342342
$ TENANT_PASSWORD=secret
@@ -356,26 +356,26 @@ The `-v /my/own/datadir:/opt/bonita` part of the command mounts the `/my/own/dat
356356
```
357357

358358
```console
359-
$ docker restart bonita_7.9.4_postgres
359+
$ docker restart bonita_7.10.0_postgres
360360
```
361361

362362
- Specific consideration regarding migration to Java 11 in Bonita 7.9
363363

364364
Bonita 7.9 docker image runs with Java 11. If you are migrating from an earlier version which runs Java 8, you should validate on a test environment that your custom code is compatible. Aside from just code incompatibility, special attention has to be given to the dependencies of the custom code, as they might not work in Java 11.
365365

366-
For more details regarding Bonita migration, see the [documentation](https://documentation.bonitasoft.com/bonita/7.9/migrate-from-an-earlier-version-of-bonita-bpm).
366+
For more details regarding Bonita migration, see the [documentation](https://documentation.bonitasoft.com/bonita/7.10/migrate-from-an-earlier-version-of-bonita-bpm).
367367

368368
## Security
369369

370370
This Docker image activates both static and dynamic authorization checks by default on REST API. To be consistent, it also deactivates the HTTP API.
371371

372372
- REST API authorization
373373

374-
- [Static authorization checking](https://documentation.bonitasoft.com/bonita/7.9/rest-api-authorization#toc1)
374+
- [Static authorization checking](https://documentation.bonitasoft.com/bonita/7.10/rest-api-authorization#toc1)
375375

376-
- [Dynamic authorization checking](https://documentation.bonitasoft.com/bonita/7.9/rest-api-authorization#toc2)
376+
- [Dynamic authorization checking](https://documentation.bonitasoft.com/bonita/7.10/rest-api-authorization#toc2)
377377

378-
- [HTTP API](https://documentation.bonitasoft.com/bonita/7.9/rest-api-authorization#toc10)
378+
- [HTTP API](https://documentation.bonitasoft.com/bonita/7.10/rest-api-authorization#toc10)
379379

380380
For specific needs you can override this behavior by setting HTTP_API to true and REST_API_DYN_AUTH_CHECKS to false:
381381

@@ -389,23 +389,23 @@ When you start the `bonita` image, you can adjust the configuration of the Bonit
389389

390390
### `PLATFORM_PASSWORD`
391391

392-
This environment variable [is recommended](https://documentation.bonitasoft.com/bonita/7.9/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.
392+
This environment variable [is recommended](https://documentation.bonitasoft.com/bonita/7.10/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.
393393

394394
### `PLATFORM_LOGIN`
395395

396396
This optional environment variable is used in conjunction with `PLATFORM_PASSWORD` to define the username for the platform administrator. If it is not specified, the default user `platformAdmin` will be used.
397397

398398
### `TENANT_PASSWORD`
399399

400-
This environment variable [is recommended](https://documentation.bonitasoft.com/bonita/7.9/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.
400+
This environment variable [is recommended](https://documentation.bonitasoft.com/bonita/7.10/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.
401401

402402
### `TENANT_LOGIN`
403403

404404
This optional environment variable is used in conjunction with `TENANT_PASSWORD` to define the username for the tenant administrator. If it is not specified, the default user of `install` will be used.
405405

406-
### `REST_API_DYN_AUTH_CHECKS`
406+
### `REST_API_DYN_AUTH_CHECKS`
407407

408-
This optional environment variable is used to enable/disable [dynamic authorization checking](https://documentation.bonitasoft.com/bonita/7.9/rest-api-authorization#toc2) on Bonita REST API. The default value is `true`, which will activate dynamic authorization checking.
408+
This optional environment variable is used to enable/disable [dynamic authorization checking](https://documentation.bonitasoft.com/bonita/7.10/rest-api-authorization#toc2) on Bonita REST API. The default value is `true`, which will activate dynamic authorization checking.
409409

410410
### `HTTP_API`
411411

@@ -439,7 +439,7 @@ These variables are used in conjunction to create a new user, set that user's pa
439439

440440
### `BIZ_DB_NAME`, `BIZ_DB_USER`, `BIZ_DB_PASS`
441441

442-
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.9/define-and-deploy-the-bdm#toc1).
442+
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.10/define-and-deploy-the-bdm#toc1).
443443

444444
`BIZ_DB_NAME` default value is `businessdb`.
445445

@@ -467,9 +467,9 @@ These variables are optional, and used in conjunction to create users and databa
467467

468468
Since Bonita 7.9 `BONITA_SERVER_LOGGING_FILE` and `BONITA_SETUP_LOGGING_FILE` can be used to update logging configuration.
469469

470-
`BONITA_SERVER_LOGGING_FILE` default value is `/opt/bonita/BonitaSubscription-${BONITA_VERSION}-tomcat/server/conf/logging.properties`.
470+
`BONITA_SERVER_LOGGING_FILE` default value is `/opt/bonita/BonitaSubscription-${BONITA_VERSION}/server/conf/logging.properties`.
471471

472-
`BONITA_SETUP_LOGGING_FILE` default value is `/opt/bonita/BonitaSubscription-${BONITA_VERSION}-tomcat/setup/logback.xml`.
472+
`BONITA_SETUP_LOGGING_FILE` default value is `/opt/bonita/BonitaSubscription-${BONITA_VERSION}/setup/logback.xml`.
473473

474474
# How to extend this image
475475

@@ -480,7 +480,7 @@ For example, you can increase the log level :
480480
```console
481481
$ mkdir -p custom_bonita
482482
$ echo '#!/bin/bash' > custom_bonita/bonita.sh
483-
$ echo 'sed -i "s/^org.bonitasoft.level = WARNING$/org.bonitasoft.level = FINEST/" /opt/bonita/BonitaCommunity-7.8.4-Tomcat-8.5.34/server/conf/logging.properties' >> custom_bonita/bonita.sh
483+
$ echo 'sed -i "s/^org.bonitasoft.level = WARNING$/org.bonitasoft.level = FINEST/" /opt/bonita/BonitaCommunity-7.10.0/server/conf/logging.properties' >> custom_bonita/bonita.sh
484484
$ chmod +x custom_bonita/bonita.sh
485485
486486
$ docker run --name bonita_custom -v "$PWD"/custom_bonita/:/opt/custom-init.d -d -p 8080:8080 bonita
@@ -498,7 +498,7 @@ Note: There are several ways to check the `bonita` logs. Till Bonita 7.8, one of
498498

499499
```console
500500
$ docker exec -ti bonita_custom /bin/bash
501-
tail -f /opt/bonita/BonitaCommunity-7.8.4-Tomcat-8.5.34/server/logs/bonita.`date +%Y-%m-%d`.log
501+
tail -f /opt/bonita/BonitaCommunity-7.10.0/server/logs/bonita.`date +%Y-%m-%d`.log
502502
```
503503

504504
Since Bonita 7.9 bonita logs are redirected towards standard output and directly accessible using

0 commit comments

Comments
 (0)