'\" te
.\" Copyright (c) 2005, 2011, Oracle and/or its affiliates. All rights reserved.
.TH poold 1M "16 Aug 2011" "SunOS 5.11" "System Administration Commands"
.SH NAME
poold \- automated resource pools partitioning daemon
.SH SYNOPSIS
.LP
.nf
\fBpoold\fR [\fB-l\fR \fIlevel\fR]
.fi

.SH DESCRIPTION
.sp
.LP
\fBpoold\fR provides automated resource partitioning facilities. \fBpoold\fR can be enabled or disabled using the Solaris Service Management Facility, \fBsmf\fR(5). \fBpoold\fR requires the Resource Pools facility to be active in order to operate.
.sp
.LP
The dynamic resource pools service's fault management resource identifier (FMRI) is:
.sp
.in +2
.nf
svc:/system/pools/dynamic
.fi
.in -2

.sp
.LP
The resource pools service's FMRI is:
.sp
.in +2
.nf
svc:/system/pools
.fi
.in -2

.sp
.LP
\fBpoold\fR's configuration details are held in a \fBlibpool\fR(3LIB) configuration and you can access all customizable behavior from this configuration. 
.sp
.LP
\fBpoold\fR periodically examines the load on the system and decides whether intervention is required to maintain optimal system performance with respect to resource consumption. \fBpoold\fR also responds to externally initiated (with respect to \fBpoold\fR) changes of either resource configuration or objectives.
.sp
.LP
If intervention is required, \fBpoold\fR attempts to reallocate the available resources to ensure that performance objectives are satisfied. If it is not possible for \fBpoold\fR to meet performance objectives with the available resources, then a message is written to the log. \fBpoold\fR 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.
.SH OPTIONS
.sp
.LP
The following options are supported:
.sp
.ne 2
.mk
.na
\fB\fB-l\fR \fIlevel\fR\fR
.ad
.RS 12n
.rt  
Specify the vebosity level for logging information.
.sp
Specify \fIlevel\fR as \fBALERT\fR, \fBCRIT\fR, \fBERR\fR, \fBWARNING\fR, \fBNOTICE\fR, \fBINFO\fR, and \fBDEBUG\fR. If \fIlevel\fR is not supplied, then the default logging level is \fBINFO\fR.
.sp
.ne 2
.mk
.na
\fB\fBALERT\fR\fR
.ad
.RS 11n
.rt  
 A condition that should be corrected immediately, such as a corrupted system database.
.RE

.sp
.ne 2
.mk
.na
\fB\fBCRIT\fR\fR
.ad
.RS 11n
.rt  
Critical conditions, such as hard device errors. 
.RE

.sp
.ne 2
.mk
.na
\fB\fBERR\fR\fR
.ad
.RS 11n
.rt  
Errors.
.RE

.sp
.ne 2
.mk
.na
\fB\fBWARNING\fR\fR
.ad
.RS 11n
.rt  
Warning messages.
.RE

.sp
.ne 2
.mk
.na
\fB\fBNOTICE\fR\fR
.ad
.RS 11n
.rt  
 Conditions that are not error conditions, but that may require special handling.
.RE

.sp
.ne 2
.mk
.na
\fB\fBINFO\fR\fR
.ad
.RS 11n
.rt  
Informational messages.
.RE

.sp
.ne 2
.mk
.na
\fB\fBDEBUG\fR\fR
.ad
.RS 11n
.rt  
Messages that contain information normally of use only when debugging a program.
.RE

.RE

.sp
.LP
When invoked manually, with the \fB-l\fR option, all log output is directed to standard error.
.SH EXAMPLES
.LP
\fBExample 1 \fRModifying the Default Logging Level
.sp
.LP
The following command modifies the default logging level to \fBERR\fR:

.sp
.in +2
.nf
# /usr/lib/pool/poold -l ERR
.fi
.in -2
.sp

.LP
\fBExample 2 \fREnabling Dynamic Resource Pools
.sp
.LP
The following command enables dynamic resource pools:

.sp
.in +2
.nf
# /usr/sbin/svcadm enable svc:/system/pools/dynamic
.fi
.in -2
.sp

.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp

.sp
.TS
tab() box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
ATTRIBUTE TYPEATTRIBUTE VALUE
_
Availabilitysystem/resource-mgmt/resource-pools
_
Interface StabilitySee below.
.TE

.sp
.LP
The invocation is Committed. The output is Uncommitted.
.SH SEE ALSO
.sp
.LP
\fBpooladm\fR(1M), \fBpoolbind\fR(1M), \fBpoolcfg\fR(1M), \fBpoolstat\fR(1M), \fBsvcadm\fR(1M), \fBpool_set_status\fR(3POOL), \fBlibpool\fR(3LIB), \fBattributes\fR(5), \fBsmf\fR(5)
.sp
.LP
\fIAdministering Resource Management in Oracle         Solaris 11.3\fR