Merge branch 'master' into 4467-remove-swagger-from-docs

Author: psavidis

content/installation/full/tomcat/manual.md

@@ -25,6 +25,21 @@ Throughout this guide we will use a number of variables to denote common path na
 
 {{< /note >}}
 
+{{< note title="Known Limitations in Tomcat 10" class="info" >}}
+
+**<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's `/WEB-INF/lib` folder.
+To resolve this, move the weld library away from the war and place it into the `$CATALINA_HOME/lib` folder.
+
+The above workaround is not guaranteed to work for cases with bean references between WAR deployments (WAR A referencing a bean from WAR B).
+
+The following test scenarios fail on Tomcat 10:
+
+* [CallActivityContextSwitchTest](https://github.com/camunda/camunda-bpm-platform/blob/f37877b822dabcbf3cee5806bd5833d18cdcb543/qa/integration-tests-engine/src/test/java/org/camunda/bpm/integrationtest/functional/context/CallActivityContextSwitchTest.java)
+* [CdiBeanCallActivityResolutionTest](https://github.com/camunda/camunda-bpm-platform/blob/f37877b822dabcbf3cee5806bd5833d18cdcb543/qa/integration-tests-engine/src/test/java/org/camunda/bpm/integrationtest/functional/cdi/CdiBeanCallActivityResolutionTest.java)
+{{< /note >}}
+
 
 # Setup
 

content/update/minor/721-to-722/_index.md

@@ -157,8 +157,15 @@ If your application uses a Docker image based on `Tomcat 9`, you need to perform
 
 ### 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.
+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's `/WEB-INF/lib` folder.
+To resolve this, move the weld library away from the war and place it into the `$CATALINA_HOME/lib` folder.
+
+The above workaround is not guaranteed to work for cases with bean references between WAR deployments (WAR A referencing a bean from WAR B).
+
+The following test scenarios fail on Tomcat 10:
+
+* [CallActivityContextSwitchTest](https://github.com/camunda/camunda-bpm-platform/blob/f37877b822dabcbf3cee5806bd5833d18cdcb543/qa/integration-tests-engine/src/test/java/org/camunda/bpm/integrationtest/functional/context/CallActivityContextSwitchTest.java)
+* [CdiBeanCallActivityResolutionTest](https://github.com/camunda/camunda-bpm-platform/blob/f37877b822dabcbf3cee5806bd5833d18cdcb543/qa/integration-tests-engine/src/test/java/org/camunda/bpm/integrationtest/functional/cdi/CdiBeanCallActivityResolutionTest.java)
 
 # Camunda Run and Swagger Update
 
@@ -167,5 +174,4 @@ To reduce the maintenance effort, Swagger is discontinued from `camunda-run`.
 From now on, the parameterisation of camunda-run scripts will not include the `--swaggerui` argument. 
 Instead, you can always use [open-api][open-api] in conjunction with a `REST` client of your choice such as POSTMAN to achieve similar results. 
 
-
 [open-api]: {{< ref "/reference/rest/openapi/_index.md" >}}

content/update/patch-level.md

@@ -504,8 +504,15 @@ 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.
+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's `/WEB-INF/lib` folder.
+To resolve this, move the weld library away from the war and place it into the `$CATALINA_HOME/lib` folder.
+
+The above workaround is not guaranteed to work for cases with bean references between WAR deployments (WAR A referencing a bean from WAR B). 
+
+The following test scenarios fail on Tomcat 10:
+
+* [CallActivityContextSwitchTest](https://github.com/camunda/camunda-bpm-platform/blob/f37877b822dabcbf3cee5806bd5833d18cdcb543/qa/integration-tests-engine/src/test/java/org/camunda/bpm/integrationtest/functional/context/CallActivityContextSwitchTest.java)
+* [CdiBeanCallActivityResolutionTest](https://github.com/camunda/camunda-bpm-platform/blob/f37877b822dabcbf3cee5806bd5833d18cdcb543/qa/integration-tests-engine/src/test/java/org/camunda/bpm/integrationtest/functional/cdi/CdiBeanCallActivityResolutionTest.java)
 {{< /note >}}
 
 # Full Distribution