pooladm(1m) - osol9

1pooladm(1M)             System Administration Commands             pooladm(1M)
2
3
4

NAME

6       pooladm - activate and deactivate the resource pools facility
7

SYNOPSIS

9       /usr/sbin/pooladm [-n] [-s] [-c] [filename] | -x
10
11
12       /usr/sbin/pooladm [-d | -e]
13
14

DESCRIPTION

16       The  pooladm  command  provides  administrative operations on pools and
17       sets. pooladm reads the specified filename and attempts to activate the
18       pool configuration contained in it.
19
20
21       Before  updating the current pool run-time configuration, pooladm vali‐
22       dates the configuration for correctness.
23
24
25       Without options, pooladm prints out the current running pools  configu‐
26       ration.
27

OPTIONS

29       The following options are supported:
30
31       -c    Instantiate  the  configuration at the given location. If a file‐
32             name is not specified, it defaults to /etc/pooladm.conf.
33
34
35       -d    Disable the pools facility so that pools can no longer be manipu‐
36             lated.
37
38
39       -e    Enable the pools facility so that pools can be manipulated.
40
41
42       -n    Validate  the configuration without actually updating the current
43             active configuration. Checks that there are no  syntactic  errors
44             and  that  the  configuration  can be instantiated on the current
45             system. No validation of application specific properties is  per‐
46             formed.
47
48
49       -s    Update  the  specified  location  with the details of the current
50             dynamic configuration.
51
52             This option requires update permission for the configuration that
53             you  are  going  to  update.  If  you use this option with the -c
54             option, the dynamic configuration is updated  before  the  static
55             location.
56
57
58       -x    Remove  the  currently  active  pool  configuration.  Destroy all
59             defined resources, and return all formerly partitioned components
60             to their default resources.
61
62

OPERANDS

64       The following operands are supported:
65
66       filename    Use the configuration contained within this file.
67
68

EXAMPLES

70       Example 1 Instantiating a Configuration
71
72
73       The  following  command  instantiates  the  configuration  contained at
74       /home/admin/newconfig:
75
76
77         example# /usr/sbin/pooladm -c /home/admin/newconfig
78
79
80
81       Example 2 Validating the Configuration Without Instantiating It
82
83
84       The following command attempts to instantiate  the  configuration  con‐
85       tained  at /home/admin/newconfig. It displays any error conditions that
86       it encounters, but does not actually modify the active configuration.
87
88
89         example# /usr/sbin/pooladm -n -c /home/admin/newconfig
90
91
92
93       Example 3 Removing the Current Configuration
94
95
96       The following command removes the current pool configuration:
97
98
99         example# /usr/sbin/pooladm -x
100
101
102
103       Example 4 Enabling the Pools Facility
104
105
106       The following command enables the pool facility:
107
108
109         example# /usr/sbin/pooladm -e
110
111
112
113       Example 5 Enabling the Pools Facility Using SMF
114
115
116       The following command enables the pool facility through use of the Ser‐
117       vice Management Facility. See smf(5).
118
119
120         example# /usr/sbin/svcadm enable svc:/system/pools:default
121
122
123
124       Example 6 Saving the Active Configuration to a Specified Location
125
126
127       The    following    command   saves   the   active   configuration   to
128       /tmp/state.backup:
129
130
131         example# /usr/sbin/pooladm -s /tmp/state.backup
132
133
134

FILES

136       /etc/pooladm.conf    Configuration file for pooladm.
137
138

ATTRIBUTES

140       See attributes(5) for descriptions of the following attributes:
141
142
143
144
145       ┌─────────────────────────────┬─────────────────────────────┐
146       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
147       ├─────────────────────────────┼─────────────────────────────┤
148       │Availability                 │SUNWpool                     │
149       ├─────────────────────────────┼─────────────────────────────┤
150       │Interface Stability          │See below.                   │
151       └─────────────────────────────┴─────────────────────────────┘
152
153
154       The invocation is Evolving. The output is Unstable.
155

NOTES

164       Resource  bindings that are not presented in the form of a binding to a
165       partitionable resource, such as the scheduling class, are not necessar‐
166       ily modified in a pooladm -x operation.
167
168
169       The  pools  facility  is  not  active  by  default when Solaris starts.
170       pooladm -e explicitly activates the pools  facility.  The  behavior  of
171       certain  APIs related to processor partitioning and process binding are
172       modified when pools is active. See libpool(3LIB).
173
174
175       You cannot enable the pools facility on a system where  processor  sets
176       have  been  created.  Use  the psrset(1M) command or pset_destroy(2) to
177       destroy processor sets manually before you enable the pools facility.
178
179
180       Because the Resource Pools facility is an smf(5) service, it  can  also
181       be enabled and disabled using the standard SMF interfaces.
182
183
184
185SunOS 5.11                        1 Dec 2005                       pooladm(1M)