Four commands are available to manage pools:
pool_tool
pool_assemble
pool_info
pool_mp
The following sections briefly describe the commands and provide references to other sections in this chapter, where more detailed information about the commands and their use is described.
The pool_tool command provides a variety of functions for manipulating and controlling pools (refer to Table 5-1 and Table 5-2). Some pool_tool functions — such as creating a pool and growing a pool — require that a file be specified on the command line to provide inputs for the command. Other pool_tool functions — such as erasing a pool, renaming a pool, changing a minor number, and printing a pool configuration — act on existing pools and require one or more pool names to be specified on the command line.
| Flag | Function | Section/Page Reference | ||
|---|---|---|---|---|
| -c | Create a pool | Section 5.5 Creating a Pool Volume | ||
| -e | Erase a pool | Section 5.9 Erasing a Pool Volume | ||
| -s | Scan devices | Section 5.3 Scanning Block Devices | ||
| -g | Grow a pool |
| ||
| -r | Rename a pool |
| ||
| -p | Print a pool configuration | Section 5.7 Displaying Pool Configuration Information | ||
| -m | Change a pool minor number | Section 5.11 Changing a Pool Volume Minor Number |
Table 5-1. pool_tool Command Functions
The pool_assemble command activates and deactivates pools on a system (refer to Table 5-3 and Table 5-4). One or more pool names can be specified on the command line, indicating the pools to be activated or deactivated. If no pools are specified on the command line, all pools will be acted upon.
| Flag | Function | Section/Page Reference |
|---|---|---|
| -a | Activate pool(s) | Section 5.6 Activating/Deactivating a Pool Volume |
| -r | Deactivate pool(s) | Section 5.6 Activating/Deactivating a Pool Volume |
Table 5-3. pool_assemble Command Functions
The pool_info command scans disks directly and displays information about activated pools in a system; that is, pools that have been assembled with the pool_assemble command (refer to Table 5-5 and Table 5-6). Information about pools that are present but not assembled is excluded from the information displayed with a pool_info command. One or more pool names can be specified on the command line to select information about specific pools. If no pool name is specified, information on all pools is returned.
| Flag | Function | Section/Page Reference |
|---|---|---|
| -c | Clear statistics | Section 5.13 Using Pool Volume Statistics |
| -i | Display information | Section 5.12 Displaying Pool Volume Information |
| -s | Display statistics | Section 5.13 Using Pool Volume Statistics |
| -p | Display an active configuration | Section 5.7 Displaying Pool Configuration Information |
Table 5-5. pool_info Command Functions
| Flag | Option |
|---|---|
| -D | Enable debugging output. |
| -H | Show capacity in human readable form. |
| -h | Help. Show usage information. |
| -q | Be quiet. Do not display output from the command. |
| -t | Set time interval for continual statistics updates. |
| -V | Display command version information, then exit. |
| -v | Verbose operation. |
Table 5-6. pool_info Command Options
The pool_mp command is for managing multipathing on running pools (refer to Table 5-7 and Table 5-8). One or more pool names can be specified on the command line to adjust multipathing on specific pools. If no pools are specified on the command line, all pools will be acted upon.
| Flag | Function | Section/Page Reference |
|---|---|---|
| -m | Tune multipathing | Section 5.14 Adjusting Pool Volume Multipathing |
| -r | Restore failed paths | Section 5.14 Adjusting Pool Volume Multipathing |
Table 5-7. pool_mp Command Functions