|
Hopefully, this page is exactly what you are looking for, but if not, you can always find further assistance on Unix/Linux Forum!
System Administration Commands poolcfg(1M)
NAME
poolcfg - create and modify resource pool configuration
files
SYNOPSIS
/usr/sbin/poolcfg -c command [-d | [filename]]
/usr/sbin/poolcfg -f command_file [-d | [filename]]
/usr/sbin/poolcfg -h
DESCRIPTION
The poolcfg command provides configuration operations on
pools and sets. These operations are performed upon an
existing configuration and take the form of modifications to
the specified configuration file. If you use the -d option,
the modifications occur to the kernel state. Actual activa-
tion of the resulting configuration is achieved by way of
the pooladm(1M) command.
Pools configuration files are structured files that must
have been constructed using poolcfg itself or libpool(3LIB)
directly.
The configurations which are created by this tool can be
used by pooladm to instantiate the configuration upon a tar-
get host.
OPTIONS
The following options are supported:
-c command Specify command as an editing command. See
USAGE.
-d Operate directly on the kernel state. No
filename is allowed.
-f command_file Take the commands from command_file.
command_file consists of editing commands,
one per line.
-h Display extended information about the syn-
tax of editing commands.
SunOS 5.10 Last change: 15 Feb 2005 1
System Administration Commands poolcfg(1M)
USAGE
Scripts
A script consists of editing commands, one per line, of the
following:
info [entity-name]
Display configuration (or specified portion) in human
readable form to standard output. If no entity is speci-
fied, system information is displayed. Therefore,
poolcfg -c 'info' afile is an equivalent invocation to
poolcfg -c 'info system name' afile.
create entity-name [property-list]
Make an entity of the specified type and name.
destroy entity-name
Remove the specified entity.
modify entity-name [property-list]
Change the listed properties on the named entity.
associate pool-name [resource-list]
Connect one or more resources to a pool, or replace one
or more existing connections.
transfer to [resourcetype] name[component-list]
Transfer one or more discrete components to a resource .
transfer [quantity] from [resourcetype] [src] to [tgt]
Transfer a resource quantity from src to tgt.
SunOS 5.10 Last change: 15 Feb 2005 2
System Administration Commands poolcfg(1M)
transfer [quantity] to [resourcetype] [tgt] from [src]
Transfer a resource quantity to tgt from src.
discover
Create a system entity, with one pool entity and
resources to match current system configuration. All
discovered resources of each resource type are recorded
in the file, with the single pool referring to the
default resource for each resource type.
This command is a NO-OP when poolcfg operates directly
on the kernel. See the -d option.
You should avoid use of this command. The preferred
method for creating a configuration is to export the
dynamic configuration using pooladm(1M) with the -s
option.
rename entity-name to new-name
Change the name of an entity on the system to its new
name.
Property Lists
The property list is specified by:
( proptype name = value [ ; proptype name = value ]* )
where the last definition in the sequence for a given prop-
type, name pair is the one that holds. For property dele-
tion, use ~ proptype name.
Resource Lists
A resource list is specified by:
( resourcetype name [ ; resourcetype name ]* )
SunOS 5.10 Last change: 15 Feb 2005 3
System Administration Commands poolcfg(1M)
where the last specification in the sequence for a resource
is the one that holds. There is no deletion syntax for
resource lists.
Component Lists
A component list is specified by:
( componenttype name [ ; componenttype name ]* )
where the last specification in the sequence for a component
is the one that holds. There is no deletion syntax for com-
ponent lists.
Recognized Entities
system Machine level entity
pool Named collection of resource associations
Resource Types
pset Processor set resource
Property Types
boolean Takes one of two values true or false.
int A 64-bit signed integer value.
uint A 64-bit unsigned integer value.
string Strings are delimited by quotes ("), and
support the character escape sequences
defined in formats(5).
float Scientific notation is not supported.
SunOS 5.10 Last change: 15 Feb 2005 4
System Administration Commands poolcfg(1M)
EXAMPLES
Example 1: Writing a poolcfg Script
The following poolcfg script creates a pool named Account-
ing, and a processor set, small-1. The processor set is
created first, then the pool is created and associated with
the set.
create pset small-1 ( uint pset.min = 1 ; uint pset.max = 4)
create pool Accounting
associate pool Accounting ( pset small-1 )
Example 2: Reporting on pool_0
The following command reports on pool_0 to standard output
in human readable form:
# poolcfg -c 'info pool pool_0' /etc/pooladm.conf
Example 3: Destroying pool_0 and Its Associations
The following command destroys pool_0 and associations, but
not the formerly associated resources:
# poolcfg -c 'destroy pool pool_0' /etc/pooladm.conf
Example 4: Displaying the Current Configuration
The following command displays the current configuration:
$ poolcfg -c 'info' /etc/pooladm.conf
system example_system
int system.version 1
boolean system.bind-default true
string system.comment Discovered by libpool
pool pool_default
boolean pool.default true
boolean pool.active true
int pool.importance 5
string pool.comment
string.pool.scheduler FSS
pset pset_default
pset pset_default
int pset.sys_id -1
string pset.units population
boolean pset.default true
uint pset.max 4294967295
SunOS 5.10 Last change: 15 Feb 2005 5
System Administration Commands poolcfg(1M)
uint pset.min 1
string pset.comment
boolean pset.escapable false
uint pset.load 0
uint pset.size 2
cpu
int cpu.sys_id 0
string cpu.comment
cpu
int cpu.sys_id 2
string cpu.comment
Example 5: Moving cpu with ID 2 to Processor Set pset1 in
the Kernel
The following command moves cpu with ID 2 to processor set
pset1 in the kernel:
# poolcfg -dc 'transfer to pset pset1 ( cpu 2 )'
Example 6: Moving 2 cpus from Processor Set pset1 to Proces-
sor Set pset2 in the Kernel
The following command moves 2 cpus from processor set pset1
to processor set pset2 in the kernel:
# poolcfg -dc 'transfer 2 from pset pset1 to pset2'
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWpool |
|_____________________________|_____________________________|
| Interface Stability | See below. |
|_____________________________|_____________________________|
The invocation is Evolving. The output is Unstable.
SEE ALSO
pooladm(1M), poolbind(1M), libpool(3LIB), attributes(5),
formats(5)
System Administration Guide: N1 Grid Containers, Resource
Management, and Solaris Zones
SunOS 5.10 Last change: 15 Feb 2005 6
Man(1) output converted with
man2html and wrapped by fishsponge
This page was generated on Wed Sep 12 11:26:25 GMT 2007
|
Your favourite pages:
No pages logged yet... Top 10 most popular pages:
prstat man page (24547 hits)
(Solaris 10 11_06)
netcat man page (17695 hits)
(Suse Linux 10.1)
ssh-socks5-proxy-connect man page (13535 hits)
(Solaris 10 11_06)
signal man page (12551 hits)
(Suse Linux 10.1)
startproc man page (11991 hits)
(Suse Linux 10.1)
raidctl man page (11357 hits)
(Solaris 10 11_06)
adv_cap_autoneg man page (10288 hits)
(Solaris 10 11_06)
sqlite3 man page (9729 hits)
(openSUSE 10.2)
CPAN man page (8947 hits)
(Suse Linux 10.1)
BusyBox man page (7702 hits)
(Suse Linux 10.1)
|
Man Pages 
