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-cdiscover for creating a new configuration that matches the dynamic configuration.

(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).

Modify the cpu.pinned property in the static or dynamic configuration:

Modify the boot-time (static) configuration:

# poolcfg -c 'modify cpu <cpuid> (boolean cpu.pinned = true)'

Modify the running (dynamic) configuration without modifying the boot-time configuration:

# poolcfg -dc 'modify cpu <cpuid> (boolean cpu.pinned = true)'

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.

(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.

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.