Configuring Pools
How to Create a Static Configuration
Use the -s option to /usr/sbin/pooladm to create a static configuration file that
matches the current dynamic configuration. Unless a different file name is specified, the
default location /etc/pooladm.conf is used.
Commit your configuration using the pooladm command with the -c option. Then, use
the pooladm command with the -s option to update the static configuration to
match the state of the dynamic configuration.
Note - The new functionality pooladm -s is preferred over the previous functionality poolcfg -c
discover for creating a new configuration that matches the dynamic configuration.
Before You Begin
Enable pools on your system.
- Become superuser, or assume a role that includes the Process Management profile.
The System Administrator role includes the Process Management profile. For more information about
roles, see Using the Solaris Management Tools With RBAC (Task Map) in System Administration Guide: Basic Administration.
- Update the static configuration file to match the current dynamic configuration.
# pooladm -s
- View the contents of the configuration file in readable form.
Note that the configuration contains default elements created by the system.
# poolcfg -c info
system tester
string system.comment
int system.version 1
boolean system.bind-default true
int system.poold.pid 177916
pool pool_default
int pool.sys_id 0
boolean pool.active true
boolean pool.default true
int pool.importance 1
string pool.comment
pset pset_default
pset pset_default
int pset.sys_id -1
boolean pset.default true
uint pset.min 1
uint pset.max 65536
string pset.units population
uint pset.load 10
uint pset.size 4
string pset.comment
boolean testnullchanged true
cpu
int cpu.sys_id 3
string cpu.comment
string cpu.status on-line
cpu
int cpu.sys_id 2
string cpu.comment
string cpu.status on-line
cpu
int cpu.sys_id 1
string cpu.comment
string cpu.status on-line
cpu
int cpu.sys_id 0
string cpu.comment
string cpu.status on-line
- Commit the configuration at /etc/pooladm.conf.
# pooladm -c
- (Optional) To copy the dynamic configuration to a static configuration file called /tmp/backup,
type the following:
# pooladm -s /tmp/backup
How to Modify a Configuration
To enhance your configuration, create a processor set named pset_batch and a
pool named pool_batch. Then join the pool and the processor set with an
association.
Note that you must quote subcommand arguments that contain white space.
- Become superuser, or assume a role that includes the Process Management profile.
The System Administrator role includes the Process Management profile. For more information about
roles, see Using the Solaris Management Tools With RBAC (Task Map) in System Administration Guide: Basic Administration.
- Create processor set pset_batch.
# poolcfg -c 'create pset pset_batch (uint pset.min = 2; uint pset.max = 10)'
- Create pool pool_batch.
# poolcfg -c 'create pool pool_batch'
- Join the pool and the processor set with an association.
# poolcfg -c 'associate pool pool_batch (pset pset_batch)'
- Display the edited configuration.
# poolcfg -c info
system tester
string system.comment kernel state
int system.version 1
boolean system.bind-default true
int system.poold.pid 177916
pool pool_default
int pool.sys_id 0
boolean pool.active true
boolean pool.default true
int pool.importance 1
string pool.comment
pset pset_default
pset pset_default
int pset.sys_id -1
boolean pset.default true
uint pset.min 1
uint pset.max 65536
string pset.units population
uint pset.load 10
uint pset.size 4
string pset.comment
boolean testnullchanged true
cpu
int cpu.sys_id 3
string cpu.comment
string cpu.status on-line
cpu
int cpu.sys_id 2
string cpu.comment
string cpu.status on-line
cpu
int cpu.sys_id 1
string cpu.comment
string cpu.status on-line
cpu
int cpu.sys_id 0
string cpu.comment
string cpu.status on-line
pool pool_batch
boolean pool.default false
boolean pool.active true
int pool.importance 1
string pool.comment
pset pset_batch
pset pset_batch
int pset.sys_id -2
string pset.units population
boolean pset.default true
uint pset.max 10
uint pset.min 2
string pset.comment
boolean pset.escapable false
uint pset.load 0
uint pset.size 0
cpu
int cpu.sys_id 5
string cpu.comment
string cpu.status on-line
cpu
int cpu.sys_id 4
string cpu.comment
string cpu.status on-line
- Commit the configuration at /etc/pooladm.conf.
# pooladm -c
- (Optional) To copy the dynamic configuration to a static configuration file named /tmp/backup,
type the following:
# pooladm -s /tmp/backup
How to Associate a Pool With a Scheduling Class
You can associate a pool with a scheduling class so that all
processes bound to the pool use this scheduler. To do this, set the
pool.scheduler property to the name of the scheduler. This example associates the pool
pool_batch with the fair share scheduler (FSS).
- Become superuser, or assume a role that includes the Process Management profile.
The System Administrator role includes the Process Management profile. For more information about
roles, see Using the Solaris Management Tools With RBAC (Task Map) in System Administration Guide: Basic Administration.
- Modify pool pool_batch to be associated with the FSS.
# poolcfg -c 'modify pool pool_batch (string pool.scheduler="FSS")'
- Display the edited configuration.
# poolcfg -c info
system tester
string system.comment
int system.version 1
boolean system.bind-default true
int system.poold.pid 177916
pool pool_default
int pool.sys_id 0
boolean pool.active true
boolean pool.default true
int pool.importance 1
string pool.comment
pset pset_default
pset pset_default
int pset.sys_id -1
boolean pset.default true
uint pset.min 1
uint pset.max 65536
string pset.units population
uint pset.load 10
uint pset.size 4
string pset.comment
boolean testnullchanged true
cpu
int cpu.sys_id 3
string cpu.comment
string cpu.status on-line
cpu
int cpu.sys_id 2
string cpu.comment
string cpu.status on-line
cpu
int cpu.sys_id 1
string cpu.comment
string cpu.status on-line
cpu
int cpu.sys_id 0
string cpu.comment
string cpu.status on-line
pool pool_batch
boolean pool.default false
boolean pool.active true
int pool.importance 1
string pool.comment
string pool.scheduler FSS
pset batch
pset pset_batch
int pset.sys_id -2
string pset.units population
boolean pset.default true
uint pset.max 10
uint pset.min 2
string pset.comment
boolean pset.escapable false
uint pset.load 0
uint pset.size 0
cpu
int cpu.sys_id 5
string cpu.comment
string cpu.status on-line
cpu
int cpu.sys_id 4
string cpu.comment
string cpu.status on-line
- Commit the configuration at /etc/pooladm.conf:
# pooladm -c
- (Optional) To copy the dynamic configuration to a static configuration file called /tmp/backup,
type the following:
# pooladm -s /tmp/backup
How to Set Configuration Constraints
Constraints affect the range of possible configurations by eliminating some of the potential
changes that could be made to a configuration. This procedure shows how to
set the cpu.pinned property.
In the following examples, cpuid is an integer.
- Become superuser, or assume a role that includes the Process Management profile.
The System Administrator role includes the Process Management profile. For more information about
roles, see Using the Solaris Management Tools With RBAC (Task Map) in System Administration Guide: Basic Administration.
- Modify the cpu.pinned property in the static or dynamic configuration:
How to Define Configuration Objectives
You can specify objectives for poold to consider when taking corrective action.
In the following procedure, the wt-load objective is being set so that poold
tries to match resource allocation to resource utilization. The locality objective is disabled to
assist in achieving this configuration goal.
- Become superuser, or assume a role that includes the Process Management profile.
The System Administrator role includes the Process Management profile. For more information about
roles, see Using the Solaris Management Tools With RBAC (Task Map) in System Administration Guide: Basic Administration.
- Modify system tester to favor the wt-load objective.
# poolcfg -c 'modify system tester (string system.poold.objectives="wt-load")'
- Disable the locality objective for the default processor set.
# poolcfg -c 'modify pset pset_default (string pset.poold.objectives="locality none")'one line
- Disable the locality objective for the pset_batch processor set.
# poolcfg -c 'modify pset pset_batch (string pset.poold.objectives="locality none")'one line
- Display the edited configuration.
# poolcfg -c info
system tester
string system.comment
int system.version 1
boolean system.bind-default true
int system.poold.pid 177916
string system.poold.objectives wt-load
pool pool_default
int pool.sys_id 0
boolean pool.active true
boolean pool.default true
int pool.importance 1
string pool.comment
pset pset_default
pset pset_default
int pset.sys_id -1
boolean pset.default true
uint pset.min 1
uint pset.max 65536
string pset.units population
uint pset.load 10
uint pset.size 4
string pset.comment
boolean testnullchanged true
string pset.poold.objectives locality none
cpu
int cpu.sys_id 3
string cpu.comment
string cpu.status on-line
cpu
int cpu.sys_id 2
string cpu.comment
string cpu.status on-line
cpu
int cpu.sys_id 1
string cpu.comment
string cpu.status on-line
cpu
int cpu.sys_id 0
string cpu.comment
string cpu.status on-line
pool pool_batch
boolean pool.default false
boolean pool.active true
int pool.importance 1
string pool.comment
string pool.scheduler FSS
pset batch
pset pset_batch
int pset.sys_id -2
string pset.units population
boolean pset.default true
uint pset.max 10
uint pset.min 2
string pset.comment
boolean pset.escapable false
uint pset.load 0
uint pset.size 0
string pset.poold.objectives locality none
cpu
int cpu.sys_id 5
string cpu.comment
string cpu.status on-line
cpu
int cpu.sys_id 4
string cpu.comment
string cpu.status on-line
- Commit the configuration at /etc/pooladm.conf.
# pooladm -c
- (Optional) To copy the dynamic configuration to a static configuration file called /tmp/backup,
type the following:
# pooladm -s /tmp/backup
How to Set the poold Logging Level
To specify the level of logging information that poold generates, set the system.poold.log-level
property in the poold configuration. The poold configuration is held in the libpool
configuration. For information, see poold Logging Information and the poolcfg(1M) and libpool(3LIB) man pages.
You can also use the poold command at the command line to specify
the level of logging information that poold generates.
- Become superuser, or assume a role that includes the Process Management profile.
The System Administrator role includes the Process Management profile. For more information about
roles, see Using the Solaris Management Tools With RBAC (Task Map) in System Administration Guide: Basic Administration.
- Set the logging level by using the poold command with the -l
option and a parameter, for example, INFO.
# /usr/lib/pool/poold -l INFO
For information about available parameters, see poold Logging Information. The default logging level is NOTICE.
How to Use Command Files With poolcfg
The poolcfg command with the -f option can take input from a text
file that contains poolcfg subcommand arguments to the -c option. This method is
appropriate when you want a set of operations to be performed. When processing
multiple commands, the configuration is only updated if all of the commands succeed.
For large or complex configurations, this technique can be more useful than per-subcommand invocations.
Note that in command files, the # character acts as a comment
mark for the rest of the line.
- Create the input file poolcmds.txt.
$ cat > poolcmds.txt
create system tester create pset pset_batch (uint pset.min = 2; uint pset.max = 10) create pool pool_batch associate pool pool_batch (pset pset_batch)
- Become superuser, or assume a role that includes the Process Management profile.
The System Administrator role includes the Process Management profile. For more information about
roles, see Using the Solaris Management Tools With RBAC (Task Map) in System Administration Guide: Basic Administration.
- Execute the command:
# /usr/sbin/poolcfg -f poolcmds.txt
