Administration Console Online Help

    Previous Next  Open TOC in new window 
Content starts here

Create Store-and-Forward agents

The Store-and-Forward (SAF) service uses SAF agents to deliver messages reliably between applications that are distributed across WebLogic Server instances. A SAF agent can be configured to have only sending capabilities, receiving capabilities, or both. JMS SAF only requires a sending agent on the sending side for JMS messages. Whereas, WSRM SAF requires both a sending agent and a receiving agent.

To configure a SAF agent:

  1. If you have not already done so, in the Change Center of the Administration Console, click Lock & Edit (see Use the Change Center).
  2. In the left panel of the console, expand Services > Messaging and select Store-and-Forward Agents.
  3. On the Summary of Store-and-Forward Agents page, click New.

    Note: Once you create a SAF agent, you cannot rename it. Instead, you must delete it and create another one that uses the new name.

  4. On the Create a New Store-and-Forward Agent page:
    1. Name -- Name for the SAF agent.
    2. Persistent Store -- Optionally, select a persistent store from the drop-down box. Otherwise, leave this property set to None when using the default Persistent Store.
    3. Agent Type -- Select one of the following:
      • Sending-only -- Configures an agent that stores messages in persistent storage, forwards messages to the receiving side, and re-transmitts messages when acknowledgements do not come back in time.
      • Receiving-only -- Configures an agent that detects and eliminates duplicate messages sent by a receiving agent, and delivers messages to the final destination.
      • Both -- Configures an agent that has sending and receiving agent functionality.

    Note: JMS SAF users should select Sending-only since JMS SAF doesn't require a configured receiving agent.

  5. Click Next.
  6. On the Selects Targets page, select the cluster or server instance(s) where you want to deploy the SAF agent.
  7. Click Finish.
  8. Configure persistent stores.

    The default persistent store requires no additional configuration. However, if you require a custom file store or JDBC store to suit your specific needs, you need to create the custom store before creating a path service.

  9. To activate these changes, in the Change Center of the Administration Console, click Activate Changes.
    Not all changes take effect immediately—some require a restart (see Use the Change Center).

After you finish

You can optionally configure additional properties for the new SAF agent, such as basic and advanced general properties, thresholds and quotas, or log file rotation parameters.

  Back to Top