Skip to content

Commit b56752a

Browse files
Update Bonita and Migration Tool versions (#2039)
* Update Bonita and Migration Tool versions * Remove reference to MaxPermSize Co-authored-by: Emmanuel Duchastenier <emmanuel.duchastenier@bonitasoft.com>
1 parent a8d4739 commit b56752a

File tree

1 file changed

+24
-24
lines changed

1 file changed

+24
-24
lines changed

bonita/content.md

Lines changed: 24 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ Bonita (called Bonita BPM till 7.5) is an open-source business process managemen
1414
$ docker run --name bonita -d -p 8080:8080 %%IMAGE%%
1515
```
1616

17-
This will start a container running [Bonita runtime](https://documentation.bonitasoft.com/bonita/2021.1/tomcat-bundle): a Tomcat bundle with Bonita Engine + Bonita Portal. With no environment variables specified, it's as 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.
17+
This will start a container running [Bonita runtime](https://documentation.bonitasoft.com/bonita/2021.2/tomcat-bundle): a Tomcat bundle with Bonita Engine + Bonita Portal. With no environment variables specified, it's as 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.
1818

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

@@ -24,7 +24,7 @@ You can access the Bonita Portal on http://localhost:8080/bonita and login using
2424

2525
PostgreSQL is the recommended database.
2626

27-
[Set max_prepared_transactions to 100](https://documentation.bonitasoft.com/bonita/2021.1/database-configuration#_postgresql):
27+
[Set max_prepared_transactions to 100](https://documentation.bonitasoft.com/bonita/2021.2/database-configuration#_postgresql):
2828

2929
```console
3030
$ mkdir -p custom_postgres
@@ -49,7 +49,7 @@ $ docker run --name bonita_postgres --link mydbpostgres:postgres -d -p 8080:8080
4949

5050
There are known issues with the management of XA transactions by MySQL engine and driver: see MySQL bug [17343](http://bugs.mysql.com/bug.php?id=17343)
5151

52-
[Increase the packet size](https://documentation.bonitasoft.com/bonita/2021.1/database-configuration#_maximum_packet_size) which is set by default to 1M:
52+
[Increase the packet size](https://documentation.bonitasoft.com/bonita/2021.2/database-configuration#_maximum_packet_size) which is set by default to 1M:
5353

5454
```console
5555
$ mkdir -p custom_mysql
@@ -167,9 +167,9 @@ The `-v /my/own/datadir:/opt/bonita` part of the command mounts the `/my/own/dat
167167

168168
```console
169169
cd bonita_migration
170-
wget https://github.com/bonitasoft/bonita-platform-releases/releases/download/2021.1/bonita-migration-distrib-2.54.0.zip
170+
wget https://github.com/bonitasoft/bonita-platform-releases/releases/download/2021.2-u0/bonita-migration-distrib-2.55.0.zip
171171
wget https://download.forge.ow2.org/bonita/BonitaBPMCommunity-7.2.4-Tomcat-7.0.67.zip
172-
unzip bonita-migration-distrib-2.54.0.zip
172+
unzip bonita-migration-distrib-2.55.0.zip
173173
unzip BonitaBPMCommunity-7.2.4-Tomcat-7.0.67.zip
174174
```
175175

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

185185
```console
186186
cd bonita_migration
187-
wget https://github.com/bonitasoft/bonita-platform-releases/releases/download/2021.1/bonita-migration-distrib-2.54.0.zip
188-
unzip bonita-migration-distrib-2.54.0.zip
187+
wget https://github.com/bonitasoft/bonita-platform-releases/releases/download/2021.2-u0/bonita-migration-distrib-2.55.0.zip
188+
unzip bonita-migration-distrib-2.55.0.zip
189189
```
190190

191191
- Configure the migration tool
192192

193193
```console
194-
$ cd bonita-migration-distrib-2.54.0
194+
$ cd bonita-migration-distrib-2.55.0
195195
```
196196

197197
edit the migration tool config to point towards the copy of bonita home and db
@@ -222,23 +222,23 @@ The `-v /my/own/datadir:/opt/bonita` part of the command mounts the `/my/own/dat
222222
- If < 7.3.0
223223

224224
```console
225-
$ docker run --name=bonita_7.2.4_postgres --link mydbpostgres:postgres -e "DB_NAME=newbonitadb" -e "DB_USER=newbonitauser" -e "DB_PASS=newbonitapass" -v "$PWD"/bonita_migration:/opt/bonita/ -d -p 8081:8080 %%IMAGE%%:7.2.4
225+
$ docker run --name=bonita_postgres --link mydbpostgres:postgres -e "DB_NAME=newbonitadb" -e "DB_USER=newbonitauser" -e "DB_PASS=newbonitapass" -v "$PWD"/bonita_migration:/opt/bonita/ -d -p 8081:8080 %%IMAGE%%:7.2.4
226226
```
227227

228228
- If >= 7.3.0
229229

230230
```console
231-
$ docker run --name=bonita_7.12.1_postgres --link mydbpostgres:postgres -e "DB_NAME=newbonitadb" -e "DB_USER=newbonitauser" -e "DB_PASS=newbonitapass" -d -p 8081:8080 %%IMAGE%%:7.12.1
231+
$ docker run --name=bonita_postgres --link mydbpostgres:postgres -e "DB_NAME=newbonitadb" -e "DB_USER=newbonitauser" -e "DB_PASS=newbonitapass" -d -p 8081:8080 %%IMAGE%%:2021.2-u0
232232
```
233233

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

236236
```console
237-
$ docker exec -ti bonita_7.12.1_postgres /bin/bash
237+
$ docker exec -ti bonita_postgres /bin/bash
238238
```
239239

240240
```console
241-
$ cd /opt/bonita/BonitaCommunity-2021.1/setup
241+
$ cd /opt/bonita/BonitaCommunity-2021.2-u0/setup
242242
$ ./setup.sh pull
243243
$ TENANT_LOGIN=tech_user
244244
$ TENANT_PASSWORD=secret
@@ -258,26 +258,26 @@ The `-v /my/own/datadir:/opt/bonita` part of the command mounts the `/my/own/dat
258258
```
259259

260260
```console
261-
$ docker restart bonita_7.12.1_postgres
261+
$ docker restart bonita_postgres
262262
```
263263

264264
- Specific consideration regarding migration to Java 11 in Bonita 7.9
265265

266266
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.
267267

268-
For more details regarding Bonita migration, see the [documentation](https://documentation.bonitasoft.com/bonita/2021.1/migrate-from-an-earlier-version-of-bonita-bpm).
268+
For more details regarding Bonita migration, see the [documentation](https://documentation.bonitasoft.com/bonita/2021.2/migrate-from-an-earlier-version-of-bonita-bpm).
269269

270270
## Security
271271

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

274274
- REST API authorization
275275

276-
- [Static authorization checking](https://documentation.bonitasoft.com/bonita/2021.1/rest-api-authorization#static_authorization)
276+
- [Static authorization checking](https://documentation.bonitasoft.com/bonita/2021.2/rest-api-authorization#static_authorization)
277277

278-
- [Dynamic authorization checking](https://documentation.bonitasoft.com/bonita/2021.1/rest-api-authorization#dynamic_authorization)
278+
- [Dynamic authorization checking](https://documentation.bonitasoft.com/bonita/2021.2/rest-api-authorization#dynamic_authorization)
279279

280-
- [HTTP API](https://documentation.bonitasoft.com/bonita/2021.1/rest-api-authorization#_activating_and_deactivating_authorization)
280+
- [HTTP API](https://documentation.bonitasoft.com/bonita/2021.2/rest-api-authorization#_activating_and_deactivating_authorization)
281281

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

@@ -291,31 +291,31 @@ When you start the `bonita` image, you can adjust the configuration of the Bonit
291291

292292
### `PLATFORM_PASSWORD`
293293

294-
This environment variable [is recommended](https://documentation.bonitasoft.com/bonita/2021.1/tomcat-bundle#_platform_administrator) 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.
294+
This environment variable [is recommended](https://documentation.bonitasoft.com/bonita/2021.2/tomcat-bundle#_platform_administrator) 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.
295295

296296
### `PLATFORM_LOGIN`
297297

298298
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.
299299

300300
### `TENANT_PASSWORD`
301301

302-
This environment variable [is recommended](https://documentation.bonitasoft.com/bonita/2021.1/tomcat-bundle#_tenant_administrator) 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.
302+
This environment variable [is recommended](https://documentation.bonitasoft.com/bonita/2021.2/tomcat-bundle#_tenant_administrator) 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.
303303

304304
### `TENANT_LOGIN`
305305

306306
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.
307307

308308
### `REST_API_DYN_AUTH_CHECKS`
309309

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

312312
### `HTTP_API`
313313

314314
This optional environment variable is used to enable/disable the Bonita HTTP API. The default value is `false`, which will deactivate the HTTP API.
315315

316316
### `JAVA_OPTS`
317317

318-
This optional environment variable is used to customize JAVA_OPTS. The default value is `-Xms1024m -Xmx1024m -XX:MaxPermSize=256m`.
318+
This optional environment variable is used to customize JAVA_OPTS. The default value is `-Xms1024m -Xmx1024m`.
319319

320320
### `ENSURE_DB_CHECK_AND_CREATION`
321321

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

342342
### `BIZ_DB_NAME`, `BIZ_DB_USER`, `BIZ_DB_PASS`
343343

344-
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/2021.1/define-and-deploy-the-bdm#_business_data_model_bdm).
344+
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/2021.2/define-and-deploy-the-bdm#_business_data_model_bdm).
345345

346346
`BIZ_DB_NAME` default value is `businessdb`.
347347

@@ -382,7 +382,7 @@ For example, you can increase the log level :
382382
```console
383383
$ mkdir -p custom_bonita
384384
$ echo '#!/bin/bash' > custom_bonita/bonita.sh
385-
$ echo 'sed -i "s/^org.bonitasoft.level = WARNING$/org.bonitasoft.level = FINEST/" /opt/bonita/BonitaCommunity-2021.1/server/conf/logging.properties' >> custom_bonita/bonita.sh
385+
$ echo 'sed -i "s/^org.bonitasoft.level = WARNING$/org.bonitasoft.level = FINEST/" /opt/bonita/BonitaCommunity-2021.2-u0/server/conf/logging.properties' >> custom_bonita/bonita.sh
386386
$ chmod +x custom_bonita/bonita.sh
387387

388388
$ docker run --name bonita_custom -v "$PWD"/custom_bonita/:/opt/custom-init.d -d -p 8080:8080 %%IMAGE%%
@@ -400,7 +400,7 @@ Note: There are several ways to check the `bonita` logs. Till Bonita 7.8, one of
400400

401401
```console
402402
$ docker exec -ti bonita_custom /bin/bash
403-
tail -f /opt/bonita/BonitaCommunity-2021.1/server/logs/bonita.`date +%Y-%m-%d`.log
403+
tail -f /opt/bonita/BonitaCommunity-2021.2-u0/server/logs/bonita.`date +%Y-%m-%d`.log
404404
```
405405

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

0 commit comments

Comments
 (0)