Increases the size of a DCE LFS aggregate
Synopsis
growaggr -aggregate name [-aggrsize blocks] [-noaction] [-help]
Options
-aggregate name
Specifies the device name or aggregate name of the DCE LFS aggregate whose size is to be increased. These names are specified in the first and second
fields of the entry for the aggregate in the dcelocal/var/dfs/dfstab file. The specified aggregate does not need to be exported, nor does any fileset on the aggregate need to be
mounted locally or in the global namespace.
-aggrsize blocks
Specifies the total number of 1024-byte blocks to be available on the specified aggregate. The number of 1024-byte blocks specified with this option
cannot exceed the total size of the disk partition on which the aggregate resides, and it must be at least three DCE LFS blocks greater than the current size of the aggregate. (The number of bytes
in a DCE LFS block is defined on a per-aggregate basis with the -blocksize option of the newaggr command when an aggregate is created.)
Include the -noaction option with this option to determine if the specified aggregate size is valid without changing the current size of the aggregate. Omit both this option and the -noaction option to increase the size of the aggregate to the total size of the disk partition on which it resides.
-noaction
Used without the -aggrsize option, this option directs the command to display the total number of 1024-byte blocks on the disk partition on which the
specified aggregate resides. Used with the -aggrsize option, this option determines if the specified aggregate size is valid. The current size of the specified aggregate is not affected if
this option is used.
-help
Prints the online help for this command. All other valid options specified with this option are ignored.
The help and apropos commands available with all command suites are also available with the growaggr command. See the bos help and bos apropos reference pages for examples using these commands.
Description
The growaggr command is used to increase the size of an existing DCE LFS aggregate. The aggregate whose size is to be increased is specified with the
-aggregate option. The binary file for the growaggr command resides in dcelocal/bin/growaggr.
The -aggrsize option is used to specify the total size to make the aggregate. Specify the size as a number of 1024-byte blocks. The size specified with this option cannot exceed the total size of the disk partition on which the aggregate resides. The specified size also must be at least three DCE LFS disk blocks greater than the current size of the aggregate. If it is not, the command displays the minimum size in 1024-byte blocks that can be specified. (The number of bytes in a DCE LFS block is defined on a per-aggregate basis with the -blocksize option of the newaggr command when an aggregate is initialized. It must be a power of two between 1024 and 65,536.)
If the -noaction option is included with the command, the present size of the aggregate is not affected. Combine the -aggrsize and -noaction options to achieve the following results:
· Specify only the -aggrsize option to increase the size of the aggregate to the specified size, as described previously.
· Specify only the -noaction option to determine the total number of 1024-byte blocks on the partition on which the aggregate resides.
· Specify both the -aggrsize and -noaction options to determine if the size specified with the -aggrsize option is valid (within the limits defined previously).
· Omit both the -aggrsize and -noaction options to increase the size of the aggregate to the total size of the disk partition on which it resides.
In operating systems that support logical volumes, the command is useful for increasing the size of an aggregate when the size of the logical volume on which the aggregate resides is increased. It can also be used to increase the size of an aggregate that was deliberately made smaller than the size of the partition or logical volume on which it resides.
The command does not affect any data or filesets that already reside on the aggregate to be grown.
Privilege Required
If the -noaction option is not included with the command, the issuer must have both the read and write permissions for the device (disk
partition) on which the specified aggregate resides; if the -noaction option is included with the command, the issuer needs only the read permission for the device on which the aggregate
resides. An issuer who is logged in as root on the machine on which the aggregate resides always has the necessary privilege to issue this command.
Related Information
Commands: newaggr(8dfs)
Files: dfstab(4dfs)