intrbald.1m (2010 09)

i
intrbald(1M) intrbald(1M)
NAME
intrbald - daemon for balancing interrupts
SYNOPSIS
/usr/sbin/intrbald
[-i interval | -k
| -c]
DESCRIPTION
Balancing interrupts is a process which distributes interrupts across the available CPUs in an optimal
fashion. This action is performed by
intctl (see intctl (1M)).
Performing frequent CPU migrations between system partitions may require you to perform periodic
balancing of interrupts. This is especially true with systems that use WLM (Workload Manager), iCAP
(Instant Capacity), and vPars (Virtual Partitions) products. If the frequency of CPU migration is high,
then balancing of interrupts should be performed more frequently.
The
intrbald daemon monitors the system for imbalance in interrupt distribution. If an imbalance is
detected after the specified interval (defined by
INTRBALD_INTERVAL
), intrbald executes intctl
-b to balance the interrupt distribution.
intctl uses the parameters from the
/etc/intctl.conf
configuration file for balancing the interrupts. For more information about the
intctl command, see
intctl (1M) and the
/etc/intctl.conf
configuration file.
The
intrbald daemon is started from the general purpose sequencer rc script (see rc(1M)),
/sbin/init.d/intrbald_init
, at run level 2 and is killed at run level 1. By default, the
intrbald daemon is not enabled. The daemon configuration file
/etc/rc.config.d/intrbaldconf
must be edited and the parameter INTRBALD_STATE set to
enabled in order to enable running the daemon. After setting INTRBALD_STATE
to enabled for the
first time, you can start the daemon manually by executing the
rc script
(/sbin/init.d/intrbald_init start
). Otherwise, the daemon will automatically start the next
time the system is restarted.
Any actions performed by the daemon are logged in
syslog and details of interrupt migrations per-
formed will be logged in the file /var/adm/intrbald.log
.
Options
intrbald recognizes the following options:
-c Instructs the running daemon to reexamine the configuration file
/etc/rc.config.d/intrbaldconf
. If the INTRBALD_INTERVAL parameter has
been updated, then the running daemon uses the new value. If the
INTRBALD_STATE
parameter is set to disabled, then the running daemon stops executing.
-i interval The daemon checks if the system requires any balancing of interrupts after interval
seconds; the valid range is 5 seconds to INT_MAX seconds (see limits (5)).
This value can also be specified persistently in the configuration file
/etc/rc.config.d/intrbaldconf
by setting the INTRBALD_INTERVAL parame-
ter.
The default value is 60 seconds.
Setting this value too small can cause unnecessary interrupt migrations.
-k Gracefully kills the running daemon.
intrbald rc Configuration File
/etc/rc.config.d/intrbaldconf is the intrbald rc configuration file.
The following parameters can be persistently specified in this configuration file:
INTRBALD_STATE Specifies if the daemon should be started automatically during the system
bootup process by the rc script. The daemon will only be started automati-
cally if this parameter is set to enabled.
NOTE: This value is
disabled by default. Before using the daemon,
INTRBALD_STATE needs to be changed to enabled in the
/etc/rc.config.d/intrbaldconf file. Then the daemon needs to be
started, either manually by running intrbald, or it will be started automati-
cally at next boot via the rc script.
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1