NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

       /usr/sbin/balance [-v] domain

OPTIONS    [Toc]    [Back]

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

OPERANDS    [Toc]    [Back]

       Specifies the name of the AdvFS file domain.

DESCRIPTION    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       The following example shows the procedure for  determining
       the  percentage  of  used space on each volume of the twovolume
 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    [Toc]    [Back]

       Commands: addvol(8), defragment(8), rmvol(8), showfdmn(8),
       vfast(8)



                                                       balance(8)