NAME

tkadmin create pvol - creates a physical volume

SYNOPSIS

tkadmin create pvol -server servername pvolname chunksize 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. This name can be any string of alphanumeric characters with a maximum length of VOL_MAX_STRING_SIZE. Currently, the maximum value is 128 characters including the end-of-string character. 

chunksize Specifies the number of pages guaranteed to be physically contiguous on a disk of the physical volume. The chunk size must be a power of two, for instance 16 or 64. 

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 this region. 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 cannot be smaller than the chunk size. The specified region size is rounded down to a multiple of 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 create pvol command creates a physical volume with the specified name. The storage space for the volume is specified as one or more regions (contiguous disk portions). The number of regions is specified in nregions and each region is described by its diskname, diskoffset, and -regionsize regionsize. Region sizes are rounded down to be a multiple of the chunk size. 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 creates a physical volume named pvol1 that has two regions. The first region takes up the entire /dev/rsd1g disk. The second region takes 1024 pages of the /dev/rsd1e disk beginning at offset 1024. 

% tkadmin create pvol pvol1 16 2 /dev/rsdlg 0 /dev/rsd1e 1024 -regionsize 1024

Windows NT

The following command creates a physical volume named pvol1 that has two regions. The first region takes up the entire D:\rqsData disk. The second region takes 1024 pages of the E:\rqsData disk beginning at offset 1024. 

C:\> tkadmin create pvol pvol1 16 2 D:\rqsData 0 E:\rqsData 1024 -regionsize 1024

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 delete pvol

tkadmin init disk

  —  March 1997