diff --git a/content/installation/full/tomcat/manual.md b/content/installation/full/tomcat/manual.md index a9a75d32f..52dbfe4f9 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. diff --git a/content/update/patch-level.md b/content/update/patch-level.md index 5fd6e1e7c..1be4fa636 100644 --- a/content/update/patch-level.md +++ b/content/update/patch-level.md @@ -486,6 +486,41 @@ 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`. + +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.