Administration Console Online Help

Previous Next Open TOC in new window
Content starts here

Change SAF agent targets

After you create a SAF agent, you can retarget it to a different server instance, cluster, or migratable target in your domain.

To retarget your SAF agent to a different server instance, cluster, or migratable target:

  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 Store-and-Forward Agents page, select the SAF agent that you want to assign to a server, cluster, or migratable target.

    A dialog displays in the right pane showing the tabs associated with the SAF agent.

  4. Select the Targets tab to display the following targeting options.
    1. Independent Servers -- Select a server where the SAF agent will be deployed. A SAF agent can only be targeted to a single server in a domain.
    2. Clusters -- Recommended for high availability. Select a cluster where the SAF agent will be deployed. Requires a custom store with Distribution Policy of Distributed and is targeted to the same cluster. See Configure custom persistent stores.
    3. Migratable Targets -- Select a WebLogic Server migratable target where the SAF agent will be deployed. When WebLogic Server is first booted, the SAF agent is initially available only on the user-preferred server. After that, the SAF agent can be migrated to another server listed in the migratable target.

      Caution: To preserve SAF message consistency, WebLogic Server prevents you from retargeting an existing SAF agent to a migratable target. Instead, you must delete the existing SAF agent and configure a new one with the same values and target it to a migratable target.

      Note: When a SAF agent is targeted to a migratable target, it cannot use the default store, so a custom store must be configured and targeted to the same migratable target. In addition, a migratable SAF agent cannot be targeted to any other targets, including an entire cluster. Therefore, if you want to increase throughput by importing a JMS destination to multiple SAF agents on separate servers in a cluster, then create a migratable target for each server in the cluster, and then create separate SAF agents and target them to each migratable target.

      For more information on configuring a migratable target for SAF agents, see Configure migratable targets for JMS-related services.

  5. Select a target on which to deploy the SAF agent.
  6. Click Save.
  7. 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

If you change a SAF agent target, you must stop and restart WebLogic Server.

Back to Top