Administration Console Online Help

Previous Next Open TOC in new window
Content starts here

File Store: Configuration

Configuration Options     Related Tasks     Related Topics

Use this page to configure a disk-based file store for storing subsystem data, such as persistent JMS messages or Store-and-Forward messages.

Configuration Options

Name Description
Name

The name of this file store. This name must be unique within the WebLogic Server instance or its cluster.

Synchronous Write Policy

The disk write policy that determines how the file store writes data to disk.

This policy also affects the JMS file store's performance, scalability, and reliability. The valid policy options are:

  • Direct-Write

    Direct I/O is supported on all platforms. When available, file stores in direct I/O mode automatically load the native I/O wlfileio2 driver. This driver is available on Windows, Solaris, HP, AIX, and Linux platforms. To view a running file store's synchronous write policy and driver, check the BEA-280050 message in the server log.

  • Disabled

    Transactions are complete as soon as their writes are cached in memory, instead of waiting for the writes to successfully reach the disk. This policy is the fastest, but the least reliable (that is, transactionally safe). It can be more than 100 times faster than the other policies, but power outages or operating system failures can cause lost and/or duplicate messages.

  • Cache-Flush

    Transactions cannot complete until all of their writes have been flushed down to disk. This policy is reliable and scales well as the number of simultaneous users increases.

Target

The server instances or migratable targets defined in the current domain that are candidates for hosting the file store.

In a clustered environment, a recommended best practice is to target a custom file store to the same migratable target as the migratable JMS service, so that a member server will not be a single point of failure. A file store can also be configured to automatically migrate from an unhealthy server instance to a healthy server instance with the help of the server health monitoring services.

MBean Attribute:
PersistentStoreMBean.Targets

Directory

The path name to the file system directory where the file store maintains its data files.

When targeting a file store to a migratable target, the store directory must be accessible from all candidate server members in the migratable target. For highest availability, use either a SAN (Storage Area Network) or a dual-ported SCSI disk.

Changes take effect after you redeploy the module or restart the server.

Logical Name

The name used by subsystems to refer to different stores on different servers using the same name.

For example, an EJB that uses the timer service may refer to its store using the logical name, and this name may be valid on multiple servers in the same cluster, even if each server has a store with a different physical name.

Multiple stores in the same domain or the same cluster may share the same logical name. However, a given logical name may not be assigned to more than one store on the same server.

MBean Attribute:
FileStoreMBean.LogicalName

Related Tasks

Related Topics


Back to Top