This page displays the default values for mount options whose values have not been explicitly set. If you have explicitly set values and you want to revert to the default values, delete the existing value in the field that you want to change and click Save.
This page consists of several sections, each of which has a related set of values:
The following table describes the fields in the Basic section of the File System Edit Mount Options page. The fields displayed in this section vary, depending on how the file system is configured.
Field |
Applicable File Systems |
Description |
---|---|---|
High Water Mark |
Archiving file systems |
A percentage of the total disk space. When online disk consumption exceeds the High Water Mark, the archiving file system automatically begins releasing the disk space occupied by eligible archived files. Disk space occupied by archived file data is released until the Low Water Mark is reached. |
Low Water Mark |
Archiving file systems |
A percentage of the total disk space. The releaser continues to release files as long as the archiving file system remains above the configured Low Water Mark. |
Stripe Width |
All file systems |
The stripe width for the file system. A segmented file is automatically striped across several volumes when it is archived. The value you enter in this field is multiplied by the disk allocation unit (DAU) value. This number of bytes is then written to one logical device before switching to the next device when the segmented file is archived. |
Enable Tracing for File System |
All file systems |
Enables or disables file system tracing. |
This section is displayed only if you are viewing a shared file system. You can edit mount options only on the metadata server of a shared file system.
The following table describes the menus and fields in the Shared QFS section of the File System Edit Mount Options page.
Field |
Description |
---|---|
Mount in Background |
Specifies whether, if the first mount attempt of the file system fails, the system will try again to mount the file system in the background or in the foreground. For shared file systems, background is the suggested value. |
Mount Retries |
The number of times the system will retry the mount operation. By default, the value is 10000. |
Metadata Refresh |
The number of seconds that can elapse before metadata is checked for modification. |
Minimum Block Allocation |
The smallest number of bytes that is allocated ahead of a write for the file system. The value must be specified as a multiple of 8 Kbytes. By default, the value is 8 Kbytes multiplied by the disk allocation unit (DAU Size) value. |
Maximum Block Allocation |
The largest number of bytes that is allocated ahead of a write for the file system. The value must be specified as a multiple of 8 Kbytes. By default, the value is 128 Kbytes multiplied by the DAU Size value. |
Read Lease Duration |
The longest period, in seconds, during which a file can be read before the host must reacquire the read lease. By default, the value is 30 seconds. A host obtains a lease, after which the files on the host can be read, written, or appended, depending on the lease type. When the lease expires, the host must get a new lease. |
Write Lease Duration |
The longest period, in seconds, during which a file can be written before the host must reacquire the write lease. By default, the value is 30 seconds. Unless the Multihost Write option is selected on the metadata server, only one host can write to a file at one time. If the Multihost Write option is selected on the metadata server, multiple hosts can write to and read from the same file at the same time. If multiple hosts are writing, the last write is the one that is effective. |
Append Lease Duration |
The longest period, in seconds, during which one host can append to a file before the host must reacquire the append lease. Only one host can append to a file at one time. By default, the value is 30 seconds. |
Minimum Number of Threads |
The number of shared file system threads grows and shrinks dynamically based on load. This parameter sets the minimum number of threads to keep in the active pool. The allowed range is 8 to 2048 and the default value is 64. |
Multi-host Write |
This option is effective only on the metadata server that specifies whether simultaneous reads from and writes to the same file from multiple hosts can occur. If this option is enabled, the file system switches all hosts to use direct I/O. In this situation, the application must use page-aligned memory buffers and well-formed sector I/O (512 bytes). Caution - If the application does not use page-aligned memory buffers and well-formed sector I/O when this option is enabled, data corruption might occur. |
Synchronized Metadata |
Whether metadata is written to disk every time the metadata changes. If you want failover to occur, you must select this option. If you do not select the option, metadata is held in a buffer before being written to disk. This delayed write delivers high performance, but without the ability to failover. |
Check Attribute Consistency |
Enables or disables attribute consistency checking. If you enable this option, the file system ensures that attribute changes made by a host that is modifying a file are visible to other hosts within the metadata refresh interval. (Directories are not affected by this option; directory modifications are always visible within the time interval set by metadata refresh.) By default, this option is disabled, and changes made by a host-file size and modification time in particular-may not be visible to other hosts until the write or append lease time has expired. |
Metadata Stripe |
The number of 16-Kbyte disk allocation units (DAU) that define the metadata stripe width for the file system. If you type 1 as the value, one DAU of metadata is written to one logical device before switching to the next device. If you specify 0, files are round-robined on each slice. By default, the value is 0 for shared file systems. |
Lease Timeout |
The number of seconds after which the read, write, and/or append lease for a single file is relinquished if it is not being used. The lease timeout range is -1 to 15 seconds. The default is 1 second. If you set the lease timeout to -1, the lease is not relinquished and the lease expires based on the lease time. If the multi-host write option is enabled, the read and write lease is not relinquished because multiple read and write hosts are enabled. |
The information in this section is displayed only for archiving file systems. The following table describes the menus and fields in the Archive Properties section of the File System Edit Mount Options page.
Field |
Description |
---|---|
Maximum Partial Size |
The largest number of bytes at the beginning of a file that are retained on disk cache when the file's disk space is released. Retaining the first portion of a file on disk cache provides speedy access to the file and masks staging delays. |
Partial Release Size |
The default number of bytes at the beginning of a file that are retained on disk cache when the file is released. This value can be between 8 Kbytes and the Maximum Partial Size value. This value can be overridden on a file-by-file basis. |
Partial Stage Size |
The number of bytes that when accessed by a user, cause the entire file to be staged. |
Stage Retries |
The number of stage retries attempted per archive copy when certain errors are encountered. |
Stage Window Size |
The size of a file that is staged into an application's buffer at any one time for files that are read directly from archive media. |
Run Archive When High Water Mark is Encountered |
Invokes the archiver when the amount of data in the file system increases above the specified High-Water Mark value. |
The following table describes the menus and fields in the General File System section of the File System Edit Mount Options page.
Field |
Description |
---|---|
Mount Read-Only |
Mounts the file system as read-only. |
No Set UID |
Enables or disables execution of setuid , which sets the numeric user ID of the owner of the file. |
Quick Write |
Enables simultaneous reads from and writes to the same file from different threads. |
The following table describes the menus and fields in the Performance Tuning Options section of the File System Edit Mount Options page.
Field |
Applicable File Systems |
Description |
---|---|---|
Read Ahead |
The maximum number of bytes that can be read ahead by the file system. The value must be a multiple of 8. The default is 1024 Kbytes. |
|
Write Behind |
The maximum number of bytes that can be written behind by the file system. The value must be a multiple of 8. The default is 512 Kbytes. |
|
Write Throttle |
The maximum number of outstanding write bytes for one file. The default is 16,384 Kbytes. |
|
Flush Behind |
The maximum flush-behind value. When this option is selected, modified pages that are being written sequentially are written to disk asynchronously to help the Solaris Volume Manager layer keep the pages clean. The default is 0, which disables the flush-behind option. |
|
Stage Flush Behind |
Archiving File Systems |
The maximum stage flush-behind value. Stage pages that are being staged are written to disk asynchronously to help the Solaris Volume Manager layer keep pages clean. The default is 0, which disables the stage flush-behind option. |
Software RAID |
Causes the file system to align the write-behind buffer. Enable this option if the software RAID feature of packages such as Solaris Volume Manager is being used on this file system. By default, the software RAID option is disabled. |
|
Force Direct I/O |
Specifies direct I/O as the default I/O mode. This means that data is transferred directly between the user's buffer and disk. Enable this option only if the file system is used for large block-aligned sequential I/O. |
|
Force NFS Asynchronous |
Causes the file system to cache NFS data written to the server even if NFS has requested that the data be written synchronously through to disk. This option is useful only if the file system is mounted as an NFS server and the clients have set the NFS mount option noac . The default NFS noac behavior without the force NFS asynchronous option causes data to be synchronously written through to disk. Caution - The force NFS asynchronous option violates the NFS protocol. Enable this option with care. When this option is enabled, data is cached on the server. The data is not immediately seen by all clients if there are multiple NFS servers, which you can enable with shared QFS. |
The following options enable you to change the type of I/O for a file based on I/O size and history. If direct I/O is specified, these options are ignored and all I/O to regular files is direct, if possible. Well-aligned I/O occurs when a file offset falls on a 512-byte boundary and when the length of the I/O transfer is at least 512 bytes.
The following table describes the columns in the Direct I/O Discovery section of the File System Edit Mount Options page.
Field |
Description |
---|---|
Consecutive Reads |
The number of consecutive I/O transfers with a buffer size greater than the specified lower limit for aligned reads or misaligned reads. By default, the value is 0, which means that no default direct reads occur based on I/O sizes. |
Well-Aligned Read Minimum |
A value that sets the read well-aligned limit to a number of 1024-byte blocks. The default is 256, which means 256 blocks that are 1024 bytes in size. If you type 0 as the value, automatic I/O type switching for well-aligned reads is disabled. |
Mis-Aligned Read Minimum |
A value that sets the read misaligned lower limit to a number of 1024-byte blocks. The default is 0, which disables automatic I/O type switching for misaligned reads. |
Consecutive Writes |
The number of consecutive I/O transfers with a buffer size above the specified lower limit for aligned writes or misaligned writes. The default is 0, which means that no default direct writes occur. |
Well-Aligned Write Minimum |
A value that sets the write well-aligned lower limit to a number of 1024-byte blocks. The default is 256, which means 256 blocks that are 1024 bytes in size. If you type 0 as the value, automatic I/O type switching for well-aligned writes is disabled. |
Mis-Aligned Write Minimum |
A value that sets the write misaligned lower limit to a number of 1024-byte blocks. The default is 0, which disables automatic I/O type switching for misaligned writes. |
Initial Sparse Files to Zero |
If you enable this option, uninitialized areas of sparse files written with direct I/O are zeroed when the area is accessed. This makes the sparse file behavior the same as that for paged I/O. By default, this option is disabled and sparse files written by direct I/O do not have the uninitialized areas zeroed for performance reasons. |