samgrowfs(1M)

NAME
     samgrowfs - Adds disk partitions to an existing Sun  QFS  or
     SAM-QFS file system

SYNOPSIS
     samgrowfs [-V] fsname

AVAILABILITY
     SUNWsamfs

DESCRIPTION
     The samgrowfs command adds disk partitions to an Sun QFS and
     SAM-QFS file system and allows the file system to grow.

     The  following  procedure  uses  the  samgrowfs  command  to
     increase the size of a Sun QFS or SAM-QFS file system:

     1. Unmount all the file systems you want to grow.

     2. In a Sun QFS or SAM-QFS environment, idle all  drives  by
        entering  a  samcmd idle eq and a samd stop command.  For
        more information on these commands,  see  the  samcmd(1M)
        and samd(1M) man pages.

     3. Edit the mcf file, save the changes, and quit the editor.
        Up  to  252  disk  partitions can be specified in the mcf
        file for a Sun QFS or SAM-QFS file system.  The new  par-
        titions  must be placed after the existing partitions for
        the specified family set fsname.

     4. Run the samd config command to notify sam-fsd
        of the change to /etc/opt/SUNWsamfs/mcf (see samd(1M)).

     5. Run the samgrowfs(1M) command on the fsname file system.

     6. Mount the fsname file system.

     For more information on this procedure, see the Sun QFS File
     System Configuration and Administration Guide.

OPTIONS
     This command accepts the following arguments:

     -V        Lists configuration information but does not  exe-
               cute the command.

     fsname    Specifies the existing family set name of the file
               system  that  is  to grow.  This is the family set
               name as specified in the mcf file.

EXAMPLE
     The following example  adds  2  partitions  to  an  existing
     1-partition  Sun  QFS  file  system.   The  mcf file for the
     existing 1-partition file system with a family set  name  of
     samfs1 is as follows:

     samfs1  10  ms  samfs1
     /dev/dsk/c0t3d0s7  11  md  samfs1  -

     The procedure is as follows:

     1. Unmount the samfs1 file system.

        server# umount samfs1

     2. Kill the sam-amld process:

        server# samd stop

     3. Edit the mcf file and add the 2 new  partitions  for  the
        file system with family set name of samfs1:

        samfs1  10  ms  samfs1
        /dev/dsk/c0t3d0s7  11  md  samfs1  -
        /dev/dsk/c2t3d0s2  12  md  samfs1  -
        /dev/dsk/c2t4d0s2  13  md  samfs1  -

     4. Use the samd(1M) config command  to  propagate  the  file
        changes and restart the system:

        server# samd config

     5. Grow and mount the file system by entering the  following
        commands:

        server# samgrowfs samfs1
        server# mount samfs1

FILES
     /etc/opt/SUNWsamfs/mcf   The configuration file for Sun  QFS
                              and SAM-QFS file systems.

SEE ALSO
     samcmd(1M), samd(1M), sammkfs(1M).

     mcf(4).

     Sun QFS File System Configuration and Administration Guide.

WARNINGS
     As with creating any type of file system, if you specify the
     wrong  partition  names,  you  risk  damaging user or system
     data.  Be sure to specify  partitions  which  are  otherwise
     unused on your system.  Do not use overlapping partitions.

     To grow a Sun QFS file system, you must add a metadata  par-
     tition (mm) prior to issuing a samgrowfs command.  Data par-
     titions can be added as well as  metadata  partitions.   The
     added metadata partition contains block reservation informa-
     tion for all added partitions. When adding a small  metadata
     partition  with  large  data  partitions, the small metadata
     partition may be too small to hold the block reservation  as
     well  as other information, depending on total storage added
     and DAU size. This condition may cause an error, or  a  very
     full metadata partition after samgrowfs.

     If the file system is not unmounted prior  to  changing  the
     configuration,  you  can end up in a situation where you can
     not mount the file system. In that case, take the eq out  of
     mcf and run samd config.