Index for Section 5

Alphabetical listing for S

Bottom of page

sys_attrs_ics_hl(5)
NAME
  sys_attrs_ics_hl - ics_hl subsystem attributes

DESCRIPTION
  This reference page lists and describes attributes for the high-level
  internode communication service (ics_hl) kernel subsystem. Refer to the
  sys_attrs(5) reference page for an introduction to the topic of kernel
  subsystem attributes.

  ics_hl_debug
      When set to 1, turns on high-level ICS debugging.

      Supported operations: Query; Configure at boot time; Reconfigure at run
      time

      Default value: 1

      Minimum value: 0

      Maximum value: 255

  Module_Config_Name
      Configuration name (ics_hl). Do not alter the value of this attribute.

      Supported operations: Configure at boot time

  ics_hl_verbose
      Determines the message verbosity of the high-level ICS. Four bit masks
      are defined:

	·  ICS_HL_LOW_MEM_THROTTLE (1)--Print messages when ICS is throttled
	   by low memory conditions

	·  ICS_HL_VM_PRIVILEGED (2)--Print information about virtual memory
	   privileged threads that would otherwise throttle due to low memory
	   conditions

	·  ICS_HL_TIMESTAMPS (4)--Enable time stamping of select operations
	   and print time stamp information. (This mask currently has no
	   effect.)

	·  ICS_HL_INVALID_NODEDOWN (8)--Print message for invalid node down
	   requests

      You can combine bit masks; for example, a value of 10 would causes
      messages to be printed for both invalid node down requests and virtual
      memory privileged threads.

      Supported operations: Query; Configure at boot time; Reconfigure at run
      time

      Default value: 2

      Minimum value: 0

      Maximum value: 4294967295

  ics_idle_daemons_lwm
      Minimum number of idle ICS daemons available in the daemon pool.

      The ics_idle_daemons_lwm and ics_idle_daemons_hwm attributes handle
      temporary spikes in usage and activity for unordered ICS services (for
      example, daemon from pool services, such as CFS). They do not handle
      spikes resulting from the activity of ordered services such as DLM and
      CNX or custom services such as ICSNET).

      A larger number of daemons can better handle these spikes in activity.
      The number of available daemons may exceed the value of
      ics_idle_daemons_hwm during spikes, but it will drop back down to that
      value once the spike has subsided.  The number of daemons will always
      increase between the values of ics_idle_daemons_lwm and
      ics_idle_daemons_hwm in response to spikes. It will not drop back down
      to the lower limit.  The default value of ics_idle_daemons_hwm (15)
      should handle most (if not all) spikes and avoid the need to create
      more daemons during spikes.

      To determine whether you should tune the number of idle daemons, you
      must monitor the number of icssvr_daemon_from_pool() processes.  If the
      number routinely exceeds the high watermark, ICS is routinely creating
      daemons and then scaling them back down.	You can count the number of
      daemon processes by using the command:
	   # ps aux | grep icssvr_daemon_fr | wc -l

      When the system isn't spiking, the number should be between
      ics_idle_daemon_lwm and ics_idle_daemon_hwm (even if tending more
      toward the upper limit than the lower).

      You can also look at kproc_creator_daemon process in the process table
      and examine its run-time statistics. The kproc_creator_daemon() process
      is responsible for spawning certain other daemons, including the
      icssvr_daemon_from_pool() processes. For example:
	   # ps aux | head -1 ; ps aux | grep kproc_creat | grep -v grep
	   USER	  PID %CPU %MEM	  VSZ  RSS TTY	S   STARTED	 TIME COMMAND
	   root 524290 0.0  0.0	   0K	0K ??	U     Dec 31  0:00.01 [kproc_creator_da]

      In the previous example, the CPU percentage (0.0) is low, so there's no
      need to adjust the highwater mark.

      Supported operations: Query; Configure at boot time; Reconfigure at run
      time

      Default value: 4

      Minimum value: 1

      Maximum value: Value of ics_idle_daemons_hwm

  ics_idle_daemons_hwm
      Maximum number of idle ICS daemons available in the daemon pool.

      Supported operations: Query; Configure at boot time; Reconfigure at run
      time

      Default value: 15

      Minimum value: Value of ics_idle_daemons_lwm

      Maximum value: 2147483647

SEE ALSO
  sys_attrs(5)

Index for Section 5

Alphabetical listing for S

Top of page