Configuring the Application Server

Configuring the Application Server

When deploying applications using ICEfaces EE and the Asynchronous HTTP Server, a J2EE compliant application server is required with support for JMS. The Asynchronous HTTP Server and the ICEfaces applications communicate over multiple JMS topics. It is necessary to configure the following JMS topics:

icefaces.contextEventTopic
icefaces.responseTopic

Application server-specific configurations are provided below.

Note: For clustered deployments, additional JMS configuration will be required. See Chapter 4 for details.

JBoss 4.0

When JBoss is started, three different configurations can be specified: default, all, or minimal. The minimal configuration is not sufficient for Asynchronous HTTP Server deployments, as it does not include JMS. The default configuration can be used in single node deployments, but the all configuration is required for clustered deployments. Table 2 below contains the location of the directory containing the jbossmq-destinations-service.xml file for each valid JBoss configuration.

Table 2: JBoss Configuration Files

Configuration

Directory

default

[jboss-install-dir]/server/default/deploy/jms/

all

[jboss-install-dir]/server/all/deploy-hasingleton/jms/

To configure the JMS topics, add the following code to the selected jbossmq-destinations-service.xml file:
<mbean code="org.jboss.mq.server.jmx.Topic"
 
       name="jboss.mq.destination:service=Topic,name=icefaces.contextEventTopic">
 
    <depends optional-attribute-name="DestinationManager">
 
        jboss.mq:service=DestinationManager
 
    </depends>
 
    <depends optional-attribute-name="SecurityManager">
 
        jboss.mq:service=SecurityManager
 
    </depends>
 
    <attribute name="SecurityConf">
 
        <security>
 
            <role name="guest" read="true" write="true" create="true"/>
 
        </security>
 
    </attribute>
 
</mbean>
 

 
<mbean code="org.jboss.mq.server.jmx.Topic"
 
       name="jboss.mq.destination:service=Topic,name=icefaces.responseTopic">
 
    <depends optional-attribute-name="DestinationManager">
 
        jboss.mq:service=DestinationManager
 
    </depends>
 
    <depends optional-attribute-name="SecurityManager">
 
        jboss.mq:service=SecurityManager
 
    </depends>
 
    <attribute name="SecurityConf">
 
        <security>
 
            <role name="guest" read="true" write="true" create="true"/>
 
        </security>
 
    </attribute>
 
</mbean>
 
WebLogic Server 8.1 Service Pack 4

To configure the JMS topics login to WebLogic's console (for example, http://localhost:7001/console) and follow these steps:

1. On the left panel, navigate to Services > JMS > Connection Factories.

2. On the right panel, select Configure a new JMS Connection Factory...

3. Enter a Name (for example, ConnectionFactory) and a JNDI name (for example, ConnectionFactory), and then click Create.

4. Select a server as the target and click Apply.

5. On the left panel, navigate to Services > JMS > Servers > WSStoreForwardInternalJMSServermyserver > Destinations (where myserver is the name of your server).

6. On the right panel, select Configure a new JMS Topic....

7. Enter icefaces.contextEventTopic for both Name and JNDI name, and then click Create.

8. Repeat steps 5 to 7 for icefaces.responseTopic.

For more information on how to configure JMS on WebLogic, refer to "JMS: Configuring" which can be found at:

http://e-docs.bea.com/wls/docs81/ConsoleHelp/jms_config.html

Configuration	Directory
default	[jboss-install-dir]/server/default/deploy/jms/
all	[jboss-install-dir]/server/all/deploy-hasingleton/jms/