6-2 Configuring and Managing JMS for Oracle WebLogic Server
Figure 6–1 Subdeployment Architecture
6.2 How to Create JMS Servers and JMS System Module Resources
Basic tasks you need to perform when creating JMS system resources with WLST are:
■
Start an edit session.
■
Create a JMS system module that includes JMS resources, such as queues, topics, and connection factories.
■
Create JMS server resources. After you have established an edit session, use the following steps configure JMS
servers and system module resources:
1. Get the WebLogic Server MBean object for the server you want to configure
resources. For example: servermb=getMBeanServersexamplesServer
if servermb is None: print No server MBean found
2. Create your system resource. For example:
jmsMySystemResource = createmyJmsSystemResource,JMSSystemResource
3. Target your system resource to a WebLogic Server instance. For example:
jmsMySystemResource.addTargetservermb
4. Get your system resource object. For example:
theJMSResource = jmsMySystemResource.getJMSResource
Using WLST to Manage JMS Servers and JMS System Module Resources 6-3
5.
Create resources for the module, such as queues, topics, and connection factories. For example:
connfact1 = theJMSResource.createConnectionFactoryfactoryName jmsqueue1 = theJMSResource.createQueuequeueName
6.
Configure resource attributes. For example: connfact1.setJNDINamefactoryName
jmsqueue1.setJNDINamequeueName
7.
Create a subdeployment name for system resources. See Section 6.1,
Understanding JMS System Modules and Subdeployments. For example:
connfact1.setSubDeploymentNameDeployToJMSServer1 jmsqueue1.setSubDeploymentNameDeployToJMSServer1
8.
Create a JMS server. For example: jmsserver1mb = createjmsServerName,JMSServer
9.
Target your JMS server to a WebLogic Server instance. For example: jmsserver1mb.addTargetservermb
10.
Create a subdeployment object using the value you provided for the sub-deployment-name element. This step groups the system resources in
module to a sub-deployment element in the config.xml. For example:
subDep1mb = jmsMySystemResource.createSubDeploymentDeployToJMSServer1 11.
Target the subdeployment to a server resource such as a JMS server instance, WebLogic Server instance, or cluster. For example:
subDep1mb.addTargetjmsserver1mb
Example 6–1 WLST Script to Create JMS System Resources
This script starts an edit session, creates a JMS Server, targets the jms server to the server WLST is connected to and creates
a JMS System module with a jms queue and connection factory. The jms queues and topics are targeted using sub-deployments.
import sys from java.lang import System
print Starting the script ... myJmsSystemResource = CapiQueue-jms
factoryName = CConFac jmsServerName = myJMSServer
queueName = CQueue
url = sys.argv[1] usr = sys.argv[2]
password = sys.argv[3]
connectusr,password, url edit
6-4 Configuring and Managing JMS for Oracle WebLogic Server
startEdit Step 1
servermb=getMBeanServersexamplesServer if servermb is None:
print No server MBean found
else: Step 2
jmsMySystemResource = createmyJmsSystemResource,JMSSystemResource
Step 3 jmsMySystemResource.addTargetservermb
Step 4 theJMSResource = jmsMySystemResource.getJMSResource
Step 5 connfact1 = theJMSResource.createConnectionFactoryfactoryName
jmsqueue1 = theJMSResource.createQueuequeueName
Step 6 connfact1.setJNDINamefactoryName
jmsqueue1.setJNDINamequeueName
Step 7 jmsqueue1.setSubDeploymentNameDeployToJMSServer1
connfact1.setSubDeploymentNameDeployToJMSServer1
Step 8 jmsserver1mb = createjmsServerName,JMSServer
Step 9 jmsserver1mb.addTargetservermb
Step 10 subDep1mb = jmsMySystemResource.createSubDeploymentDeployToJMSServer1
Step 11 subDep1mb.addTargetjmsserver1mb
. .
.
6.3 How to Modify and Monitor JMS Servers and JMS System Module Resources