1. Administering Oracle SOA Cloud Service
  2. Administer Oracle SOA Cloud Service
  3. Configure User Messaging Service on a Cluster

Configure User Messaging Service on a Cluster

To configure email settings using User Messaging Service (UMS), UMS must be set up on your SOA servers and the UMS adapter configured for your Oracle SOA Cloud Service instance.

If not already done, configure User Messaging Service (UMS) on a cluster:
  1. Log in to the Oracle WebLogic Server Administration console.
  2. Navigate to Home, then Summary of Deployments.
  3. If the UMS adapter is not created, follow the steps in Create the User Messaging Service JMS Server to create a UMS JMS server.
  4. Navigate to Home, then Summary of Deployments, and click UMSJMSSystemResource.
  5. Click Lock and Edit if not already in edit mode and then click New.
  6. Select Distributed Queue and click Next.
  7. Provide the distributed queue name and the JNDI name.
    Queue Name JNDI Name

    dist_OraSDPM/Queues/OraSDPMAppDefRcvErrorQ1_auto

    OraSDPM/Queues/OraSDPMAppDefRcvErrorQ1

    dist_OraSDPM/Queues/OraSDPMAppDefRcvQ1_auto

    OraSDPM/Queues/OraSDPMAppDefRcvQ1

    dist_OraSDPM/Queues/OraSDPMDriverDefSndQ1_auto

    OraSDPM/Queues/OraSDPMDriverDefSndQ1

    dist_OraSDPM/Queues/OraSDPMEngineCmdQ_auto

    OraSDPM/Queues/OraSDPMEngineCmdQ

    dist_OraSDPM/Queues/OraSDPMEnginePendingRcvQ_auto

    OraSDPM/Queues/OraSDPMEnginePendingRcvQ

    dist_OraSDPM/Queues/OraSDPMEngineRcvQ1_auto

    OraSDPM/Queues/OraSDPMEngineRcvQ1

    dist_OraSDPM/Queues/OraSDPMEngineSndQ1_auto

    OraSDPM/Queues/OraSDPMEngineSndQ1

    dist_OraSDPM/Queues/OraSDPMWSRcvQ1_auto

    OraSDPM/Queues/OraSDPMWSRcvQ1

    Description of jndi_cluster.png follows
    Description of the illustration jndi_cluster.png
  8. Select the UMSJMSSubdeployment from the dropdown list. If the subdeployment is not created, follow the steps in Create a Subdeployment to create the subdeployment.
  9. Select the UMSJMSServer and click Finish.
  10. Create all the queues given in the table and click Apply.
  11. Navigate to Home, then Summary of Deployments and verify if the UMSAdapter deployment is displayed. If the UMSAdapter is not in active state, follow the steps in Deploy a User Messaging Service Adapter to deploy the UMS adapter.

Create the User Messaging Service JMS Server

On a cluster, you would need to create two or more UMS JMS servers, one for each of the servers in the cluster.

  1. Log in to the WebLogic Server Administration Console.
  2. Go to the Summary of JMS servers section and click New.
  3. Enter the name of the User Messaging Service JMS server and its scope, and click Next.
  4. Select a persistent store from the drop down list and click Next. If the persistent store is not available, follow the steps in Create a Persistent Store to create a persistent store.
  5. Select a target for the UMS JMS server and save the changes.
Repeat the steps for the other UMS servers in the cluster.

Create a Persistent Store

Create two or more User Messaging Service persistent stores, one for each of the nodes in the cluster.

  1. Log in to Oracle Weblogic Server Administration console.
  2. In the left pane of the console, expand Services and select Persistent Stores.
  3. On the Summary of Persistent Stores page, click New and then Create JDBC Store.
  4. On the Create a new JDBC Store page, update the following:

    • Name -- Enter a name for the JDBC Store.

    • Scope -- Specify the scope of the JDBC Store.

    • Prefix Name -- Specify a prefix name to prepend to the table name in this JDBC store for use with multiple instances.

  5. Click Finish.
Repeat the steps for other persistent stores based on the servers available in the cluster.

Create a Subdeployment

Configure the mail driver for outgoing mails using the Universal Messaging Server.

  1. Log in to Oracle Weblogic Server Administation console.
  2. In the left pane of the console, expand Services then Messaging, and select JMS Modules.
  3. Expand JMS modules and select UMSJMSSystemResource.
  4. Click Test to test the driver configuration.
  5. Click the Subdeployments tab and click the New button in the Subdeployments table.
  6. On the Subdeployment Properties page, enter a name for the subdeployment. and click Next.
  7. On the Targets page, select both the UMS JMS servers and click Save.

Deploy a User Messaging Service Adapter

If the User Messaging Service adapter is not in active state, delete and redeploy the adapter.

  1. Log in to the Oracle Weblogic Server Administration console.
  2. Navigate to Home, then Summary of Deployments.
  3. If the User Messaging Service adapter is not in active state, select the check box against the UMS Adapter and click Delete.
  4. Click Install, select the UMS Adapter RAR file in the following location: $DOMAIN_HOME/soa/soa/connectors/UMSAdapter.rar.
  5. Select the cluster from the available targets, click Next and Finish.
  6. Activate all changes.
  7. Restart the Administration Server and Managed Servers from the Oracle SOA Cloud Service Console. See Restart the Administration Server VM and Stop, Start, or Restart Managed Server and Load Balancer VMs.