|
@@ -31,10 +31,10 @@ From Bonita 2022.1 onwards, the Bonita docker image does not include configurati
|
|
|
Therefore the PostgreSQL container needs to be configured to work with Bonita before starting the Bonita container. The configuration of a PostgreSQL database to work with Bonita is described in details in the [database configuration page](https://documentation.bonitasoft.com/bonita/latest/runtime/database-configuration#postgres_setup). + Alternatively, Bonita provides a preconfigured [PostgreSQL image](https://hub.docker.com/r/bonitasoft/bonita-postgres) on docker-hub. + You can run the image with the following command:
|
|
Therefore the PostgreSQL container needs to be configured to work with Bonita before starting the Bonita container. The configuration of a PostgreSQL database to work with Bonita is described in details in the [database configuration page](https://documentation.bonitasoft.com/bonita/latest/runtime/database-configuration#postgres_setup). + Alternatively, Bonita provides a preconfigured [PostgreSQL image](https://hub.docker.com/r/bonitasoft/bonita-postgres) on docker-hub. + You can run the image with the following command:
|
|
|
|
|
|
|
|
```bash
|
|
```bash
|
|
|
-docker run --name mydbpostgres -h <hostname> -d bonitasoft/bonita-postgres:12.6
|
|
|
|
|
|
|
+docker run --name mydbpostgres -h <hostname> -d bonitasoft/bonita-postgres:16.4
|
|
|
```
|
|
```
|
|
|
|
|
|
|
|
-This image is built from the following [GitHub repository](https://github.com/Bonitasoft-Community/bonita-database-docker/tree/main/postgres/12), which can be further adapted/customized to suit your needs.
|
|
|
|
|
|
|
+This image is built from the following [GitHub repository](https://github.com/Bonitasoft-Community/bonita-database-docker/tree/main/postgres/16), which can be further adapted/customized to suit your needs.
|
|
|
|
|
|
|
|
## %%STACK%%
|
|
## %%STACK%%
|
|
|
|
|
|
|
@@ -66,7 +66,7 @@ docker run --name=bonita -h <hostname> --env-file=env.txt -d -p 8080:8080 %%IMAG
|
|
|
## Start Bonita with custom security credentials
|
|
## Start Bonita with custom security credentials
|
|
|
|
|
|
|
|
```bash
|
|
```bash
|
|
|
-docker run --name=bonita -h <hostname> -e "TENANT_LOGIN=tech_user" -e "TENANT_PASSWORD=secret" -e "PLATFORM_LOGIN=pfadmin" -e "PLATFORM_PASSWORD=pfsecret" -d -p 8080:8080 %%IMAGE%%
|
|
|
|
|
|
|
+docker run --name=bonita -h <hostname> -e "BONITA_RUNTIME_ADMIN_USERNAME=tech_user" -e "BONITA_RUNTIME_ADMIN_PASSWORD=secret" -e "PLATFORM_LOGIN=pfadmin" -e "PLATFORM_PASSWORD=pfsecret" -d -p 8080:8080 %%IMAGE%%
|
|
|
```
|
|
```
|
|
|
|
|
|
|
|
Now you can access the Bonita Runtime on localhost:8080/bonita and login using: tech_user / secret
|
|
Now you can access the Bonita Runtime on localhost:8080/bonita and login using: tech_user / secret
|
|
@@ -92,11 +92,11 @@ This optional environment variable is used in conjunction with PLATFORM_PASSWORD
|
|
|
|
|
|
|
|
This environment variable is recommended 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 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.
|
|
|
|
|
|
|
|
-### TENANT_LOGIN
|
|
|
|
|
|
|
+### BONITA_RUNTIME_ADMIN_USERNAME
|
|
|
|
|
|
|
|
-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 username `install` will be used.
|
|
|
|
|
|
|
+This optional environment variable is used in conjunction with BONITA_RUNTIME_ADMIN_PASSWORD to define the username for the tenant administrator. If it is not specified, the default username `install` will be used.
|
|
|
|
|
|
|
|
-### TENANT_PASSWORD
|
|
|
|
|
|
|
+### BONITA_RUNTIME_ADMIN_PASSWORD
|
|
|
|
|
|
|
|
This environment variable is recommended 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 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.
|
|
|
|
|
|
|
@@ -190,7 +190,7 @@ These variables are used in conjunction to define how Bonita should access the [
|
|
|
|
|
|
|
|
The logger can be configured by mounting a volume on folder `/opt/bonita/conf/logs` containing the configuration files.
|
|
The logger can be configured by mounting a volume on folder `/opt/bonita/conf/logs` containing the configuration files.
|
|
|
|
|
|
|
|
-the volume must contain the 2 files [log4j2-loggers.xml](https://raw.githubusercontent.com/bonitasoft/bonita-distrib/7.14.0/tomcat-resources/tomcat-distrib-for-bonita/src/main/resources/tomcat/server/conf/log4j2-loggers.xml) and [log4j2-appenders.xml](https://raw.githubusercontent.com/bonitasoft/bonita-distrib/7.14.0/docker/files/log4j2/log4j2-appenders.xml)
|
|
|
|
|
|
|
+the volume must contain the 2 files [log4j2-loggers.xml](https://raw.githubusercontent.com/bonitasoft/bonita-distrib/10.2.0/tomcat-resources/tomcat-distrib-for-bonita/src/main/resources/tomcat/server/conf/log4j2-loggers.xml) and [log4j2-appenders.xml](https://raw.githubusercontent.com/bonitasoft/bonita-distrib/10.2.0/docker/files/log4j2/log4j2-appenders.xml)
|
|
|
|
|
|
|
|
Any change made to one of this 2 files is automatically hot-reloaded and taken into account immediately.
|
|
Any change made to one of this 2 files is automatically hot-reloaded and taken into account immediately.
|
|
|
|
|
|
|
@@ -212,7 +212,7 @@ $ docker run -e HTTP_API=true -e HTTP_API_PASSWORD="My-Cust0m_S3cR3T" --name bo
|
|
|
|
|
|
|
|
## Update from an earlier version of Bonita
|
|
## Update from an earlier version of Bonita
|
|
|
|
|
|
|
|
-For updating from a version before 7.10.0, please refer to the [documentation](https://documentation.bonitasoft.com/bonita/latest/version-update/migrate-from-an-earlier-version-of-bonita)
|
|
|
|
|
|
|
+For updating from a version before 7.10.0, please refer to the [documentation](https://documentation.bonitasoft.com/bonita/latest/version-update/update-with-migration-tool)
|
|
|
|
|
|
|
|
- Stop the container to perform a database backup
|
|
- Stop the container to perform a database backup
|
|
|
|
|
|
|
@@ -246,17 +246,16 @@ For updating from a version before 7.10.0, please refer to the [documentation](h
|
|
|
$ cat /tmp/bonitadb.sql | psql -U newbonitauser -h 172.17.0.26 newbonitadb
|
|
$ cat /tmp/bonitadb.sql | psql -U newbonitauser -h 172.17.0.26 newbonitadb
|
|
|
```
|
|
```
|
|
|
|
|
|
|
|
-- Retrieve the last update tool
|
|
|
|
|
|
|
+- Retrieve the last update tool archive from https://www.bonitasoft.com/downloads
|
|
|
|
|
|
|
|
```console
|
|
```console
|
|
|
- wget https://github.com/bonitasoft/bonita-platform-releases/releases/download/2023.2-u0/bonita-update-tool-3.3.0.zip
|
|
|
|
|
- unzip bonita-update-tool-3.3.0.zip
|
|
|
|
|
|
|
+ unzip bonita-update-tool-3.6.0.zip
|
|
|
```
|
|
```
|
|
|
|
|
|
|
|
- Configure the update tool
|
|
- Configure the update tool
|
|
|
|
|
|
|
|
```console
|
|
```console
|
|
|
- $ cd bonita-update-tool-3.3.0
|
|
|
|
|
|
|
+ $ cd bonita-update-tool-3.6.0
|
|
|
```
|
|
```
|
|
|
|
|
|
|
|
edit the update tool configuration file `Config.properties` to point towards the database.
|
|
edit the update tool configuration file `Config.properties` to point towards the database.
|
|
@@ -285,7 +284,7 @@ For updating from a version before 7.10.0, please refer to the [documentation](h
|
|
|
- Launch the new container pointing towards the copy of the database.
|
|
- Launch the new container pointing towards the copy of the database.
|
|
|
|
|
|
|
|
```console
|
|
```console
|
|
|
- $ docker run --name=bonita --link mydbpostgres:postgres -e "DB_NAME=newbonitadb" -e "DB_USER=newbonitauser" -e "DB_PASS=newbonitapass" -d -p 8081:8080 %%IMAGE%%:2023.2-u0
|
|
|
|
|
|
|
+ $ docker run --name=bonita --link mydbpostgres:postgres -e "DB_NAME=newbonitadb" -e "DB_USER=newbonitauser" -e "DB_PASS=newbonitapass" -d -p 8081:8080 %%IMAGE%%:2024.3-u0
|
|
|
```
|
|
```
|
|
|
|
|
|
|
|
For more details regarding Bonita update and for version before 7.10.0, see the [documentation](https://documentation.bonitasoft.com/bonita/latest/version-update/migrate-from-an-earlier-version-of-bonita).
|
|
For more details regarding Bonita update and for version before 7.10.0, see the [documentation](https://documentation.bonitasoft.com/bonita/latest/version-update/migrate-from-an-earlier-version-of-bonita).
|