JMS Configuration

JMS configuration involves setting up JMS queues which will received inbound usage readings and device events. The JMS queues need to be created first on the application server where the OSB component is deployed. This server is referred to as remote server in the sections below. In the following section the JMS queue on the remote server is assumed to be created with the name DestinationQueueWatch-CM.

Note: The JMS changes described in the following sections are not persistent during patches or upgrades. They will need to be re-created after applying any patches or upgrades to Oracle Utilities Smart Grid Gateway. It is recommended to keep a backup of the $SPLEBASE/splapp/config.xml file.

Create a new JMS Module

Log in to the Oracle Utilities Smart Grid Gateway Weblogic console and create a JMS Module with an appropriate name. Specify the following values for this JMS module:

  • Name: the name of JMS module. For example, JMSModule-CM
  • Target: the name of the target server where the Oracle Utilities Smart Grid Gateway application is running. This should be specified as myserver.

Create a Foreign JMS Server

Create a Foreign JMS server under the JMS module created in the above step. Specify the following values for this foreign JMS server:

  • Name: Name of the foreign server. For example, JMSFAServer-CM
  • Target: This should be specified as myserver
  • JNDI Initial Context Factory: This should be specified as weblogic.jndi.WLInitialContextFactory
  • JNDI Connection URL: The URL of the server where OSB is deployed. For example: t3://osbserver:7001
  • JNDI Properties Credential: Password for the OSB server user
  • JNDI Properties: The java.naming.security.principal additional property should be specified and set to the OSB server user. For example, java.naming.security.principal=weblogic

Create a Foreign Destination

Create a Foreign destination for each remote queue. Specify the following values for this foreign destination:

  • Name: Name of foreign destination. For instance, DestinationQueue-CM
  • Local JNDI Name: Local JNDI name for the foreign JMS queue. For example, ForeignDestinationQueue-CM
  • Remote JNDI Name: JNDI name of the queue on the remote server. For example, DestinationQueueWatch-CM

Create a Remote Connection Factory

Create a remote connection factory for the foreign JMS server. Specify the following values for this remote connection factory:

  • Name: Name of remote connection factory. For example, DestinationQueueConnectionFactory-CM
  • Local JNDI Name: Local JNDI name for the Remote Connection Factory. For example, ForegnDestinationQueueConnectionFactory-CM
  • Remote JNDI Name: JNDI name of the JMS Connection Factory on the remote server. For example, weblogic.jms.XAConnectionFactory