NAME

tkadmin expand pvol - expands a physical volume

SYNOPSIS

tkadmin expand pvol -server servername pvolname nregions {(diskname diskoffset [-regionsize regionsize])...}

ARGUMENTS

-server servername Specifies the server affected by the command. The server name is the name that is registered with the DCE Directory Service. If the server name is not specified in the command line, it is retrieved from an environment variable, ENCINA_TK_SERVER. 

pvolname Specifies the physical volume to be expanded. 

nregions Specifies the number of regions in the physical volume (an integer). Often, the number of regions is between 1 and 4, but it may be as large as available disk space allows. 

The following three parameters are specified for each region:

diskname On UNIX systems, specifies the full path name of the disk that is providing storage space for this region. The name specified must be the same name that was used to initialize the disk. On Windows NT, specifies the full path name of the operating system file being used. 

diskoffset Specifies the offset (in pages) into the disk where this region begins. The size of a page is defined as VOL_PAGE_SIZE (currently 4K). 

[-regionsize regionsize]
Specifies the size (in pages) of the region allocated to the physical volume. This value can vary greatly; 1 page is the smallest valid value. The largest value is dependent on the disk size and usage. The region size is rounded down to be a multiple of the chunk size; therefore, the region size cannot be smaller than the chunk size. The default region size is the entire remaining portion of the disk (beginning from the specified offset to the end of the disk).

DESCRIPTION

The tkadmin expand pvol command adds storage space to a physical volume. The additional storage space is specified as one or more regions (contiguous disk portions).  The number of regions is specified in nregions and each region is described by the following three arguments: diskname diskoffset -regionsize regionsize. Region sizes are rounded down to be a multiple of the chunksize. To make the most efficient use of a disk, specify region sizes to be a multiple of chunk size. 

NOTES

Windows NT uses fully-allocated operating system files as disks.  All occurrences of “disk” and “disk partition” should be read as “file” throughout the description of this command when used on Windows NT. The result of the command is the same. 

EXAMPLES

AIX

This command is not for use on the AIX operating system. 

Non-AIX UNIX

The following command expands the physical volume named pvol1 by adding 2 regions: 100 pages at offset 0 of disk /dev/rsd1f and the entire disk /dev/rsd1g beginning at offset 100. 

% tkadmin expand pvol sfs_pvol1 2 /dev/rsd1f 0 -regionsize 100 /dev/rsd1g 100

Windows NT

The following command expands the physical volume named pvol1 by adding 2 regions: 100 pages at offset 0 of disk D:\rqsData and the entire disk E:\rqsData beginning at offset 100. 

C:\> tkadmin expand pvol sfs_pvol1 2 D:\rqsData 0 -regionsize 100 E:\rqsData 100

PRIVILEGE REQUIRED

Encina Monitor administer (a) permission to the node manager

Encina RQS administer (a) permission to the RQS server

Encina SFS administer (A) permission to the SFS server

RELATED INFORMATION

tkadmin create pvol

tkadmin init disk

  —  March 1997