poold Properties
There are four categories of properties:
Configuration
Constraint
Objective
Objective Parameter
Table 12-1 Defined Property Names
Property Name | Type | Category | Description |
---|---|---|---|
system.poold.log-level | string | Configuration | Logging level |
system.poold.log-location | string | Configuration | Logging location |
system.poold.monitor-interval | uint64 | Configuration | Monitoring sample interval |
system.poold.history-file | string | Configuration | Decision history location |
pset.max | uint64 | Constraint | Maximum number of CPUs for this processor set |
pset.min | uint64 | Constraint | Minimum number of CPUs for this processor set |
cpu.pinned | bool | Constraint | CPUs pinned to this processor set |
system.poold.objectives | string | Objective | Formatted string following poold's objective expression syntax |
pset.poold.objectives | string | Objective | Formatted string following poold's expression syntax |
pool.importance | int64 | Objective parameter | User-assigned importance |
poold Features That Can Be Configured
You can configure these aspects of the daemon's behavior.
Monitoring interval
Logging level
Logging location
These options are specified in the pools configuration. You can also control the logging level from the command line by invoking poold.
poold Monitoring Interval
Use the property name system.poold.monitor-interval to specify a value in milliseconds.
poold Logging Information
Three categories of information are provided through logging. These categories are identified in the logs:
Configuration
Monitoring
Optimization
Use the property name system.poold.log-level to specify the logging parameter. If this property is not specified, the default logging level is NOTICE. The parameter levels are hierarchical. Setting a log level of DEBUG will cause poold to log all defined messages. The INFO level provides a useful balance of information for most administrators.
At the command line, you can use the poold command with the -l option and a parameter to specify the level of logging information generated.
The following parameters are available:
ALERT
CRIT
ERR
WARNING
NOTICE
INFO
DEBUG
The parameter levels map directly onto their syslog equivalents. See Logging Location for more information about using syslog.
For more information about how to configure poold logging, see How to Set the poold Logging Level.
Configuration Information Logging
The following types of messages can be generated:
ALERT | Problems accessing the libpool configuration, or some other fundamental, unanticipated failure of the libpool facility. Causes the daemon to exit and requires immediate administrative attention. |
CRIT | Problems due to unanticipated failures. Causes the daemon to exit and requires immediate administrative attention. |
ERR | Problems with the user-specified parameters that control operation, such as unresolvable, conflicting utilization objectives for a resource set. Requires administrative intervention to correct the objectives. poold attempts to take remedial action by ignoring conflicting objectives, but some errors will cause the daemon to exit. |
WARNING | Warnings related to the setting of configuration parameters that, while technically correct, might not be suitable for the given execution environment. An example is marking all CPU resources as pinned, which means that poold cannot move CPU resources between processor sets. |
DEBUG | Messages containing the detailed information that is needed when debugging configuration processing. This information is not generally used by administrators. |