NAME

tkadmin init disk - initializes a Volume Service disk

SYNOPSIS

tkadmin init disk -server servername diskname

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. 

diskname Specifies the full path name of the disk partition to be initialized. On UNIX, the raw (unbuffered) interface to the disk should be used, as opposed to a buffered disk. On Windows NT, diskname is a fully allocated operating system file name. 

DESCRIPTION

The tkadmin init disk command initializes the specified disk to be used by the Toolkit server. All disks must be initialized via this command before physical volumes can be created. 

CAUTIONS

You should verify that this disk is not used. Calling this function on a disk that belongs to a different server makes all data present on that disk unusable. (This command overwrites the control data on a disk.  The control data identifies the owner of the data and the location of the data on the disk.) 

In addition, you must have appropriate permissions (read and write) to the disk partition initialized. 

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 initializes the disk /dev/rsd1e :

% tkadmin init disk /dev/rsd1e

Windows NT

The following command initializes the disk D:\rqsData :

C:\> tkadmin init disk D:\rqsData

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 disk

  —  March 1997