balance(8) System Manager's Manual balance(8)
NAME
balance - Balances the percentage of used space among volumes in a domain.
SYNOPSIS
/usr/sbin/balance [-v] domain
OPTIONS
Displays information on which files are being moved to different volumes. Selecting this option slows down the balance procedure.
OPERANDS
Specifies the name of the AdvFS file domain.
DESCRIPTION
The balance utility evenly distributes the percentage of used space between volumes in a multivolume domain. This improves performance and
evens the distribution of future file allocations.
Use the showfdmn command to determine the percentage of used space on each volume. This information allows you to determine the need to
balance the volumes.
The balance utility can be used at any time, but it is particularly useful after adding or removing a volume (addvol, rmvol) because these
procedures can cause file distribution to become uneven.
When you plan to run both the defragment and balance utilities on the same domain, run the balance utility before running the defragment
utility. The balance utility often improves the balance of free space, thus enabling the defragment utility to run more quickly.
Before you can balance volumes in a file domain, all filesets in the file domain must be mounted. If you try to balance volumes in an
active file domain that includes unmounted filesets, the system displays an error message indicating that a fileset is unmounted.
RESTRICTIONS
You must be the root user to use this utility.
You cannot run the balance utility while the addvol, rmvol, defragment, rmfset, or balance utility is running on the same file domain. If
you attempt to do this, a warning message is displayed.
The balance utility does not operate on striped files in the domain and does not include them in its calculations on used space.
EXAMPLES
The following example shows the procedure for determining the percentage of used space on each volume of the two-volume usr_domain file
domain and then redistributing the files to balance the percentage of used space. The final showfdmn command shows the redistributed per-
centage of used space. # showfdmn usr_domain
Id Date Created LogPgs Domain Name 2dcab512.000d1ed0 Fri May 7 14:22:26 1999 512 usr_domain
Vol 512-Blks Free % Used Cmode Rblks Wblks Vol Name
1L 819200 126848 85% on 128 128 /dev/dsk8g
2 768281 768080 0% on 128 128 /dev/dsk9d
---------- ---------- ------
1587481 894928 44%
# balance usr_domain
balance: Balancing domain 'usr_domain' balance: Balanced domain 'usr_domain'
# showfdmn usr_domain
Id Date Created LogPgs Domain Name 2dcab512.000d1ed0 Fri May 7 14:22:26 1999 512 usr_domain
Vol 512-Blks Free % Used Cmode Rblks Wblks Vol Name
1L 819200 459248 44% on 128 128 /dev/dsk8g
2 768281 433632 44% on 128 128 /dev/dsk9d
---------- ---------- ------
1587481 892880 44%
The files are now distributed more evenly between the two volumes.
SEE ALSO
Commands: addvol(8), defragment(8), rmvol(8), showfdmn(8)
balance(8)