docs(content/update): Add Weld Issue Workaround Note

Co-authored-by: Petros Savvidis <[email protected]> Co-authored-by: Daniel Kelemen <[email protected]> Related-to: camunda/camunda-bpm-platform#4434
camunda · Jul 26, 2024 · 082565a · 082565a
1 parent 68bf0df
commit 082565a
Show file tree

Hide file tree

Showing 2 changed files with 13 additions and 1 deletion.
diff --git a/content/update/minor/721-to-722/_index.md b/content/update/minor/721-to-722/_index.md
@@ -152,4 +152,9 @@ Replace the artifact `camunda-engine-rest-$PLATFORM_VERSION-tomcat.war` with `ca
 
 ### Migrating to the Tomcat 10 Docker Image
 
-If your application uses a Docker image based on `Tomcat 9`, you need to perform the above migration steps yourself before your application is compatible with the `jakarta` namespace changes the new Tomcat version introduces.
+If your application uses a Docker image based on `Tomcat 9`, you need to perform the above migration steps yourself before your application is compatible with the `jakarta` namespace changes the new Tomcat version introduces.
+
+### Weld Class Loading Issues
+
+In deployment scenarios involving one or more process applications with managed beans, classloading issues may occur if the WELD library is directly embedded in the WAR or process application deployment.
+To resolve this, it is recommended to relocate the WELD library from the WAR or process application deployment to the Tomcat server's library folder.
diff --git a/content/update/patch-level.md b/content/update/patch-level.md
@@ -493,12 +493,19 @@ This API is an internal API, which means it's **not** part of the public [REST A
 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" >}}
+
+**<h4>Jakarta Namespace</h4>**
+
 `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" >}})
+
+**<h4>Weld Class Loading Issues</h4>**
+In deployment scenarios involving one or more process applications with managed beans, classloading issues may occur if the WELD library is directly embedded in the WAR or process application deployment.
+To resolve this, it is recommended to relocate the WELD library from the WAR or process application deployment to the Tomcat server's library folder.
 {{< /note >}}
 
 # Full Distribution