Index Index for
Section 8
Index Alphabetical
listing for B
Bottom of page Bottom of
page		 

balance(8)


NAME

  balance - Balances the percentage of used space among volumes in a domain.


SYNOPSIS

  /usr/sbin/balance [-v] domain


OPTIONS

  -v  Displays information on which files are being moved to different
      volumes. Selecting this option slows down the balance procedure.


OPERANDS

  domain
      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.

  If the vfast utility is activated and defragment, balance, or topIObalance
  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 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 percentage 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)

Index Index for
Section 8
Index Alphabetical
listing for B
Top of page Top of
page