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)