usr/src/man/man1m/poold.1m

   1 '\" te
   2 .\" Copyright (c) 2005, Sun Microsystems, Inc. All Rights Reserved.
   3 .\" 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.
   4 .\" 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.
   5 .\" 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]
   6 .TH POOLD 1M "Dec 1, 2005"
   7 .SH NAME
   8 poold \- automated resource pools partitioning daemon
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBpoold\fR [\fB-l\fR \fIlevel\fR]
  13 .fi
  14
  15 .SH DESCRIPTION
  16 .LP
  17 \fBpoold\fR provides automated resource partitioning facilities. \fBpoold\fR
  18 can be enabled or disabled using the Solaris Service Management Facility,
  19 \fBsmf\fR(5). \fBpoold\fR requires the Resource Pools facility to be active in
  20 order to operate.
  21 .sp
  22 .LP
  23 The dynamic resource pools service's fault management resource identifier
  24 (FMRI) is:
  25 .sp
  26 .in +2
  27 .nf
  28 svc:/system/pools/dynamic
  29 .fi
  30 .in -2
  31
  32 .sp
  33 .LP
  34 The resource pools service's FMRI is:
  35 .sp
  36 .in +2
  37 .nf
  38 svc:/system/pools
  39 .fi
  40 .in -2
  41
  42 .sp
  43 .LP
  44 \fBpoold\fR's configuration details are held in a \fBlibpool\fR(3LIB)
  45 configuration and you can access all customizable behavior from this
  46 configuration.
  47 .sp
  48 .LP
  49 \fBpoold\fR periodically examines the load on the system and decides whether
  50 intervention is required to maintain optimal system performance with respect to
  51 resource consumption. \fBpoold\fR also responds to externally initiated (with
  52 respect to \fBpoold\fR) changes of either resource configuration or objectives.
  53 .sp
  54 .LP
  55 If intervention is required, \fBpoold\fR attempts to reallocate the available
  56 resources to ensure that performance objectives are satisfied. If it is not
  57 possible for \fBpoold\fR to meet performance objectives with the available
  58 resources, then a message is written to the log. \fBpoold\fR allocates scarce
  59 resources according to the objectives configured by the administrator. The
  60 system administrator must determine which resource pools are most deserving of
  61 scarce resource and indicate this through the importance of resource pools and
  62 objectives.
  63 .SH OPTIONS
  64 .LP
  65 The following options are supported:
  66 .sp
  67 .ne 2
  68 .na
  69 \fB\fB-l\fR \fIlevel\fR\fR
  70 .ad
  71 .RS 12n
  72 Specify the verbosity level for logging information.
  73 .sp
  74 Specify \fIlevel\fR as \fBALERT\fR, \fBCRIT\fR, \fBERR\fR, \fBWARNING\fR,
  75 \fBNOTICE\fR, \fBINFO\fR, and \fBDEBUG\fR. If \fIlevel\fR is not supplied, then
  76 the default logging level is \fBINFO\fR.
  77 .sp
  78 .ne 2
  79 .na
  80 \fB\fBALERT\fR\fR
  81 .ad
  82 .RS 11n
  83  A condition that should be corrected immediately, such as a corrupted system
  84 database.
  85 .RE
  86
  87 .sp
  88 .ne 2
  89 .na
  90 \fB\fBCRIT\fR\fR
  91 .ad
  92 .RS 11n
  93 Critical conditions, such as hard device errors.
  94 .RE
  95
  96 .sp
  97 .ne 2
  98 .na
  99 \fB\fBERR\fR\fR
 100 .ad
 101 .RS 11n
 102 Errors.
 103 .RE
 104
 105 .sp
 106 .ne 2
 107 .na
 108 \fB\fBWARNING\fR\fR
 109 .ad
 110 .RS 11n
 111 Warning messages.
 112 .RE
 113
 114 .sp
 115 .ne 2
 116 .na
 117 \fB\fBNOTICE\fR\fR
 118 .ad
 119 .RS 11n
 120  Conditions that are not error conditions, but that may require special
 121 handling.
 122 .RE
 123
 124 .sp
 125 .ne 2
 126 .na
 127 \fB\fBINFO\fR\fR
 128 .ad
 129 .RS 11n
 130 Informational messages.
 131 .RE
 132
 133 .sp
 134 .ne 2
 135 .na
 136 \fB\fBDEBUG\fR\fR
 137 .ad
 138 .RS 11n
 139 Messages that contain information normally of use only when debugging a
 140 program.
 141 .RE
 142
 143 .RE
 144
 145 .sp
 146 .LP
 147 When invoked manually, with the \fB-l\fR option, all log output is directed to
 148 standard error.
 149 .SH EXAMPLES
 150 .LP
 151 \fBExample 1 \fRModifying the Default Logging Level
 152 .sp
 153 .LP
 154 The following command modifies the default logging level to \fBERR\fR:
 155
 156 .sp
 157 .in +2
 158 .nf
 159 # /usr/lib/pool/poold -l ERR
 160 .fi
 161 .in -2
 162 .sp
 163
 164 .LP
 165 \fBExample 2 \fREnabling Dynamic Resource Pools
 166 .sp
 167 .LP
 168 The following command enables dynamic resource pools:
 169
 170 .sp
 171 .in +2
 172 .nf
 173 # /usr/sbin/svcadm enable svc:/system/pools/dynamic
 174 .fi
 175 .in -2
 176 .sp
 177
 178 .SH ATTRIBUTES
 179 .LP
 180 See \fBattributes\fR(5) for descriptions of the following attributes:
 181 .sp
 182
 183 .sp
 184 .TS
 185 box;
 186 c | c
 187 l | l .
 188 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 189 _
 190 Interface Stability     See below.
 191 .TE
 192
 193 .sp
 194 .LP
 195 The invocation is Evolving. The output is Unstable.
 196 .SH SEE ALSO
 197 .LP
 198 \fBpooladm\fR(1M), \fBpoolbind\fR(1M), \fBpoolcfg\fR(1M), \fBpoolstat\fR(1M),
 199 \fBsvcadm\fR(1M), \fBpool_set_status\fR(3POOL), \fBlibpool\fR(3LIB),
 200 \fBattributes\fR(5), \fBsmf\fR(5)
 201 .sp
 202 .LP
 203 \fI\fR