Installing JBoss WebSocket Support

To enable Atmosphere websocket support in JBoss 7.1.2 and up, add the following dependencies to your pom (please DO NOT add atmosphere-runtime):

    <dependency>
        <groupId>org.atmosphere</groupId>
        <artifactId>atmosphere-runtime-native</artifactId>
        <version>2.x</version>
    </dependency>
    <dependency>
        <groupId>org.atmosphere.jboss.as</groupId>
        <artifactId>jboss-as-websockets</artifactId>
        <version>0.5</version>
    </dependency>

You MUST make sure Tomcat Native Connector, aka APR, has been properly installed in JBoss. Go to their website for more information. Once installed, all you need to do is to change, in domain/configuration/domain.xml:

    <subsystem xmlns="urn:jboss:domain:web:1.1" 
        default-virtual-server="default-host" native="false">           

to:

    <subsystem xmlns="urn:jboss:domain:web:1.1"
          default-virtual-server="default-host" native="true">

Start JBoss and Atmosphere's application should starts supporting WebSocket!

For more information about websockets in JBoss, check out these pages:

• jboss-websockets
• WebsocketSupportInAS7