Skip to content

Commit

Permalink
chore(content/update): Add Tomcat 10 Support
Browse files Browse the repository at this point in the history
Co-authored-by: tasso94
Co-authored-by: petros.savvidis

Related-to: camunda/camunda-bpm-platform#4391
Parent-ticket: camunda/camunda-bpm-platform#2471
  • Loading branch information
psavidis authored Jul 4, 2024
1 parent 6c0cd3b commit 29f714f
Show file tree
Hide file tree
Showing 2 changed files with 45 additions and 6 deletions.
16 changes: 10 additions & 6 deletions content/installation/full/tomcat/manual.md
Original file line number Diff line number Diff line change
Expand Up @@ -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`.
Expand All @@ -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.
Expand All @@ -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.
Expand Down
35 changes: 35 additions & 0 deletions content/update/patch-level.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down

0 comments on commit 29f714f

Please sign in to comment.