edocs Home > BEA WebLogic Server 10.0 Documentation > Administration Console Online Help > Create path services

Administration Console Online Help

    Previous Next  Open TOC in new window 
Content starts here

Create path services

Before you begin


A path service is persistent map that can be used to store the mapping of a group of messages to a messaging resource, such as a member of a distributed destination or a store-and-forward agent. It provides a way to enforce message ordering by pinning messages to a member of a cluster hosting servlets, distributed queue members, or store-and-forward agents.

In a clustered server environment, a path service can targeted to a migratable target. A migratable target is a special target that can serve as a grouping of migratable JMS services, such as a path service, and which is active on only server member in a WebLogic cluster. In a cluster, a recommended best practice is to target a path service to a migratable target, so that a member server will not be a single point of failure. This way the path service can be manually migrated from an unhealthy server onto a healthy server, either in the event of server crash or for scheduled maintenance.

To create a path service:

  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 pane of the console, expand Services and select Path Services.
  3. On the Summary of Path Services page, click New.

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

  4. On the Create a New Path Service page:
    1. Name -- Name for the path service.
    2. Persistent Store -- Select a custom persistent store if you want a dedicated store for the path service or click Create a New Store to configure a new custom store. Otherwise, leave this field set to None when using the default Persistent Store since it requires no configuration. For more information about configuring stores, see Configure persistent stores.

      Note: When a path service is targeted to a migratable target (see Step 4), it cannot use the default store, so a custom store must be configured and targeted to the same migratable target. And, as a best practice, the path service and its store should be the only users of that migratable target.

    3. Click Next.
  5. On the Selects Targets page, select a cluster member or migratable target where you want to deploy the path service.

    A migratable target is a special target that can serve as a grouping of JMS-related services, such as a path service, and which is active on only server member in a WebLogic cluster. In a cluster, a recommended best practice is to target a path service to a migratable target, so that a member server will not be a single point of failure. See Configure migratable targets for JMS-related services.

    Note: When a path service is targeted to a migratable target, it cannot use the default store, so a store must be configured and targeted to the same migratable target. As an additional best practice, the Path Service and its store should be the only users of that migratable target.

  6. Click Finish.
  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


  Back to Top