From 812fa18f0ecdd505d0bbe351c2bfe13191583e88 Mon Sep 17 00:00:00 2001 From: Petros Savvidis Date: Mon, 1 Jul 2024 17:20:50 +0300 Subject: [PATCH 1/6] chore(content/update): Add Patch Level Tomcat 10 Support --- content/update/patch-level.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/content/update/patch-level.md b/content/update/patch-level.md index 5fd6e1e7c0..692633846f 100644 --- a/content/update/patch-level.md +++ b/content/update/patch-level.md @@ -486,6 +486,19 @@ This will allow a better experience when looking for process definitions. The change also affects the API that provides the data for the search component. This API is an internal API, which means it's **not** part of the public [REST API]({{< ref "/reference/rest" >}}), so the change should not affect any customers. +## 7.21.3 to 7.21.4 + +### Added Support for Tomcat 10 + +This version supports all the necessary building-block modules for our users to use `camunda-bpm-platform` community and enterprise editions in conjunction with `Tomcat 10.1`. + +{{< note title="Heads-up!" class="warning" >}} +`Tomcat 10` is compatible with the `jakarta` namespace. +If you wish to use it, the `jakarta` modules needs to be used (`camunda-webapp-tomcat-jakarta`, `camunda-engine-rest-jakarta`). + +The `javax` modules won't work with `Tomcat 10`. +{{< /note >}} + # Full Distribution This section is applicable if you installed the [Full Distribution]({{< ref "/introduction/downloading-camunda.md#full-distribution" >}}) with a **shared process engine**. In this case you need to update the libraries and applications installed inside the application server. From d018c0a30ea53003c622bc2d909b1403b3739b6c Mon Sep 17 00:00:00 2001 From: Petros Savvidis Date: Mon, 1 Jul 2024 17:52:59 +0300 Subject: [PATCH 2/6] chore(tomcat): Add Tomcat Manual Installation Section Same as the 7.22 change --- content/installation/full/tomcat/manual.md | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) diff --git a/content/installation/full/tomcat/manual.md b/content/installation/full/tomcat/manual.md index a9a75d32f8..52dbfe4f98 100644 --- a/content/installation/full/tomcat/manual.md +++ b/content/installation/full/tomcat/manual.md @@ -143,7 +143,8 @@ You have to add the file `bpm-platform.xml` to the folder `$TOMCAT_HOME/conf` or ## Secure Tomcat Follow the Tomcat Security Howto of your Tomcat version: -[9.0](https://tomcat.apache.org/tomcat-9.0-doc/security-howto.html). +[9.0](https://tomcat.apache.org/tomcat-9.0-doc/security-howto.html), +[10.1](https://tomcat.apache.org/tomcat-10.1-doc/security-howto.html). In particular, go to `${TOMCAT_HOME}/webapps/` and remove the directories `ROOT`, `docs`, `examples`, `manager` and `host-manager`. @@ -158,9 +159,10 @@ This section describes how to install optional Camunda 7 dependencies onto a Tom The following steps are required to deploy the applications: -1. Download the Camunda 7 web application that contains both applications from our [Maven Nexus Server](https://artifacts.camunda.com/artifactory/camunda-bpm/org/camunda/bpm/webapp/camunda-webapp-tomcat/). +1. Download the Camunda 7 web application that contains both applications from our [Artifact Repository](https://artifacts.camunda.com/artifactory/camunda-bpm/org/camunda/bpm/webapp/camunda-webapp-tomcat/). Or switch to the private repository for the enterprise version (User and password from license required). - Choose the correct version named `$PLATFORM_VERSION/camunda-webapp-tomcat-$PLATFORM_VERSION.war`. + * For [Tomcat 10](https://artifacts.camunda.com/ui/native/camunda-bpm/org/camunda/bpm/webapp/camunda-webapp-tomcat-jakarta/), the name of the artifact is `$PLATFORM_VERSION/camunda-webapp-tomcat-jakarta-$PLATFORM_VERSION.war`. + * For [Tomcat 9](https://artifacts.camunda.com/ui/native/camunda-bpm/org/camunda/bpm/webapp/camunda-webapp-tomcat/), the name of the artifact is `$PLATFORM_VERSION/camunda-webapp-tomcat-$PLATFORM_VERSION.war`. 2. Copy the war file to `$TOMCAT_HOME/webapps/camunda.war`. Optionally you may name it differently or extract it to a folder to deploy it to a different context path. 3. Startup Tomcat. @@ -171,9 +173,11 @@ The following steps are required to deploy the applications: The following steps are required to deploy the REST API: -1. Download the REST API web application archive from our [Maven Nexus Server](https://artifacts.camunda.com/artifactory/camunda-bpm/org/camunda/bpm/camunda-engine-rest/). - Or switch to the private repository for the enterprise version (User and password from license required). - Choose the correct version named `$PLATFORM_VERSION/camunda-engine-rest-$PLATFORM_VERSION-tomcat.war`. +1. Download the REST API web application archive from our [Artifact Repository](https://artifacts.camunda.com/artifactory/camunda-bpm/org/camunda/bpm/camunda-engine-rest/). + Or switch to the private repository for the enterprise version (User and password from license required). + Choose the correct version named `$PLATFORM_VERSION/camunda-engine-rest-$PLATFORM_VERSION-tomcat.war`. + * For [Tomcat 10](https://artifacts.camunda.com/artifactory/public/org/camunda/bpm/camunda-engine-rest-jakarta/), the name of the artifact is `$PLATFORM_VERSION/camunda-engine-rest-jakarta-$PLATFORM_VERSION-tomcat.war`. + * For [Tomcat 9](https://artifacts.camunda.com/artifactory/public/org/camunda/bpm/camunda-engine-rest/), the name of the artifact is `$PLATFORM_VERSION/camunda-engine-rest-$PLATFORM_VERSION-tomcat.war`. 2. Copy the war file to `$TOMCAT_HOME/webapps`. Optionally you may rename it or extract it to a folder to deploy it to a specific context like `/engine-rest`. 3. Startup Tomcat. From 902fb3b481cd3660b26930043698ff027c3616fa Mon Sep 17 00:00:00 2001 From: Petros Savvidis Date: Mon, 1 Jul 2024 18:05:12 +0300 Subject: [PATCH 3/6] chore(tomcat): Add manual installation guide Add the reference to the patch level update section --- content/update/patch-level.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/content/update/patch-level.md b/content/update/patch-level.md index 692633846f..ee03eb0f65 100644 --- a/content/update/patch-level.md +++ b/content/update/patch-level.md @@ -497,6 +497,8 @@ This version supports all the necessary building-block modules for our users to If you wish to use it, the `jakarta` modules needs to be used (`camunda-webapp-tomcat-jakarta`, `camunda-engine-rest-jakarta`). The `javax` modules won't work with `Tomcat 10`. + +For detailed steps of manual installation, follow the [Tomcat Manual Installation Guide]({{< ref "/installation/full/tomcat/manual.md" >}}) {{< /note >}} # Full Distribution From 73d49bc7d27ef76f5e649cda4a65f3c1c09f227c Mon Sep 17 00:00:00 2001 From: Petros Savvidis Date: Thu, 4 Jul 2024 13:11:17 +0300 Subject: [PATCH 4/6] chore(tomcat): Add to Patch Level Section - Migrate process applications - Migrate Java webapp plugins --- content/update/patch-level.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/content/update/patch-level.md b/content/update/patch-level.md index ee03eb0f65..c6c69b56bd 100644 --- a/content/update/patch-level.md +++ b/content/update/patch-level.md @@ -501,6 +501,26 @@ The `javax` modules won't work with `Tomcat 10`. For detailed steps of manual installation, follow the [Tomcat Manual Installation Guide]({{< ref "/installation/full/tomcat/manual.md" >}}) {{< /note >}} +### Migrate process applications + +* Replace Java EE class references (`javax.*`) with Jakarta class references (`jakarta.*`) +* You might have a look at [`org.eclipse.transformer:transformer-maven-plugin`](https://github.com/eclipse/transformer) +* Replace Camunda class references: +* `org.camunda.bpm.application.impl.EjbProcessApplication` → `org.camunda.bpm.application.impl.JakartaEjbProcessApplication` +* `org.camunda.bpm.application.impl.ServletProcessApplicationDeployer` → `org.camunda.bpm.application.impl.JakartaServletProcessApplicationDeployer` +* `org.camunda.bpm.application.impl.ServletProcessApplication` → `org.camunda.bpm.application.impl.JakartaServletProcessApplication` +* `org.camunda.bpm.engine.impl.cfg.jta.JtaTransactionContext` → `org.camunda.bpm.engine.impl.cfg.jta.JakartaTransactionContext` +* `org.camunda.bpm.engine.impl.cfg.jta.JtaTransactionContextFactory` → `org.camunda.bpm.engine.impl.cfg.jta.JakartaTransactionContextFactory` +* `org.camunda.bpm.engine.impl.cfg.JtaProcessEngineConfiguration` → `org.camunda.bpm.engine.impl.cfg.JakartaTransactionProcessEngineConfiguration` +* `org.camunda.bpm.engine.impl.interceptor.JtaTransactionInterceptor` → `org.camunda.bpm.engine.impl.interceptor.JakartaTransactionInterceptor` +* Replace Camunda Maven dependencies: +* `org.camunda.bpm.javaee:camunda-ejb-client` → `org.camunda.bpm.javaee:camunda-ejb-client-jakarta` +* `org.camunda.bpm:camunda-engine-cdi` → `org.camunda.bpm:camunda-engine-cdi-jakarta` + +### Migrate Java webapp plugins + +Replace Java EE class references (`javax.*`) with Jakarta class references (`jakarta.*`) + # Full Distribution This section is applicable if you installed the [Full Distribution]({{< ref "/introduction/downloading-camunda.md#full-distribution" >}}) with a **shared process engine**. In this case you need to update the libraries and applications installed inside the application server. From cdba17b85f2785cc409fe60743f1c9e3522a1487 Mon Sep 17 00:00:00 2001 From: psavidis <69160690+psavidis@users.noreply.github.com> Date: Thu, 4 Jul 2024 15:38:09 +0300 Subject: [PATCH 5/6] Update content/update/patch-level.md Co-authored-by: tasso94 <3015690+tasso94@users.noreply.github.com> --- content/update/patch-level.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/update/patch-level.md b/content/update/patch-level.md index c6c69b56bd..6e213744ac 100644 --- a/content/update/patch-level.md +++ b/content/update/patch-level.md @@ -517,7 +517,7 @@ For detailed steps of manual installation, follow the [Tomcat Manual Installatio * `org.camunda.bpm.javaee:camunda-ejb-client` → `org.camunda.bpm.javaee:camunda-ejb-client-jakarta` * `org.camunda.bpm:camunda-engine-cdi` → `org.camunda.bpm:camunda-engine-cdi-jakarta` -### Migrate Java webapp plugins +#### Migrate Java webapp plugins Replace Java EE class references (`javax.*`) with Jakarta class references (`jakarta.*`) From 35409469112461abe828e907914dd8f238580ce9 Mon Sep 17 00:00:00 2001 From: Petros Savvidis Date: Thu, 4 Jul 2024 15:39:27 +0300 Subject: [PATCH 6/6] chore(tomcat): fix header --- content/update/patch-level.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/update/patch-level.md b/content/update/patch-level.md index 6e213744ac..1be4fa636a 100644 --- a/content/update/patch-level.md +++ b/content/update/patch-level.md @@ -501,7 +501,7 @@ The `javax` modules won't work with `Tomcat 10`. For detailed steps of manual installation, follow the [Tomcat Manual Installation Guide]({{< ref "/installation/full/tomcat/manual.md" >}}) {{< /note >}} -### Migrate process applications +#### Migrate process applications * Replace Java EE class references (`javax.*`) with Jakarta class references (`jakarta.*`) * You might have a look at [`org.eclipse.transformer:transformer-maven-plugin`](https://github.com/eclipse/transformer)