xref: /titanic_41/usr/src/man/man1m/poold.1m (revision c10c16dec587a0662068f6e2991c29ed3a9db943)
te
Copyright (c) 2005, Sun Microsystems, Inc. All Rights Reserved.
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
poold 1M "1 Dec 2005" "SunOS 5.11" "System Administration Commands"
NAME
poold - automated resource pools partitioning daemon
SYNOPSIS

poold [-l level]
DESCRIPTION

poold provides automated resource partitioning facilities. poold can be enabled or disabled using the Solaris Service Management Facility, smf(5). poold requires the Resource Pools facility to be active in order to operate.

The dynamic resource pools service's fault management resource identifier (FMRI) is:

svc:/system/pools/dynamic

The resource pools service's FMRI is:

svc:/system/pools

poold's configuration details are held in a libpool(3LIB) configuration and you can access all customizable behavior from this configuration.

poold periodically examines the load on the system and decides whether intervention is required to maintain optimal system performance with respect to resource consumption. poold also responds to externally initiated (with respect to poold) changes of either resource configuration or objectives.

If intervention is required, poold attempts to reallocate the available resources to ensure that performance objectives are satisfied. If it is not possible for poold to meet performance objectives with the available resources, then a message is written to the log. poold allocates scarce resources according to the objectives configured by the administrator. The system administrator must determine which resource pools are most deserving of scarce resource and indicate this through the importance of resource pools and objectives.

OPTIONS

The following options are supported:

-l level

Specify the vebosity level for logging information. Specify level as ALERT, CRIT, ERR, WARNING, NOTICE, INFO, and DEBUG. If level is not supplied, then the default logging level is INFO.

ALERT

A condition that should be corrected immediately, such as a corrupted system database.

CRIT

Critical conditions, such as hard device errors.

ERR

Errors.

WARNING

Warning messages.

NOTICE

Conditions that are not error conditions, but that may require special handling.

INFO

Informational messages.

DEBUG

Messages that contain information normally of use only when debugging a program.

When invoked manually, with the -l option, all log output is directed to standard error.

EXAMPLES

Example 1 Modifying the Default Logging Level

The following command modifies the default logging level to ERR:

# /usr/lib/pool/poold -l ERR

Example 2 Enabling Dynamic Resource Pools

The following command enables dynamic resource pools:

# /usr/sbin/svcadm enable svc:/system/pools/dynamic
ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
Interface StabilitySee below.

The invocation is Evolving. The output is Unstable.

SEE ALSO

pooladm(1M), poolbind(1M), poolcfg(1M), poolstat(1M), svcadm(1M), pool_set_status(3POOL), libpool(3LIB), attributes(5), smf(5)