Skip to content

Commit aa90e31

Browse files
authored
Merge pull request #1 from Bonitasoft-Community/update_doc_for_7.9
update content for 7.9
2 parents 19c9632 + 1b3e025 commit aa90e31

File tree

1 file changed

+31
-5
lines changed

1 file changed

+31
-5
lines changed

bonita/content.md

Lines changed: 31 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -85,7 +85,7 @@ Run `docker stack deploy -c stack.yml %%REPO%%` (or `docker-compose -f stack.yml
8585

8686
## Where to store data
8787

88-
Most of the data are stored in a database and can be stored outside the Bonita container as described above using the PostgreSQL or MySQL container. However, some data remains inside the Bonita bundle. Bonita Home is a folder, called `bonita`, which contains configuration, working, and temporary folders and files. There are also log files inside the `logs` folder.
88+
Most of the data are stored in a database and can be stored outside the Bonita container as described above using the PostgreSQL or MySQL container. However, some data remains inside the Bonita bundle. Bonita Home is a folder, called `bonita`, which contains configuration, working, and temporary folders and files. There are also log files inside the `logs` folder till Bonita 7.8.
8989

9090
Important note: There are several ways to store data used by applications that run in Docker containers. We encourage users of the `%%REPO%%` images to familiarize themselves with the options available, including:
9191

@@ -238,7 +238,7 @@ The `-v /my/own/datadir:/opt/bonita` part of the command mounts the `/my/own/dat
238238
```
239239

240240
```console
241-
$ cd /opt/bonita/BonitaCommunity-7.9.0-Tomcat-8.5.34/setup
241+
$ cd /opt/bonita/BonitaCommunity-7.9.0-tomcat/setup
242242
$ ./setup.sh pull
243243
$ TENANT_LOGIN=tech_user
244244
$ TENANT_PASSWORD=secret
@@ -261,6 +261,10 @@ The `-v /my/own/datadir:/opt/bonita` part of the command mounts the `/my/own/dat
261261
$ docker restart bonita_7.9.0_postgres
262262
```
263263

264+
- Specific consideration regarding migration to Java 11 in Bonita 7.9
265+
266+
Bonita 7.9 docker image runs with Java 11. If you are migrating from an earlier version which runs Java 7.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 either not work in Java 11.
267+
264268
For more details regarding Bonita migration, see the [documentation](https://documentation.bonitasoft.com/bonita/7.9/migrate-from-an-earlier-version-of-bonita-bpm).
265269

266270
## Security
@@ -361,6 +365,14 @@ These variables are optional, and used in conjunction to create users and databa
361365

362366
`BIZ_DB_DROP_EXISTING` default value is `N`.
363367

368+
### `BONITA_SERVER_LOGGING_FILE`, `BONITA_SETUP_LOGGING_FILE`
369+
370+
Since Bonita 7.9 `BONITA_SERVER_LOGGING_FILE` and `BONITA_SETUP_LOGGING_FILE` can be used to update logging configuration.
371+
372+
`BONITA_SERVER_LOGGING_FILE` default value is `/opt/bonita/BonitaSubscription-${BONITA_VERSION}-tomcat/server/conf/logging.properties`.
373+
374+
`BONITA_SETUP_LOGGING_FILE` default value is `/opt/bonita/BonitaSubscription-${BONITA_VERSION}-tomcat/setup/logback.xml`.
375+
364376
# How to extend this image
365377

366378
If you would like to do additional initialization, you can add a `*.sh` script under `/opt/custom-init.d`. The `startup.sh` file will source any `*.sh` script found in this directory to do further initialization before starting the service.
@@ -370,15 +382,29 @@ For example, you can increase the log level :
370382
```console
371383
$ mkdir -p custom_bonita
372384
$ echo '#!/bin/bash' > custom_bonita/bonita.sh
373-
$ echo 'sed -i "s/^org.bonitasoft.level = WARNING$/org.bonitasoft.level = FINEST/" /opt/bonita/BonitaCommunity-7.9.0-Tomcat-8.5.34/server/conf/logging.properties' >> custom_bonita/bonita.sh
385+
$ 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
374386
$ chmod +x custom_bonita/bonita.sh
375387

376388
$ docker run --name bonita_custom -v "$PWD"/custom_bonita/:/opt/custom-init.d -d -p 8080:8080 %%IMAGE%%
377389
```
378390

379-
Note: There are several ways to check the `bonita` logs. One of them is
391+
Since Bonita 7.9 you can also apply a custom `logging.properties` file like this :
392+
393+
```console
394+
docker run --name bonita \
395+
-v /path/to/logging.properties:/etc/logging.properties -e BONITA_SERVER_LOGGING_FILE=/etc/logging.properties \
396+
-d -p 8080:8080 %%IMAGE%%
397+
```
398+
399+
Note: There are several ways to check the `bonita` logs. Till Bonita 7.8, one of them is
380400

381401
```console
382402
$ docker exec -ti bonita_custom /bin/bash
383-
tail -f /opt/bonita/BonitaCommunity-7.9.0-Tomcat-8.5.34/server/logs/bonita.`date +%Y-%m-%d`.log
403+
tail -f /opt/bonita/BonitaCommunity-7.8.4-Tomcat-8.5.34/server/logs/bonita.`date +%Y-%m-%d`.log
404+
```
405+
406+
Since Bonita 7.9 bonita logs are redirected towards standard output and directly accessible using
407+
408+
```console
409+
$ docker logs -f bonita
384410
```

0 commit comments

Comments
 (0)