JEEContainerPlugins

Containers

A few JEE (Java Enterprise Edition) containers were developed for embedding within Red5 server. The Tomcat container is embedded by default. The following containers are available, albeit in various stages of compatibility:

Tomcat Plugin

Tomcat Official Site

The following jars are required by Tomcat, place these in the red5/plugins directory:

ecj-4.4.2.jar
el-api.jar
juli-over-slf4j-1.6.1.jar
tomcat-embed-core.jar
tomcat-embed-el.jar
tomcat-embed-jasper.jar
tomcat-embed-logging-juli.jar

Plugin source

Jetty Plugin

Jetty

The following jars are required by Jetty, place these in the red5/plugins directory:

jetty-continuation-7.1.6.v20100715.jar
jetty-deploy-7.1.6.v20100715.jar
jetty-http-7.1.6.v20100715.jar
jetty-io-7.1.6.v20100715.jar
jetty-security-7.1.6.v20100715.jar
jetty-server-7.1.6.v20100715.jar
jetty-servlet-7.1.6.v20100715.jar
jetty-util-7.1.6.v20100715.jar
jetty-webapp-7.1.6.v20100715.jar
jetty-xml-7.1.6.v20100715.jar

Plugin source

Winstone Plugin

Winstone

The following jars are required by Winstone, place these in the red5/plugins directory:

winstone-lite-0.9.10.jar

Plugin source

Undertow Plugin

Undertow

The following jars are required by Undertow, place these in the red5/plugins directory:

undertow-core-1.3.0.jar

Plugin source

Enable a Container

To enable a different container you must extract the plugin's jee-container.xml file and place it the Red5 configuration directory and then restart your server.

No JEE

An empty jee-container.xml file exists within the Red5 configuration directory to allow Red5 to run without a JEE container.

Fixing plug-in startup errors

The most likely cause of any start up issues you may experience is their missing dependent libraries. But if "beans" are not found, extract the jee-container.xml file from plugin jar and place it in the conf directory.

If you see an error about a "Loader" class not being found, this will be because the container

you have chosen has not been deployed to the plugins directory. Ensure that your selected containers jar is in the plugins directory directly under your red5 home directory.

The exception will read like so for a missing tomcat plugin jar.

org.springframework.beans.factory.CannotLoadBeanClassException: Cannot
find class [org.red5.server.tomcat.TomcatLoader] for bean with name
'tomcat.server' defined in class path resource [jee-container.xml]; nested exception is
java.lang.ClassNotFoundException: org.red5.server.tomcat.TomcatLoader