Sharing a Tomcat Instance
Although not recommended, if you want to share a Tomcat instance between Oxygen XML Web Author and another web application, the following issues need to be
considered:
- Oxygen XML Web Author reads and sets system properties, and while it attempts to namespace those that are specific to Oxygen XML Web Author, there is no guarantee that there will not be any clashes with those set by other applications.
-
Oxygen XML Web Author installs its own
URLStreamHandlerFactory
and registers custom handlers for some of the common protocols such ashttp
,https
, andfile
.To disable the custom handlers, set the servletint-param
with the namecom.oxygenxml.loadBuiltinProtocolHandlers
tofalse
.Note: Most of the plugins that connect to a file server are not compatible with this setting. - You have to adapt the JVM's memory configuration to the scenario where there will be more applications competing for the same pool of memory.
- Oxygen XML Web Author currently does not restart (or reload in Apache Tomcat terminology) correctly unless the Servlet Container is also restarted.