WebSphere WebSphere Application Server Version 6.1.x Feature Pack for Web Services Operating Systems: AIX, HP-UX, i5/OS, Linux, Solaris, Windows, z/OS

File store configuration attributes

Preserving the appropriate amount of space within log file, permanent store file, and temporary store file of a file store helps to ensure that operations and transactions behave predictably.

Data is first written to the log file sequentially, that is, new records are added to the end of the file. When the end of the log file is reached, old records at the beginning of the log file are overwritten by new records and this process repeats. Subsequently, data is written to the permanent store file and temporary store file. The exception is extremely short-lived data, which is only written to the log file.

The permanent store file and temporary store file each have a minimum reserved size and a maximum size. When they are created, the permanent and temporary store files consume their minimum reserved sizes, plus the size of the log. If the maximum size is set to a larger value than the minimum reserved size, the files grow up to the maximum size as required.

The default settings for the minimum and maximum sizes are most suitable if you are not using a dedicated disk for your file store because they protect the file store from other disk users, and also protect other disk users from the file store. The default settings are less appropriate if you have a disk that is dedicated to file store use, and in this case you might want to consider setting the maximum size set to unlimited.

If your file store is not on a dedicated disk, consider making the minimum and maximum sizes the same. Initially, the message store reserves the amount of space defined by the minimum setting. Therefore, if you use the same value for the maximum and minimum settings, this reduces the likelihood of other applications using disk space that you had intended for file store use. Setting the maximum size to a value other than unlimited reduces the likelihood of the file store using disk space that you had intended for use by other applications. Other applications can include, for example, the application server itself.

The default configuration for file store attributes is intended to be sufficient to be used in typical messaging workloads without any administration. To improve the performance or availability of the log or the two store files, the administrator can modify the file store attributes to control where these files are placed. Similarly, the administrator can modify the attributes which control the sizes of the log and two store files to handle workloads with a large number of active transactions, large messages or a large volume of message data resident in the messaging engine.

Note: This behavior cannot be guaranteed on a compressing file system, for example, on an NT file system with the Compress this directory option selected. You should avoid configuring a file store to use a compressing file system for production use.

The following table shows the minimum and default values for file store attributes.

Table 1. File store attributes and values
Name Description Minimum and Default Values in mega bytes
Log size Size of the log file, in mega bytes
  • Minimum: 10 MB
  • Default: 100 MB
Minimum permanent store size The minimum number of mega bytes reserved by the permanent store file.
Note: The store files must always be at least as big as the log file.
  • Minimum: 0
  • Default: 200 MB
Maximum permanent store size The maximum size in mega bytes of the permanent store file.
Note: The store files must always be at least as big as the log file.
  • Minimum: 50 MB
  • Default: 500 MB
Minimum temporary store size The minimum number of mega bytes reserved by the temporary store file.
Note: The store files must always be at least as big as the log file.
  • Minimum: 0
  • Default: 200 MB
Maximum temporary store size The maximum size in mega bytes of the temporary store file.
Note: The store files must always be at least as big as the log file.
  • Minimum: 50 MB
  • Default: 500 MB
Unlimited permanent store size Indicates whether the permanent store file is unlimited in size
  • Default: false
Unlimited temporary store size Indicates whether the temporary store file is unlimited in size
  • Default: false
Log directory Name of the directory that the log file is in
  • Default: ${USER_INSTALL_ROOT}/filestores/com.ibm.ws.sib/<me_name>.<me_build>/log
Permanent store directory Name of the permanent store file's directory
  • Default: ${USER_INSTALL_ROOT}/filestores/com.ibm.ws.sib/<me_name>.<me_build>/permanentStore
Temporary store directory Name of the temporary store file's directory
  • Default: ${USER_INSTALL_ROOT}/filestores/com.ibm.ws.sib/<me_name>.<me_build>/temporaryStore
Related tasks
Modifying file store configuration

Concept topic

Terms of use | Feedback


Timestamp icon Last updated: 27 November 2008
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/com.ibm.websphere.pmc.wsfep.multiplatform.doc/concepts/cjm1450_.html

Copyright IBM Corporation 2004, 2008. All Rights Reserved.
This information center is powered by Eclipse technology. (http://www.eclipse.org)