System Administration Commands                          poold(1M)



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  objec-
     tives.


     If intervention is required, poold  attempts  to  reallocate
     the  available  resources  to ensure that performance objec-
     tives 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.





SunOS 5.11           Last change: 1 Dec 2005                    1






System Administration Commands                          poold(1M)



OPTIONS
     The following options are supported:

     -l level    Specify the vebosity level for logging  informa-
                 tion.

                 Specify level  as  ALERT,  CRIT,  ER,  WARNING,
                 NOTICE,  INFO,  and  DEBUG. If level is not sup-
                 plied, then the default logging level is INFO.

                 ALERT       A condition that should be corrected
                            immediately, such as a corrupted sys-
                            tem database.


                 CRIT       Critical  conditions,  such  as  hard
                            device errors.


                 ER        Errors.


                 WARNING    Warning messages.


                 NOTICE      Conditions that are not error condi-
                            tions,  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
     ER:


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



SunOS 5.11           Last change: 1 Dec 2005                    2






System Administration Commands                          poold(1M)



     Example 2 Enabling Dynamic Resource Pools


     The following command enables dynamic resource pools:


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



ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWpool                    
    
     Interface Stability          See below.                  
    



     The invocation is Evolving. The output is Unstable.

SEE ALSO
     pooladm(1M),   poolbind(1M),   poolcfg(1M),    poolstat(1M),
     svcadm(1M),  poolsetstatus(3POL),  libpool(3LIB),  attri-
     butes(5), smf(5)




















SunOS 5.11           Last change: 1 Dec 2005                    3