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

sys_attrs_dlm(5)

NAME

sys_attrs_dlm - dlm subsystem attributes

DESCRIPTION

This reference page lists and describes attributes for the distributed lock manager (dlm) kernel subsystem. Refer to the sys_attrs(5) reference page for an introduction to the topic of kernel subsystem attributes. dlm_name Name and version number of the DLM. For TruCluster Server Version 5.1A this value is "Distributed Lock Manager - V2.0". dlm_lkbs_allocated Number of active locks on this member system. The value of this attribute accounts for all copies of locks on this node. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 0 dlm_rsbs_allocated Number of resources mastered on this member system. Each resource name is represented by a resource block. When a process on the local system has a lock on a given resource, a resource block exists on both the system that is the resource's master and on the local system. The locks on a given resource are represented by a chain of lock blocks connected to the resource block. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 0 dlm_tot_lkids Total number of lock IDs on this cluster member. Each member system has its own lock ID table, which describes each lock block that is in use on that system. Each allocated lock block is identified by a lock ID handle. The DLM uses this table to quickly access lock blocks. Supported operations: Query Default value: 8191 Minimum value: 0 Maximum value: 0 dlm_lkids_inuse Number of lock IDs actually in use on this member system. This value matches the number of active locks (dlm_lkbs_allocated). Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 0 dlm_ddlckq_len Number of locks currently on the deadlock queue. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 0 dlm_timeoutq_len Number of locks currently on the timeout queue. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 0 dlm_lock_in Number of new lock requests from other cluster members to this member. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 0 dlm_lock_loc Number of new lock requests that are mastered on this member system. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 0 dlm_lock_out Number of new lock requests from this member to locks mastered on other member systems. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 0 dlm_mng_local Number of new lock requests from this member to either the director or other member systems thought to be the lock master. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 0 dlm_resend Number of new lock requests sent from this member to other member systems that resulted in a resend response. A cluster member returns a resend response when it is not, or is no longer, the master for the requested lock. For example, this can happen when the lock's master is transitioning from one system to another. A high number of resend responses indicates that the lock master is moving from member to member, which affects performance. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 0 dlm_retry Number of new lock requests sent from this member to other member systems that resulted in a retry response. For example, a cluster member returns a retry response, for instance, when it has insufficient resources to satisfy the request, or if a lock rebuild started when the request was being sent. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 0 dlm_cvt_in Number of lock conversion requests from other member systems to this member as the resource master. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 0 dlm_cvt_loc Number of lock conversion requests for resources mastered locally. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 0 dlm_cvt_out Number of lock conversion requests from this member to locks mastered on other member systems. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 0 dlm_unlock_in Number of unlock requests from other cluster members to this member as the resource master. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 0 dlm_unlock_loc Number of unlock requests for resources mastered locally. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 0 dlm_unlock_out Number of unlock requests from this member to locks mastered on other member systems. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 0 dlm_blk_in Number of blocking notifications sent from member systems mastering resources to processes on the local system. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 0 dlm_blk_loc Number of blocking notifications sent to processes on the local system for resources mastered on the local system. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 0 dlm_blk_out Number of blocking notifications sent to processes on other systems for resources mastered on the local system. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 0 dlm_dir_in Number of times the local node received new lock requests as the directory node. This usually results in a resend request or a message to the requestor to master the lock locally. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 0 dlm_dir_out Number of requests the local node has sent to other directory nodes. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 0 dlm_timeo_lks Number of locks that have timed out (that is, have not been granted within the timeout interval specified on the initial request). Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 0 dlm_ddlck_in Number of deadlock search requests involving locks or processes on the local system. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 0 dlm_ddlck_out Number of deadlock search requests from this member to other member systems. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 0 dlm_ddlck_srch Number of deadlock searches that have occurred on the local system. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 0 dlm_ddlck_cvt_fnd Number of conversion deadlocks detected on the local system. Conversion deadlocks are described in the TruCluster Server Cluster Highly Available Applications manual. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 0 dlm_ddlck_res_fnd Number of multiple resource deadlocks found on the local system. Multiple resource deadlocks are described in the TruCluster Server Cluster Highly Available Applications manual. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 0 dlm_notqd Number of lock requests that were not queued (that is, those requests that either were granted or will be granted). Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 0 dlm_wait Number of new lock requests that were placed on the waiting queue of the resource. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 0 dlm_cvt_wait Number of conversion lock requests that were placed on the conversion queue of the resource. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 0 dlm_collect_zero Number of times a process attempted to collect a blocking notification after the blocking notification had been cancelled or delivered. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 0 dlm_no_msg_mem Number of times the DLM has failed in an attempt to allocated memory for a message. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 0 dlm_expand_lkid_tbl Indicates the number of times the DLM had to expand the lock ID segment table (an array of pointers to lock ID segments). Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 0 dlm_add_lkid_seg Indicates the number of times the DLM had to allocate memory for another block (segment) of lock ID handles. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 0 dlm_pdbs_allocated Number of processes running on this cluster member that are using the DLM. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 4294967295 dlm_kpdbs_allocated This is equivalent to the dlm_pdbs_allocated attribute, except it relates to kernel threads using kernel DLM interfaces instead of user processes. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 4294967295 dlm_gdbs_allocated Number of group lock containers on this cluster member. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 4294967295 dlm_perm_gdbs Number of permanent group lock containers on this member system. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 4294967295 dlm_txids_allocated Number of transactions active on this cluster member. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 4294967295 dlm_long_rhash_chain Length of the longest linked list in the resource hash table. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 0 dlm_empty_rhash_chain Number of empty linked lists (chains) in the resource hash table. Supported operations: Query Default value: 8191 Minimum value: 0 Maximum value: 0 dlm_txid_wrap Set when the number of DLM transactions done on a single lock ID handle has overflowed the largest value that can fit in an unsigned long datum. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 4 rhash_size Number of entries in the resource hash table on this member system. Increasing the size of the resource hash table can shorten the lengths of the chains of which the table is comprised. By reducing the time it takes for the DLM to search these chains, this can improve DLM performance. Supported operations: Query; Configure at boot time Default value: 8192 Minimum value: 1 Maximum value: 2147483647 pdb_hash_size Number of entries in the process hash table on this member system. Set this attribute to the approximate number of processes that will use the DLM on this system. Supported operations: Query; Configure at boot time Default value: 64 Minimum value: 1 Maximum value: 2147483647 kpdb_hash_size This is equivalent to the pdb_hash_size attribute, except it relates to kernel threads using kernel DLM interfaces instead of user processes. Supported operations: Query; Configure at boot time Default value: 64 Minimum value: 1 Maximum value: 2147483647 gdb_hash_size Number of entries in the group lock container hash table on this member system. Set this attribute to the approximate number of group lock containers that will be on this member system. Supported operations: Query; Configure at boot time Default value: 64 Minimum value: 1 Maximum value: 2147483647 txid_hash_size Number of entries in the transaction hash table on this member system. Set this attribute to the approximate number of transactions that will be active in the cluster. Supported operations: Query; Configure at boot time Default value: 64 Minimum value: 1 Maximum value: 2147483647 dlm_deadlock_wait Length of time, in seconds, each lock on the conversion, wait, and timeout queues waits to be included in a deadlock search. (The dlm_deadlock scan attribute controls the frequency of deadlock searches for resources mastered on this member.) A conversion or multiple resource deadlock can exist up to dlm_deadlock_wait seconds before it is detected. You can reduce the amount of time it takes for deadlock detection for all queued locks by reducing the value of this attribute and rebooting the cluster. The dlm_deadlock_wait attribute must be set to the same value on all cluster members. Supported operations: Query; Configure at boot time Default value: 10 Minimum value: 1 Maximum value: 4294967295 dlm_dirwt Directory weight value. Setting the directory weight value increases the likelihood that this node will be the director of a resource. Its value can range from 0 to 4, where 4 provides the highest likelihood. Supported operations: Query Default value: 1 Minimum value: 0 Maximum value: 4 dlm_validate_rsb Validate resource block. 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: 255 dlm_locks_cfg Number of locks configured on this member system at boot time. To improve lock startup performance, set this attribute to twice the number of expected locks. Supported operations: Query; Configure at boot time Default value: 8192 Minimum value: 1 Maximum value: 1073741824 dlm_deadlock_scan Frequency (in seconds) with which the DLM initiates deadlock detection scans in the cluster. This attribute is used in conjunction with the dlm_deadlock_wait attribute to determine how often a lock on the conversion, deadlock, or timeout queue participates in deadlock detection. The dlm_deadlock_scan attribute must be set to the same value on all cluster members. Supported operations: Query; Configure at boot time; Reconfigure at run time Default value: 1 Minimum value: 1 Maximum value: 4294967295 dlm_zero_stats Reset all DLM statistics to 0 (zero). Supported operations: Query; Reconfigure at run time dlm_rd_count Number of recovery domains in the cluster. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 4294967295 dlm_rd_in Number of recovery domain messages sent by this node. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 18446744073709551615 dlm_rd_out Number of recovery domain messages received by this node. Supported operations: Query Default value: 0 Minimum value: 0 Maximum value: 18446744073709551615

SEE ALSO

sys_attrs(5) Cluster Administration Cluster Highly Available Applications

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