balance(8)balance(8)NAMEbalance - 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 vol‐
umes. 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 bal‐
ance 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.
If the vfast utility is activated and defragment, balance, or topIObal‐
ance are enabled on a domain, then the standard AdvFS balance and
defragment utilities are not available.
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 percent‐
age 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 percent‐
age 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), vfast(8)balance(8)
