NAME

samgrowfs - Adds disk partitions to an existing StorageTek QFS or Oracle HSM file system

SYNOPSIS

samgrowfs [-V] fsname

AVAILABILITY

SUNWsamfs

DESCRIPTION

The samgrowfs command adds disk partitions to an StorageTek QFS and Oracle HSM file system and allows the file system to grow.

The following procedure uses the samgrowfs command to increase the size of a StorageTek QFS or Oracle HSM file system:

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

2. In a StorageTek QFS or Oracle HSM 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 StorageTek QFS or Oracle HSM file system. The new partitions 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 StorageTek QFS File System Configuration and Administration Guide.

OPTIONS

This command accepts the following arguments:

-V

Lists configuration information but does not execute 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 StorageTek 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 StorageTek QFS and Oracle HSM file systems.

SEE ALSO

samcmd (1m), samd (1m), sammkfs (1m).

mcf (4).

StorageTek 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 StorageTek QFS file system, you must add a metadata partition (mm) prior to issuing a samgrowfs command. Data partitions can be added as well as metadata partitions. The added metadata partition contains block reservation information 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.