NAME

tkadmin move pvol - moves a physical volume to a different set of disks

SYNOPSIS

tkadmin move pvol -server servername pvolname nregions {(srcdiskname srcdiskoffset regionsize destdiskname destdiskoffset)...}

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 moved. 

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 five parameters are specified for each region:

srcdiskname On UNIX systems, specifies the full path name of the disk that is storing the source 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. 

srcdiskoffset Specifies the offset (in pages) into the disk where the source region begins. The size of a page defined by VOL_PAGE_SIZE, currently 4K. 

regionsize Specifies the size (in pages) of the region to be moved.  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. 

destdiskname On UNIX systems, specifies the disk to which this region is being moved. 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. 

destdiskoffset Specifies the offset (in pages) on the disk where the moved region is to begin. The size of a page is defined as VOL_PAGE_SIZE, currently 4K. 

DESCRIPTION

The tkadmin move pvol command moves regions backing a physical volume to new storage locations. The destination regions, where the data will be stored, cannot overlap any currently used regions. The size of a region remains constant, that is the size of the destination region is equal to the size of the source region. 

Before a logical volume can be restored, it must be backed by functional disks. One way to achieve that state, is to move regions of physical volumes from nonfunctional disks to functional disks. Physical volumes can be moved using this command. 

CAUTIONS

If the physical volume is mapped to a logical volume, the logical volume must be disabled. (You must start the server in administrative mode.) 

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 moves two regions of the physical volume pvol5, each of size 100 pages. Region 1 is moved from the disk /dev/rsd1f at offset 0 to the disk /dev/rsd1g at offset 0. Region 2 is moved from the disk /dev/rsd1f at offset 100 to disk /dev/rsd1g at offset 100. 

% tkadmin move pvol pvol5 2 /dev/rsd1f 0 100 /dev/rsd1g 0 /dev/rsd1f 100 100 /dev/rsd1g 100

Windows NT

The following command moves two regions of the physical volume pvol5, each of size 100 pages. Region 1 is moved from the disk D:\rqsData at offset 0 to the disk E:\rqsData at offset 0. Region 2 is moved from the disk D:\rqsData at offset 100 to disk E:\rqsData at offset 100. 

C:\> tkadmin move pvol pvol5 2 D:\rqsData 0 100 E:\rqsData 0 D:\rqsData 100 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 expand pvol

  —  March 1997