Index Index for
Section 5
Index Alphabetical
listing for S
Index Bottom of
page

sys_attrs_cfs(5)

NAME

sys_attrs_cfs - cfs subsystem attributes

DESCRIPTION

This reference page lists and describes attributes for the cluster file system (cfs) kernel subsystem. Refer to the sys_attrs(5) reference page for an introduction to the topic of kernel subsystem attributes. cnode_hash_size Size of the hash table used to hold CFS-type vnodes (cnodes). Set this attribute relative to the maximum number of vnodes (files) allowed in the system. You can learn this number with the following command: sysconfig -q vfs max-vnodes Supported operations: Query; Configure at boot time Default value: If a value is not explicitly set in /etc/sysconfigtab, a value is calculated by dividing the value of max-vnodes by 12. If the result is even, 1 is added to it to make cnode_hash_size odd. This is done to improve hashing performance. The result is 12 cnodes on each hash chain (on average). This is appropriate for most cases. Minimum value: 64 Maximum value: 16384 blkrsrv_save_percent The percent of total space saved for block reservation. If free space reaches this number, all write operations are sent to the CFS server. Supported operations: Query; Configure at boot time Default value: 10 Minimum value: 5 Maximum value: 100 cfsdbg_place Enables and disables the debugging of certain sections of CFS client and server code. Do not modify the default setting for this attribute unless instructed to do so by support personnel or by patch kit documentation. Supported operations: Query; Configure at boot time; Reconfigure at run time Default value: 768 Minimum value: -9223372036854775808 Maximum value: 9223372036854775807 cfsdbg_flags Specifies which code sections are to be debugged and how the debug messages are output. Do not modify the default setting for this attribute unless instructed to do so by support personnel or by patch kit documentation. Supported operations: Query; Configure at boot time; Reconfigure at run time Default value: 0 Minimum value: -9223372036854775808 Maximum value: 9223372036854775807 cfslog_max_size Maximum size of the CFS event trace log. Supported operations: Query; Configure at boot time; Reconfigure at run time Do not modify the default setting for this attribute unless instructed to do so by support personnel or by patch kit documentation. Default value: 81920 Minimum value: 8192 Maximum value: 1638400 cfslog_timestamp If set to 1, prepend timestamp, command name and thread ID to messages written to the CFS event trace log. Do not modify the default setting for this attribute unless instructed to do so by support personnel or by patch kit documentation. Supported operations: Query; Configure at boot time; Reconfigure at run time Default value: 1 Minimum value: -2147483648 Maximum value: 2147483647 cfsdbg_timeout Number of seconds before a CFS thread that is hung waiting for a token is timed out. Do not modify the default setting for this attribute unless instructed to do so by support personnel or by patch kit documentation. Supported operations: Query; Configure at boot time; Reconfigure at run time Default value: 4 Minimum value: -9223372036854775808 Maximum value: 9223372036854775807 cfsdbg_dopanic When set to 1, panics this member on certain CFS failures. Otherwise, the failures are logged to the CFS event trace log. Do not modify the default setting for this attribute unless instructed to do so by support personnel or by patch kit documentation. Supported operations: Query; Configure at boot time; Reconfigure at run time Default value: 0 Minimum value: -9223372036854775808 Maximum value: 9223372036854775807 cfsdbg_tokenlog When set to 1, turns on CFS client and server token logging. Do not modify the default setting for this attribute unless instructed to do so by support personnel or by patch kit documentation. Supported operations: Query; Configure at boot time; Reconfigure at run time Default value: 3 Minimum value: -2147483648 Maximum value: 2147483647 cfsdbg_svrtok_size Size in bytes of server token log. Do not modify the default setting for this attribute unless instructed to do so by support personnel or by patch kit documentation. Supported operations: Query; Configure at boot time; Reconfigure at run time Default value: 2000 Minimum value: -2147483648 Maximum value: 2147483647 cfsdbg_clitok_size Size in bytes of client token log. Do not modify the default setting for this attribute unless instructed to do so by support personnel or by patch kit documentation. Supported operations: Query; Configure at boot time; Reconfigure at run time Default value: 1000 Minimum value: -2147483648 Maximum value: 2147483647 svrcfstok_max_percent Percentage of memory that can be used by the token data structures on a CFS server. The svrcfstok_max_percent attribute sets an upper limit on the amount of memory used by a CFS server to track vnode caching on clients. Without this attribute, the only limit is the number of vnodes that can be created at CFS client nodes. If the number of CFS clients is large and a single cluster member serves many file systems, the server could run out of memory and hang. Supported operations: Query; Configure at boot time Default value: 25 Minimum value: 5 Maximum value: 50 The default value is well suited for most situations. For more information, see the TruCluster Server Administration manual. no_sync_on_panic On large configurations, the synchronization of file systems can take considerable time, slowing failover. However, if no synchronization is done, data not flushed to disk is lost if the data originated from an application on the panicking member. Data originating from an application on a remote, surviving member still exist on that member and is rescheduled when a new server for the file system is selected. The default, 0 (zero), allows writing buffers when the system panic. When no_sync_on_panic is 1, the normal process of attempting to write modified buffers back to disk when the system panics is disabled. File corruption can result. Do not modify the default setting for this attribute unless instructed to do so by support personnel or by patch kit documentation. Supported operations: Query; Configure at boot time; Reconfigure at run time Default value: 0 Minimum value: 0 Maximum value: 1 cfstok_ctokhold_cache_limit Maximum number of cached objects on the token hold freelist. Do not modify the default setting for this attribute unless instructed to do so by support personnel or by patch kit documentation. Supported operations: Query; Configure at boot time Default value: 1024 Minimum value: -2147483648 Maximum value: 2147483647 cfstok_ctok_req_cache_limit Maximum number of cached objects on the token request freelist. Do not modify the default setting for this attribute unless instructed to do so by support personnel or by patch kit documentation. Supported operations: Query; Configure at boot time Default value: 512 Minimum value: -2147483648 Maximum value: 2147483647 cfstok_ctok_rev_cache_limit Maximum number of cached objects on the token revoke freelist. Do not modify the default setting for this attribute unless instructed to do so by support personnel or by patch kit documentation. Supported operations: Query; Configure at boot time Default value: 256 Minimum value: -2147483648 Maximum value: 2147483647 bread The bread attribute enables an optimization that eliminates a data copy for NFS read requests. There should be no reason to change this attribute from its default value. Supported operations: Query; Configure at boot time; Reconfigure at run time Default value: 1 Minimum value: 0 Maximum value: 1 cfs_async_biod_threads Controls the number of threads on the member that do read-aheads for applications that perform sequential reads. The read aheads are performed only on CFS clients (not the CFS server). Setting this attribute may be useful in an environment in which sequential read performance of large files is important. By default, CFS reads in 64 KB chunks. A read-ahead thread is useful when a file has multiple 64 KB chunks that are read sequentially. If there are more than 15 such files that are being read at the same time, increasing the value of this attribute may be useful. Supported operations: Query; Configure at boot time; Reconfigure at run time Default value: 15 Minimum value: 0 Maximum value: 128 cfsiosize The cfsiosize attribute controls the amount of data that is processed per pass through the client side I/O code path. The value is in kilobytes. Making cfsiosize large results in more data being proceesed per pass. Typically, this yields better performance. To set the I/O size for a specific file system, overriding the effect of cfsiosize on that file system, use the cfsmgr command to set the FSBSIZE attribute for the file system. See cfsmgr(8) for more information. Supported operations: Query; Configure at boot time; Reconfigure at run time Default value: 65536 Minimum value: 8192 Maximum value: 131072

SEE ALSO

sys_attrs(5), cfsmgr(8) TruCluster Server Cluster Administration

Index Index for
Section 5
Index Alphabetical
listing for S
Index Top of
page