Until very recently, putting these two different beasts working together was quite a difficult and painful task due to dependencies conflicts. The OSGi compliant release of JBoss (AKA JBoss AS 7) came to make all this much easier since now the JBoss AS dependencies are isolated from the actual web application ones.
For simplicity, I’ve put together a ready-to-deploy Enterprise Archive (ear) file containing all you need to start and that you can download and deploy in JBoss AS 7.
The package includes all of the following ready-to-use Red5 example demos:
– VOD – Initial Red5 video (e.g. localhost:8080/Red5)
– OFLA Demo – Publish and Subscribe to media streams
– FITC Demo – Video Conference
– Echo Test
– SOSample – Shared Object example app – in sample app point your URI to rtmp://localhost/red5/SOSample
– Simple Broadcaster
– Simple Subscriber
– Simple Recorder
– Audio Transcoder – Audio Xuggler demo
– Video Transcoder – Video Xuggler demo
To run the Transcoder demos you’ll need to install Xuggler in your system. Everything else you need is already packed in the ear. Here’s a good guide on how to run the Xuggler test by Antoni Jakubiak.
- Download the Enterprise Archive (ear) from here.
- Rename the downloaded file to red5.ear.7z and use 7Zip to extract it.
- Deploy the exploded contents under your jboss-as-web-7.0.0.Final\standalone\deployments directory.
- Start your JBoss AS 7 server: jboss-as-web-7.0.0.Final\bin\standalone.bat (.sh for Posix flavours).
- Point your browser to localhost:8080/red5 if running locally.
To add or change the deployment war just edit the red5.ear/META-INF/application.xml and un/comment the desired web archives to be deployed.
I’ve also put together an article at JBoss.org that explains the process of getting Red5 working under JBoss AS 7. Test procedures are included. You can find it here. In that same page you can also find a better formatted PDF of the same article that might be easier to follow.
Kudos to Scott Kroll for having figured out how to circumnavigate around some issues, specially for figuring out what to put on red5-context.jar.
Next step… Red5 as an OSGi bundle. Stay posted!